> 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 libraries

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

Lists design libraries owned by the space or shared with it from the same organisation.

Filter results by:

- `sys.space.sys.id`: Source space ID.
- `basedOn.environment.sys.id`: Source environment ID.
- `basedOn.concept.sys.id`: Taxonomy concept ID.

Use cursor pagination to retrieve further results.

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

## Authentication

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

## Request

### Path parameters

- `spaceId` (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.
- `sys.space.sys.id` (string, optional) — Filters libraries by their source space ID.
- `basedOn.environment.sys.id` (string, optional) — Filters libraries by their source environment ID.
- `basedOn.concept.sys.id` (string, optional) — Filters libraries by the taxonomy concept used to select their source items.

## Response

### 200

200

- `sys` (SpacesSpaceIdDesignLibrariesGetResponsesContentApplicationJsonSchemaSys, required)
- `limit` (double, required)
- `items` (list of SpacesSpaceIdDesignLibrariesGetResponsesContentApplicationJsonSchemaItemsItems, required)
- `pages` (SpacesSpaceIdDesignLibrariesGetResponsesContentApplicationJsonSchemaPages, required)

## Errors

### 400 Bad Request Error

400

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

### 401 Unauthorized Error

401

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

### 403 Forbidden Error

403

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

### 404 Not Found Error

404

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

### 409 Conflict Error

409

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

### 422 Unprocessable Entity Error

422

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

### 500 Internal Server Error

500

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

## Types

### SpacesSpaceIdDesignLibrariesGetResponsesContentApplicationJsonSchemaSys

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

### SpacesSpaceIdDesignLibrariesGetResponsesContentApplicationJsonSchemaItemsItems

- `sys` (SpacesSpaceIdDesignLibrariesGetResponsesContentApplicationJsonSchemaItemsItemsSys, required)
- `name` (string, required)
- `description` (string, required, nullable)
- `sharedWithSpaces` (SpacesSpaceIdDesignLibrariesGetResponsesContentApplicationJsonSchemaItemsItemsSharedWithSpaces, required)
- `recommendedVersion` (SpacesSpaceIdDesignLibrariesGetResponsesContentApplicationJsonSchemaItemsItemsRecommendedVersion, required, nullable)

### SpacesSpaceIdDesignLibrariesGetResponsesContentApplicationJsonSchemaPages

- `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.

### SpacesSpaceIdDesignLibrariesGetResponsesContentApplicationJsonSchemaItemsItemsSys

- `id` (string, required)
- `type` ("DesignLibrary", required)
- `createdAt` (string, required)
- `updatedAt` (string, required)
- `version` (integer, required)
- `createdBy` (SpacesSpaceIdDesignLibrariesGetResponsesContentApplicationJsonSchemaItemsItemsSysCreatedBy, required)
- `updatedBy` (SpacesSpaceIdDesignLibrariesGetResponsesContentApplicationJsonSchemaItemsItemsSysUpdatedBy, required)
- `space` (SpacesSpaceIdDesignLibrariesGetResponsesContentApplicationJsonSchemaItemsItemsSysSpace, required)
- `basedOn` (SpacesSpaceIdDesignLibrariesGetResponsesContentApplicationJsonSchemaItemsItemsSysBasedOn, required)

### SpacesSpaceIdDesignLibrariesGetResponsesContentApplicationJsonSchemaItemsItemsSharedWithSpaces

- "*"
- list of string

### SpacesSpaceIdDesignLibrariesGetResponsesContentApplicationJsonSchemaItemsItemsRecommendedVersion

- `sys` (SpacesSpaceIdDesignLibrariesGetResponsesContentApplicationJsonSchemaItemsItemsRecommendedVersionSys, required)

### SpacesSpaceIdDesignLibrariesGetResponsesContentApplicationJsonSchemaItemsItemsSysCreatedBy

- `sys` (SpacesSpaceIdDesignLibrariesGetResponsesContentApplicationJsonSchemaItemsItemsSysCreatedBySys, required)

### SpacesSpaceIdDesignLibrariesGetResponsesContentApplicationJsonSchemaItemsItemsSysUpdatedBy

- `sys` (SpacesSpaceIdDesignLibrariesGetResponsesContentApplicationJsonSchemaItemsItemsSysUpdatedBySys, required)

### SpacesSpaceIdDesignLibrariesGetResponsesContentApplicationJsonSchemaItemsItemsSysSpace

- `sys` (SpacesSpaceIdDesignLibrariesGetResponsesContentApplicationJsonSchemaItemsItemsSysSpaceSys, required)

### SpacesSpaceIdDesignLibrariesGetResponsesContentApplicationJsonSchemaItemsItemsSysBasedOn

- `environment` (SpacesSpaceIdDesignLibrariesGetResponsesContentApplicationJsonSchemaItemsItemsSysBasedOnEnvironment, required)
- `concept` (SpacesSpaceIdDesignLibrariesGetResponsesContentApplicationJsonSchemaItemsItemsSysBasedOnConcept, required)

### SpacesSpaceIdDesignLibrariesGetResponsesContentApplicationJsonSchemaItemsItemsRecommendedVersionSys

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

### SpacesSpaceIdDesignLibrariesGetResponsesContentApplicationJsonSchemaItemsItemsSysCreatedBySys

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

### SpacesSpaceIdDesignLibrariesGetResponsesContentApplicationJsonSchemaItemsItemsSysUpdatedBySys

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

### SpacesSpaceIdDesignLibrariesGetResponsesContentApplicationJsonSchemaItemsItemsSysSpaceSys

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

### SpacesSpaceIdDesignLibrariesGetResponsesContentApplicationJsonSchemaItemsItemsSysBasedOnEnvironment

- `sys` (SpacesSpaceIdDesignLibrariesGetResponsesContentApplicationJsonSchemaItemsItemsSysBasedOnEnvironmentSys, required)

### SpacesSpaceIdDesignLibrariesGetResponsesContentApplicationJsonSchemaItemsItemsSysBasedOnConcept

- `sys` (SpacesSpaceIdDesignLibrariesGetResponsesContentApplicationJsonSchemaItemsItemsSysBasedOnConceptSys, required)

### SpacesSpaceIdDesignLibrariesGetResponsesContentApplicationJsonSchemaItemsItemsSysBasedOnEnvironmentSys

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

### SpacesSpaceIdDesignLibrariesGetResponsesContentApplicationJsonSchemaItemsItemsSysBasedOnConceptSys

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

## Examples

**Response**

```json
{
  "sys": {
    "type": "string"
  },
  "limit": 1.1,
  "items": [
    {
      "sys": {
        "id": "string",
        "type": "string",
        "createdAt": "string",
        "updatedAt": "string",
        "version": 1,
        "createdBy": {
          "sys": {
            "type": "string",
            "linkType": "string",
            "id": "string"
          }
        },
        "updatedBy": {
          "sys": {
            "type": "string",
            "linkType": "string",
            "id": "string"
          }
        },
        "space": {
          "sys": {
            "type": "string",
            "linkType": "string",
            "id": "string"
          }
        },
        "basedOn": {
          "environment": {
            "sys": {
              "type": "string",
              "linkType": "string",
              "id": "string"
            }
          },
          "concept": {
            "sys": {
              "type": "string",
              "linkType": "string",
              "id": "string"
            }
          }
        }
      },
      "name": "string",
      "description": "string",
      "sharedWithSpaces": "string",
      "recommendedVersion": {
        "sys": {
          "type": "string",
          "linkType": "string",
          "id": "string"
        }
      }
    }
  ],
  "pages": {
    "next": "string",
    "prev": "string"
  }
}
```

**SDK Code**

```http HTTP
GET /spaces/{spaceId}/design_libraries?basedOn.concept.sys.id={conceptId}&limit=20 HTTP/1.1
Host: api.contentful.com
Authorization: Bearer <management_token>
```