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

# Get a design library installation

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

Retrieves a design library installation in the target environment and its processing status.

Poll this endpoint while `sys.status` is `created` or `in_progress`.

Reference: https://contentful.com/developers/docs/references/experience-management-api/design-libraries/installations/get-design-library-installation

## Authentication

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

## Request

### Path parameters

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

## Response

### 200

200

- `Design Library Installations_getDesignLibraryInstallation_Response_200`
  - DesignLibraryInstallationsGetDesignLibraryInstallationResponse2000
  - DesignLibraryInstallationsGetDesignLibraryInstallationResponse2001
  - DesignLibraryInstallationsGetDesignLibraryInstallationResponse2002

## Errors

### 400 Bad Request Error

400

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

### 401 Unauthorized Error

401

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

### 403 Forbidden Error

403

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

### 404 Not Found Error

404

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

### 409 Conflict Error

409

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

### 422 Unprocessable Entity Error

422

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

### 500 Internal Server Error

500

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

## Types

### DesignLibraryInstallationsGetDesignLibraryInstallationResponse2000

- `sys` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsInstallationIdGetResponsesContentApplicationJsonSchemaOneOf0Sys, required)

### DesignLibraryInstallationsGetDesignLibraryInstallationResponse2001

- `sys` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsInstallationIdGetResponsesContentApplicationJsonSchemaOneOf1Sys, required)

### DesignLibraryInstallationsGetDesignLibraryInstallationResponse2002

- `sys` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsInstallationIdGetResponsesContentApplicationJsonSchemaOneOf2Sys, required)
- `errors` (list of SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsInstallationIdGetResponsesContentApplicationJsonSchemaOneOf2ErrorsItems, optional)

### SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsInstallationIdGetResponsesContentApplicationJsonSchemaSys

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

### SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsInstallationIdGetResponsesContentApplicationJsonSchemaOneOf0Sys

- `id` (string, required)
- `type` ("DesignLibraryInstallation", required)
- `createdAt` (string, required)
- `status` (enum, required)
  - Allowed values: `created`, `in_progress`
- `createdBy` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsInstallationIdGetResponsesContentApplicationJsonSchemaOneOf0SysCreatedBy, required)
- `space` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsInstallationIdGetResponsesContentApplicationJsonSchemaOneOf0SysSpace, required)
- `environment` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsInstallationIdGetResponsesContentApplicationJsonSchemaOneOf0SysEnvironment, required)
- `designLibrary` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsInstallationIdGetResponsesContentApplicationJsonSchemaOneOf0SysDesignLibrary, required)
- `version` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsInstallationIdGetResponsesContentApplicationJsonSchemaOneOf0SysVersion, required)
- `completedAt` (string, optional)

### SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsInstallationIdGetResponsesContentApplicationJsonSchemaOneOf1Sys

- `id` (string, required)
- `type` ("DesignLibraryInstallation", required)
- `createdAt` (string, required)
- `status` ("succeeded", required)
- `createdBy` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsInstallationIdGetResponsesContentApplicationJsonSchemaOneOf1SysCreatedBy, required)
- `space` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsInstallationIdGetResponsesContentApplicationJsonSchemaOneOf1SysSpace, required)
- `environment` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsInstallationIdGetResponsesContentApplicationJsonSchemaOneOf1SysEnvironment, required)
- `designLibrary` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsInstallationIdGetResponsesContentApplicationJsonSchemaOneOf1SysDesignLibrary, required)
- `version` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsInstallationIdGetResponsesContentApplicationJsonSchemaOneOf1SysVersion, required, nullable)
- `completedAt` (string, optional)

### SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsInstallationIdGetResponsesContentApplicationJsonSchemaOneOf2Sys

- `id` (string, required)
- `type` ("DesignLibraryInstallation", required)
- `createdAt` (string, required)
- `status` ("failed", required)
- `createdBy` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsInstallationIdGetResponsesContentApplicationJsonSchemaOneOf2SysCreatedBy, required)
- `space` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsInstallationIdGetResponsesContentApplicationJsonSchemaOneOf2SysSpace, required)
- `environment` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsInstallationIdGetResponsesContentApplicationJsonSchemaOneOf2SysEnvironment, required)
- `designLibrary` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsInstallationIdGetResponsesContentApplicationJsonSchemaOneOf2SysDesignLibrary, required)
- `version` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsInstallationIdGetResponsesContentApplicationJsonSchemaOneOf2SysVersion, required, nullable)
- `completedAt` (string, optional)

### SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsInstallationIdGetResponsesContentApplicationJsonSchemaOneOf2ErrorsItems

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

### SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsInstallationIdGetResponsesContentApplicationJsonSchemaOneOf0SysCreatedBy

- `sys` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsInstallationIdGetResponsesContentApplicationJsonSchemaOneOf0SysCreatedBySys, required)

### SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsInstallationIdGetResponsesContentApplicationJsonSchemaOneOf0SysSpace

- `sys` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsInstallationIdGetResponsesContentApplicationJsonSchemaOneOf0SysSpaceSys, required)

### SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsInstallationIdGetResponsesContentApplicationJsonSchemaOneOf0SysEnvironment

- `sys` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsInstallationIdGetResponsesContentApplicationJsonSchemaOneOf0SysEnvironmentSys, required)

### SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsInstallationIdGetResponsesContentApplicationJsonSchemaOneOf0SysDesignLibrary

- `sys` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsInstallationIdGetResponsesContentApplicationJsonSchemaOneOf0SysDesignLibrarySys, required)

### SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsInstallationIdGetResponsesContentApplicationJsonSchemaOneOf0SysVersion

- `sys` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsInstallationIdGetResponsesContentApplicationJsonSchemaOneOf0SysVersionSys, required)

### SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsInstallationIdGetResponsesContentApplicationJsonSchemaOneOf1SysCreatedBy

- `sys` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsInstallationIdGetResponsesContentApplicationJsonSchemaOneOf1SysCreatedBySys, required)

### SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsInstallationIdGetResponsesContentApplicationJsonSchemaOneOf1SysSpace

- `sys` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsInstallationIdGetResponsesContentApplicationJsonSchemaOneOf1SysSpaceSys, required)

### SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsInstallationIdGetResponsesContentApplicationJsonSchemaOneOf1SysEnvironment

- `sys` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsInstallationIdGetResponsesContentApplicationJsonSchemaOneOf1SysEnvironmentSys, required)

### SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsInstallationIdGetResponsesContentApplicationJsonSchemaOneOf1SysDesignLibrary

- `sys` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsInstallationIdGetResponsesContentApplicationJsonSchemaOneOf1SysDesignLibrarySys, required)

### SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsInstallationIdGetResponsesContentApplicationJsonSchemaOneOf1SysVersion

- `sys` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsInstallationIdGetResponsesContentApplicationJsonSchemaOneOf1SysVersionSys, required)

### SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsInstallationIdGetResponsesContentApplicationJsonSchemaOneOf2SysCreatedBy

- `sys` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsInstallationIdGetResponsesContentApplicationJsonSchemaOneOf2SysCreatedBySys, required)

### SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsInstallationIdGetResponsesContentApplicationJsonSchemaOneOf2SysSpace

- `sys` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsInstallationIdGetResponsesContentApplicationJsonSchemaOneOf2SysSpaceSys, required)

### SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsInstallationIdGetResponsesContentApplicationJsonSchemaOneOf2SysEnvironment

- `sys` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsInstallationIdGetResponsesContentApplicationJsonSchemaOneOf2SysEnvironmentSys, required)

### SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsInstallationIdGetResponsesContentApplicationJsonSchemaOneOf2SysDesignLibrary

- `sys` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsInstallationIdGetResponsesContentApplicationJsonSchemaOneOf2SysDesignLibrarySys, required)

### SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsInstallationIdGetResponsesContentApplicationJsonSchemaOneOf2SysVersion

- `sys` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsInstallationIdGetResponsesContentApplicationJsonSchemaOneOf2SysVersionSys, required)

### SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsInstallationIdGetResponsesContentApplicationJsonSchemaOneOf2ErrorsItemsSys

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

### SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsInstallationIdGetResponsesContentApplicationJsonSchemaOneOf0SysCreatedBySys

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

### SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsInstallationIdGetResponsesContentApplicationJsonSchemaOneOf0SysSpaceSys

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

### SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsInstallationIdGetResponsesContentApplicationJsonSchemaOneOf0SysEnvironmentSys

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

### SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsInstallationIdGetResponsesContentApplicationJsonSchemaOneOf0SysDesignLibrarySys

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

### SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsInstallationIdGetResponsesContentApplicationJsonSchemaOneOf0SysVersionSys

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

### SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsInstallationIdGetResponsesContentApplicationJsonSchemaOneOf1SysCreatedBySys

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

### SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsInstallationIdGetResponsesContentApplicationJsonSchemaOneOf1SysSpaceSys

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

### SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsInstallationIdGetResponsesContentApplicationJsonSchemaOneOf1SysEnvironmentSys

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

### SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsInstallationIdGetResponsesContentApplicationJsonSchemaOneOf1SysDesignLibrarySys

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

### SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsInstallationIdGetResponsesContentApplicationJsonSchemaOneOf1SysVersionSys

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

### SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsInstallationIdGetResponsesContentApplicationJsonSchemaOneOf2SysCreatedBySys

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

### SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsInstallationIdGetResponsesContentApplicationJsonSchemaOneOf2SysSpaceSys

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

### SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsInstallationIdGetResponsesContentApplicationJsonSchemaOneOf2SysEnvironmentSys

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

### SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsInstallationIdGetResponsesContentApplicationJsonSchemaOneOf2SysDesignLibrarySys

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

### SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsInstallationIdGetResponsesContentApplicationJsonSchemaOneOf2SysVersionSys

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

## Examples

**Response**

```json
{
  "sys": {
    "completedAt": "string",
    "createdAt": "string",
    "createdBy": {
      "sys": {
        "id": "string",
        "linkType": "string",
        "type": "string"
      }
    },
    "designLibrary": {
      "sys": {
        "id": "string",
        "linkType": "string",
        "type": "string"
      }
    },
    "environment": {
      "sys": {
        "id": "string",
        "linkType": "string",
        "type": "string"
      }
    },
    "id": "string",
    "space": {
      "sys": {
        "id": "string",
        "linkType": "string",
        "type": "string"
      }
    },
    "status": "created",
    "type": "string",
    "version": {
      "sys": {
        "id": "string",
        "linkType": "string",
        "type": "string"
      }
    }
  }
}
```

**SDK Code**

```http HTTP
GET /spaces/{targetSpaceId}/environments/{targetEnvironmentId}/design_library_installations/{installationId} HTTP/1.1
Host: api.contentful.com
Authorization: Bearer <management_token>
```