Open API v2 will be deprecated on April 3, 2023. Please begin transitioning to Open API v3 as soon as possible. As of September 29, 2022 all new apps will only be permitted to use Open API v3.

API Documentation

Team

Deprecated: The Etsy API no longer supports teams.

Overview

Teams represent a community of users on Etsy, found at www.etsy.com/teams. Generally, the Etsy API only exposes public teams data. Using OAuth, a team captain may see pending or invited team members using the findAllUsersForTeam method.

Fields

Field Visibility Level Permission Scope Type Description
group_id public none int The team's numeric ID.
name public none string The team's name.
create_date public none int The date and time the team was created in Epoch seconds.
update_date public none int The date and time the team was last updated in Epoch seconds.
tags public none array(string) A list of tags describing the team.

Associations

This resource has no associations.

Methods

findAllTeams

Method Name findAllTeams
Synopsis Returns all Teams
HTTP Method GET
URI /teams
Parameters
Name Required Default Type
limit N 25 int
offset N 0 int
page N   int
Requires OAuth N
Permission Scope none

findTeams

Method Name findTeams
Synopsis Returns specified team by ID or team name
HTTP Method GET
URI /teams/:team_ids/
Parameters
Name Required Default Type
team_ids Y   array(team_id_or_name)
Requires OAuth N
Permission Scope none

findAllTeamsForUser

Method Name findAllTeamsForUser
Synopsis Returns a list of teams for a specific user
HTTP Method GET
URI /users/:user_id/teams
Parameters
Name Required Default Type
user_id Y   user_id_or_name
limit N 25 int
offset N 0 int
page N   int
Requires OAuth N
Permission Scope none

Open API v3New

Your developer account