---
title: "Get team components"
method: GET
path: "/v1/teams/{team_id}/components"
tags: ["Components"]
---

# Get team components

`GET /v1/teams/{team_id}/components`

Get a paginated list of published components within a team library.

## Path parameters

- `team_id` string, required

## Query parameters

- `page_size` number
- `after` number
- `before` number

## Response `200`

Response from the GET /v1/teams/{team_id}/components endpoint.

- object
  - `status` 200, required — The status of the request.
  - `error` false, required — For successful requests, this value is always `false`.
  - `meta` object, required
    - `components` PublishedComponent[], required
      - `key` string, required — The unique identifier for the component.
      - `file_key` string, required — The unique identifier of the Figma file that contains the component.
      - `node_id` string, required — The unique identifier of the component node within the Figma file.
      - `thumbnail_url` string — A URL to a thumbnail image of the component.
      - `name` string, required — The name of the component.
      - `description` string, required — The description of the component as entered by the publisher.
      - `created_at` string, date-time, required — The UTC ISO 8601 time when the component was created.
      - `updated_at` string, date-time, required — The UTC ISO 8601 time when the component was last updated.
      - `user` User, required — A description of a user.
        - `id` string, required — Unique stable id of the user.
        - `handle` string, required — Name of the user.
        - `img_url` string, required — URL link to the user's profile image.
      - `containing_frame` FrameInfo — Data on the frame a component resides in.
        - `nodeId` string — The ID of the frame node within the file.
        - `name` string — The name of the frame node.
        - `backgroundColor` string — The background color of the frame node.
        - `pageId` string, required — The ID of the page containing the frame node.
        - `pageName` string, required — The name of the page containing the frame node.
    - `cursor` ResponseCursor — Pagination cursor
      - `before` number
      - `after` number

## Other responses

- `400` — Bad request. Parameters are invalid or malformed. Please check the input formats. This error can also happen if the requested resources are too large to complete the request, which results in a timeout. Please reduce the number and size of objects requested.
- `403` — The request was valid, but the server is refusing action. The user might not have the necessary permissions for a resource, or may need an account of some sort.
- `404` — The requested file or resource was not found.
- `429` — In some cases API requests may be throttled or rate limited. Please wait a while before attempting the request again (typically a minute).
- `500` — An internal server error occurred.

---

[API](https://skmtc.dev/thirdstrandstudio/apis/figma-api.md) · [All operations](https://skmtc.dev/thirdstrandstudio/apis/figma-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/thirdstrandstudio/figma-api/revisions/48f84f49653a/schema)