> This page is for API Reference.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://contentful-staging.ferndocs.com/developers/docs/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://contentful-staging.ferndocs.com/developers/docs/_mcp/server.

# List all design tokens

GET https://api.contentful.com/spaces/{spaceId}/environments/{environmentId}/design_tokens

Reference: https://contentful-staging.ferndocs.com/developers/docs/references/experiences-management-api/design-tokens/list-design-tokens

## Authentication

- `Authorization` header (bearer token, required) — Contentful Management API token

## Request

### Path parameters

- `spaceId` (string, required)
- `environmentId` (string, required)

### Query parameters

- `access_token` (string, optional)
- `pageNext` (string, optional)
- `pagePrev` (string, optional)
- `limit` (double, optional)
- `metadata.tags.sys.id[in]` (string, optional)
- `metadata.tags.sys.id[all]` (string, optional)
- `metadata.tags.sys.id[nin]` (string, optional)
- `metadata.concepts.sys.id[in]` (string, optional)
- `metadata.concepts.sys.id[all]` (string, optional)
- `metadata.concepts.sys.id[nin]` (string, optional)
- `metadata.concepts.descendants[in]` (any, optional)
- `name[match]` (string, optional)
- `name` (string, optional)
- `sys.id[in]` (any, optional)
- `sys.id[nin]` (any, optional)
- `type` (enum, optional)
  - Allowed values: `DTCG.Color`, `DTCG.Dimension`, `DTCG.FontFamily`, `DTCG.FontWeight`, `DTCG.Duration`, `DTCG.CubicBezier`, `DTCG.Number`, `DTCG.StrokeStyle`, `DTCG.Border`, `DTCG.Transition`, `DTCG.Shadow`, `DTCG.Gradient`, `DTCG.Typography`
- `type[in]` (any, optional)
- `type[nin]` (any, optional)

## Response

### 200

200

- `sys` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaSys, required)
- `limit` (double, required)
- `items` (list of SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaItemsItems, required)
- `pages` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaPages, required)

## Errors

### 400 Bad Request Error

400

- `sys` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaSys, required)
- `message` (string, optional)
- `requestId` (string, optional)
- `details` (any, optional)
- `i18nContext` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaI18NContext, optional)

### 401 Unauthorized Error

401

- `sys` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaSys, required)
- `message` (string, optional)
- `requestId` (string, optional)
- `details` (any, optional)
- `i18nContext` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaI18NContext, optional)

### 403 Forbidden Error

403

- `sys` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaSys, required)
- `message` (string, optional)
- `requestId` (string, optional)
- `details` (any, optional)
- `i18nContext` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaI18NContext, optional)

### 404 Not Found Error

404

- `sys` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaSys, required)
- `message` (string, optional)
- `requestId` (string, optional)
- `details` (any, optional)
- `i18nContext` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaI18NContext, optional)

### 409 Conflict Error

409

- `sys` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaSys, required)
- `message` (string, optional)
- `requestId` (string, optional)
- `details` (any, optional)
- `i18nContext` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaI18NContext, optional)

### 422 Unprocessable Entity Error

422

- `sys` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaSys, required)
- `message` (string, optional)
- `requestId` (string, optional)
- `details` (any, optional)
- `i18nContext` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaI18NContext, optional)

### 500 Internal Server Error

500

- `sys` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaSys, required)
- `message` (string, optional)
- `requestId` (string, optional)
- `details` (any, optional)
- `i18nContext` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaI18NContext, optional)

## Types

### SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaSys

- `id` (string, required)
- `type` ("Error", required)

### SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaItemsItems

- `sys` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaItemsItemsSys, required)
- `name` (string, required)
- `type` (enum, required)
  - Allowed values: `DTCG.Color`, `DTCG.Dimension`, `DTCG.FontFamily`, `DTCG.FontWeight`, `DTCG.Duration`, `DTCG.CubicBezier`, `DTCG.Number`, `DTCG.StrokeStyle`, `DTCG.Border`, `DTCG.Transition`, `DTCG.Shadow`, `DTCG.Gradient`, `DTCG.Typography`
- `metadata` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaItemsItemsMetadata, optional)
- `source` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaItemsItemsSource, optional)

### SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaPages

- `next` (string, optional)
- `prev` (string, optional)

### SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaI18NContext

- `code` (string, required)
- `pluralCount` (double, optional)
- `parameters` (map from string to SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaI18NContextParameters, optional)

### SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaItemsItemsSys

- `id` (string, required)
- `type` ("DesignToken", required)
- `space` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaItemsItemsSysSpace, required)
- `environment` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaItemsItemsSysEnvironment, required)
- `createdAt` (string, required)
- `updatedAt` (string, required)
- `createdBy` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaItemsItemsSysCreatedBy, required)
- `updatedBy` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaItemsItemsSysUpdatedBy, required)
- `version` (double, required)

### SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaItemsItemsMetadata

- `tags` (list of SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaItemsItemsMetadataTagsItems, optional)
- `concepts` (list of SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaItemsItemsMetadataConceptsItems, optional)

### SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaItemsItemsSource

- `sys` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaItemsItemsSourceSys, required)

### SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaI18NContextParameters

### SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaItemsItemsSysSpace

- `sys` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaItemsItemsSysSpaceSys, required)

### SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaItemsItemsSysEnvironment

- `sys` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaItemsItemsSysEnvironmentSys, required)

### SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaItemsItemsSysCreatedBy

### SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaItemsItemsSysUpdatedBy

### SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaItemsItemsMetadataTagsItems

- `sys` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaItemsItemsMetadataTagsItemsSys, required)

### SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaItemsItemsMetadataConceptsItems

- `sys` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaItemsItemsMetadataConceptsItemsSys, required)

### SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaItemsItemsSourceSys

- `type` ("ResourceLink", required)
- `linkType` ("Contentful:DesignSystemSource", required)
- `urn` (string, required)

### SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaI18NContextParameters0

- `type` ("string", required)
- `value` (string, required)

### SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaI18NContextParameters1

- `type` ("number", required)
- `value` (double, required)

### SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaI18NContextParameters2

- `type` ("date", required)
- `value` (string, required)

### SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaI18NContextParameters3

- `type` ("array.string", required)
- `value` (list of string, required)

### SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaI18NContextParameters4

- `type` ("array.number", required)
- `value` (list of double, required)

### SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaItemsItemsSysSpaceSys

- `type` ("Link", required)
- `linkType` ("Space", required)
- `id` (string, required)

### SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaItemsItemsSysEnvironmentSys

- `type` ("Link", required)
- `linkType` ("Environment", required)
- `id` (string, required)

### SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaItemsItemsSysCreatedBy0

- `sys` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaItemsItemsSysCreatedByOneOf0Sys, required)

### SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaItemsItemsSysCreatedBy1

- `sys` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaItemsItemsSysCreatedByOneOf1Sys, required)

### SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaItemsItemsSysUpdatedBy0

- `sys` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaItemsItemsSysUpdatedByOneOf0Sys, required)

### SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaItemsItemsSysUpdatedBy1

- `sys` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaItemsItemsSysUpdatedByOneOf1Sys, required)

### SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaItemsItemsMetadataTagsItemsSys

- `type` ("Link", required)
- `linkType` ("Tag", required)
- `id` (string, required)

### SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaItemsItemsMetadataConceptsItemsSys

- `type` ("Link", required)
- `linkType` ("TaxonomyConcept", required)
- `id` (string, required)

### SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaItemsItemsSysCreatedByOneOf0Sys

- `type` ("Link", required)
- `linkType` ("User", required)
- `id` (string, required)

### SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaItemsItemsSysCreatedByOneOf1Sys

- `type` ("Link", required)
- `linkType` ("App", required)
- `id` (string, required)

### SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaItemsItemsSysUpdatedByOneOf0Sys

- `type` ("Link", required)
- `linkType` ("User", required)
- `id` (string, required)

### SpacesSpaceIdEnvironmentsEnvironmentIdDesignTokensGetResponsesContentApplicationJsonSchemaItemsItemsSysUpdatedByOneOf1Sys

- `type` ("Link", required)
- `linkType` ("App", required)
- `id` (string, required)

## Examples

**Response**

```json
{
  "sys": {
    "type": "string"
  },
  "limit": 1.1,
  "items": [
    {
      "sys": {
        "id": "string",
        "type": "string",
        "space": {
          "sys": {
            "type": "string",
            "linkType": "string",
            "id": "string"
          }
        },
        "environment": {
          "sys": {
            "type": "string",
            "linkType": "string",
            "id": "string"
          }
        },
        "createdAt": "string",
        "updatedAt": "string",
        "createdBy": {
          "sys": {
            "type": "string",
            "linkType": "string",
            "id": "string"
          }
        },
        "updatedBy": {
          "sys": {
            "type": "string",
            "linkType": "string",
            "id": "string"
          }
        },
        "version": 1.1
      },
      "name": "string",
      "type": "DTCG.Color",
      "metadata": {
        "tags": [
          {
            "sys": {
              "type": "string",
              "linkType": "string",
              "id": "string"
            }
          }
        ],
        "concepts": [
          {
            "sys": {
              "type": "string",
              "linkType": "string",
              "id": "string"
            }
          }
        ]
      },
      "source": {
        "sys": {
          "type": "string",
          "linkType": "string",
          "urn": "string"
        }
      }
    }
  ],
  "pages": {
    "next": "string",
    "prev": "string"
  }
}
```