Skip to content
Docs

List all flags for a team

GEThttps://api.vercel.com/v2/teams/{teamId}/feature-flags/flags
Retrieve all feature flags for a team across all projects. Returns an opaque cursor for pagination.
https://api.vercel.com/v2/teams/{teamId}/feature-flags/flags
const response = await fetch('https://api.vercel.com/v2/teams/teamId/feature-flags/flags?state=string&limit=123&cursor=string&search=string&kind=string&tags=[]&createdBy=string&maintainerIds=[]&includeMarketplaceFlags=true&slug=string', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer YOUR_ACCESS_TOKEN',
    'Content-Type': 'application/json',
  },
});


const data = await response.json();
console.log(data);
Response
{
  "pagination": {
    "next": "string"
  },
  "data": [
    {
      "createdAt": "123",
      "createdBy": "string",
      "description": "string",
      "environments": "value",
      "id": "icfg_1234567890",
      "kind": "boolean",
      "maintainerIds": [],
      "ownerId": "example_id",
      "permanent": "false",
      "projectId": "example_id",
      "revision": "123",
      "seed": "123",
      "seenInProduction": "false",
      "slug": "string",
      "state": "active",
      "tags": [],
      "typeName": "flag",
      "updatedAt": "123",
      "updatedBy": "string",
      "variants": [
        {
          "description": "string",
          "id": "icfg_1234567890",
          "label": "string",
          "value": "string"
        }
      ],
      "metadata": {
        "creator": {
          "id": "icfg_1234567890",
          "name": "Example Name"
        }
      }
    }
  ]
}

Authentication

AuthorizationbearerToken

Default authentication mechanism

Path parameters

teamIdstringRequired
The Team identifier to perform the request on behalf of.

Query parameters

statestringOptional
The state of the flags to retrieve. Defaults to active.
limitintegerOptional
Maximum number of flags to return.
cursorstringOptional
Pagination cursor to continue from.
kindstringOptional
The kind of flags to retrieve.
tagsarrayOptional
Filter flags by tag. Repeat the parameter for multiple tags (all must match).
createdBystringOptional
Filter flags by the id of the entity that created them (a user or team id).
maintainerIdsarrayOptional
Filter flags by maintainer user id. Repeat the parameter for multiple maintainers (any may match).
includeMarketplaceFlagsbooleanOptional
Whether to include Marketplace experimentation items in the paginated response. Defaults to false.
slugstringOptional
The Team slug to perform the request on behalf of.

Response

200Success
dataarrayRequired

Errors

400One of the provided values in the request query is invalid.
401The request is not authorized.
403You do not have permission to access this resource.
404Error
410Error
503Error