---
title: "Collection definition"
method: GET
path: "/v1/collections/{id}"
tags: ["V1", "Collections"]
---

# Collection definition

`GET /v1/collections/{id}`

## Request

- Base URL: `https://api-dor.ncl.ac.uk`
- URL: `https://api-dor.ncl.ac.uk/v1/collections/{id}`
- Auth: none declared

Returns all the metadata and signposts to the related resources for the given collection.

## Path parameters

- `id` string, required

## Response `200`

The complete definition of the identified collection.

- object
  - `id` string, required
  - `title` string, nullable, required
  - `digitisedObjects` object, required
    - `totalElements` number, required
    - `_links` object, required
      - `search` HateoasLink, required
        - `href` string, required
        - `type` 'GET' | 'POST' | 'PUT' | 'DELETE', required
        - `parameters` HateoasParameters: Any relevant parameters that should be appended to the URL (for GET method) or passed as a payload for other HTTP methods.
  - `items` object, required
    - `totalElements` number, required
    - `_links` object, required
      - `search` HateoasLink, required
        - `href` string, required
        - `type` 'GET' | 'POST' | 'PUT' | 'DELETE', required
        - `parameters` HateoasParameters: Any relevant parameters that should be appended to the URL (for GET method) or passed as a payload for other HTTP methods.
  - `_links` object, required
    - `index` HateoasLink, required
      - `href` string, required
      - `type` 'GET' | 'POST' | 'PUT' | 'DELETE', required
      - `parameters` HateoasParameters: Any relevant parameters that should be appended to the URL (for GET method) or passed as a payload for other HTTP methods.

## Other responses

- `400`: The server could not finalise the response due to the malformed, invalid or missing request parameters.
- `404`: A collection with the specified ID was not found.
- `5XX`: Indicates that the server encountered an unexpected exception preventing it from fulfilling the request.

---

[API](https://skmtc.dev/ncl/apis/newcastle-university-digitised-objects-repository-search-and.md) - [All operations](https://skmtc.dev/ncl/apis/newcastle-university-digitised-objects-repository-search-and/llms.txt) - [OpenAPI document](https://skmtc.dev/ncl/apis/newcastle-university-digitised-objects-repository-search-and/revisions/fe6a8df13009?raw)