> 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.com/developers/docs/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://contentful.com/developers/docs/_mcp/server.

# List design library versions

GET https://api.contentful.com/spaces/{spaceId}/design_libraries/{designLibraryId}/versions

Lists a design library's versions using cursor pagination.

Reference: https://contentful.com/developers/docs/references/experience-management-api/design-libraries/versions/list-design-library-versions

## Authentication

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

## Request

### Path parameters

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

### Query parameters

- `pageNext` (string, optional) — Opaque cursor for the next page. Use the cursor returned by the API; do not supply it together with `pagePrev`.
- `pagePrev` (string, optional) — Opaque cursor for the previous page. Use the cursor returned by the API; do not supply it together with `pageNext`.
- `limit` (integer, optional) — Maximum number of items to return per page, from 1 to 100.
- `status` (enum, optional) — Filters versions by processing status.
  - Allowed values: `created`, `in_progress`, `succeeded`, `failed`

## Response

### 200

200

- `sys` (SpacesSpaceIdDesignLibrariesDesignLibraryIdVersionsGetResponsesContentApplicationJsonSchemaSys, required)
- `limit` (double, required)
- `items` (list of SpacesSpaceIdDesignLibrariesDesignLibraryIdVersionsGetResponsesContentApplicationJsonSchemaItemsItems, required)
- `pages` (SpacesSpaceIdDesignLibrariesDesignLibraryIdVersionsGetResponsesContentApplicationJsonSchemaPages, required)

## Errors

### 400 Bad Request Error

400

- `sys` (SpacesSpaceIdDesignLibrariesDesignLibraryIdVersionsGetResponsesContentApplicationJsonSchemaSys, required)
- `message` (string, optional)
- `requestId` (string, optional)
- `details` (any, optional)

### 401 Unauthorized Error

401

- `sys` (SpacesSpaceIdDesignLibrariesDesignLibraryIdVersionsGetResponsesContentApplicationJsonSchemaSys, required)
- `message` (string, optional)
- `requestId` (string, optional)
- `details` (any, optional)

### 403 Forbidden Error

403

- `sys` (SpacesSpaceIdDesignLibrariesDesignLibraryIdVersionsGetResponsesContentApplicationJsonSchemaSys, required)
- `message` (string, optional)
- `requestId` (string, optional)
- `details` (any, optional)

### 404 Not Found Error

404

- `sys` (SpacesSpaceIdDesignLibrariesDesignLibraryIdVersionsGetResponsesContentApplicationJsonSchemaSys, required)
- `message` (string, optional)
- `requestId` (string, optional)
- `details` (any, optional)

### 409 Conflict Error

409

- `sys` (SpacesSpaceIdDesignLibrariesDesignLibraryIdVersionsGetResponsesContentApplicationJsonSchemaSys, required)
- `message` (string, optional)
- `requestId` (string, optional)
- `details` (any, optional)

### 422 Unprocessable Entity Error

422

- `sys` (SpacesSpaceIdDesignLibrariesDesignLibraryIdVersionsGetResponsesContentApplicationJsonSchemaSys, required)
- `message` (string, optional)
- `requestId` (string, optional)
- `details` (any, optional)

### 500 Internal Server Error

500

- `sys` (SpacesSpaceIdDesignLibrariesDesignLibraryIdVersionsGetResponsesContentApplicationJsonSchemaSys, required)
- `message` (string, optional)
- `requestId` (string, optional)
- `details` (any, optional)

## Types

### SpacesSpaceIdDesignLibrariesDesignLibraryIdVersionsGetResponsesContentApplicationJsonSchemaSys

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

### SpacesSpaceIdDesignLibrariesDesignLibraryIdVersionsGetResponsesContentApplicationJsonSchemaItemsItems

- `sys` (SpacesSpaceIdDesignLibrariesDesignLibraryIdVersionsGetResponsesContentApplicationJsonSchemaItemsItemsSys, required)
- `name` (string, required)
- `description` (string, required, nullable)
- `itemCounts` (SpacesSpaceIdDesignLibrariesDesignLibraryIdVersionsGetResponsesContentApplicationJsonSchemaItemsItemsItemCounts, required)
- `errors` (list of SpacesSpaceIdDesignLibrariesDesignLibraryIdVersionsGetResponsesContentApplicationJsonSchemaItemsItemsErrorsItems, optional)

### SpacesSpaceIdDesignLibrariesDesignLibraryIdVersionsGetResponsesContentApplicationJsonSchemaPages

- `next` (string, optional) — URL for the next page. Request this URL to continue; its absence means there are no further results.
- `prev` (string, optional) — URL for the previous page, when available. Request this URL to page backwards.

### SpacesSpaceIdDesignLibrariesDesignLibraryIdVersionsGetResponsesContentApplicationJsonSchemaItemsItemsSys

- `id` (string, required)
- `type` ("DesignLibraryVersion", required)
- `designLibrary` (SpacesSpaceIdDesignLibrariesDesignLibraryIdVersionsGetResponsesContentApplicationJsonSchemaItemsItemsSysDesignLibrary, required)
- `createdAt` (string, required)
- `status` (enum, required)
  - Allowed values: `created`, `in_progress`, `succeeded`, `failed`
- `createdBy` (SpacesSpaceIdDesignLibrariesDesignLibraryIdVersionsGetResponsesContentApplicationJsonSchemaItemsItemsSysCreatedBy, required)
- `space` (SpacesSpaceIdDesignLibrariesDesignLibraryIdVersionsGetResponsesContentApplicationJsonSchemaItemsItemsSysSpace, required)
- `completedAt` (string, optional)

### SpacesSpaceIdDesignLibrariesDesignLibraryIdVersionsGetResponsesContentApplicationJsonSchemaItemsItemsItemCounts

- `experienceTemplates` (double, optional)
- `components` (double, optional)
- `designTokens` (double, optional)
- `contentTypes` (double, optional)
- `dataAssemblies` (double, optional)
- `editorInterfaces` (double, optional)

### SpacesSpaceIdDesignLibrariesDesignLibraryIdVersionsGetResponsesContentApplicationJsonSchemaItemsItemsErrorsItems

- `sys` (SpacesSpaceIdDesignLibrariesDesignLibraryIdVersionsGetResponsesContentApplicationJsonSchemaItemsItemsErrorsItemsSys, required)
- `message` (string, required)
- `details` (string, required)

### SpacesSpaceIdDesignLibrariesDesignLibraryIdVersionsGetResponsesContentApplicationJsonSchemaItemsItemsSysDesignLibrary

- `sys` (SpacesSpaceIdDesignLibrariesDesignLibraryIdVersionsGetResponsesContentApplicationJsonSchemaItemsItemsSysDesignLibrarySys, required)

### SpacesSpaceIdDesignLibrariesDesignLibraryIdVersionsGetResponsesContentApplicationJsonSchemaItemsItemsSysCreatedBy

- `sys` (SpacesSpaceIdDesignLibrariesDesignLibraryIdVersionsGetResponsesContentApplicationJsonSchemaItemsItemsSysCreatedBySys, required)

### SpacesSpaceIdDesignLibrariesDesignLibraryIdVersionsGetResponsesContentApplicationJsonSchemaItemsItemsSysSpace

- `sys` (SpacesSpaceIdDesignLibrariesDesignLibraryIdVersionsGetResponsesContentApplicationJsonSchemaItemsItemsSysSpaceSys, required)

### SpacesSpaceIdDesignLibrariesDesignLibraryIdVersionsGetResponsesContentApplicationJsonSchemaItemsItemsErrorsItemsSys

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

### SpacesSpaceIdDesignLibrariesDesignLibraryIdVersionsGetResponsesContentApplicationJsonSchemaItemsItemsSysDesignLibrarySys

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

### SpacesSpaceIdDesignLibrariesDesignLibraryIdVersionsGetResponsesContentApplicationJsonSchemaItemsItemsSysCreatedBySys

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

### SpacesSpaceIdDesignLibrariesDesignLibraryIdVersionsGetResponsesContentApplicationJsonSchemaItemsItemsSysSpaceSys

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

## Examples

**Response**

```json
{
  "sys": {
    "type": "string"
  },
  "limit": 1.1,
  "items": [
    {
      "sys": {
        "id": "string",
        "type": "string",
        "designLibrary": {
          "sys": {
            "type": "string",
            "linkType": "string",
            "id": "string"
          }
        },
        "createdAt": "string",
        "status": "created",
        "createdBy": {
          "sys": {
            "type": "string",
            "linkType": "string",
            "id": "string"
          }
        },
        "space": {
          "sys": {
            "type": "string",
            "linkType": "string",
            "id": "string"
          }
        },
        "completedAt": "string"
      },
      "name": "string",
      "description": "string",
      "itemCounts": {
        "experienceTemplates": 1.1,
        "components": 1.1,
        "designTokens": 1.1,
        "contentTypes": 1.1,
        "dataAssemblies": 1.1,
        "editorInterfaces": 1.1
      },
      "errors": [
        {
          "sys": {
            "type": "string",
            "name": "string"
          },
          "message": "string",
          "details": "string"
        }
      ]
    }
  ],
  "pages": {
    "next": "string",
    "prev": "string"
  }
}
```