---
title: "Get collection of related records within one cataloguing level"
method: GET
path: "/records/children/{parentId}"
tags: ["Records"]
---

# Get collection of related records within one cataloguing level

`GET /records/children/{parentId}`

## Request

- Base URL: `https://discovery.nationalarchives.gov.uk/API`
- URL: `https://discovery.nationalarchives.gov.uk/API/records/children/{parentId}`
- Auth: none declared
- TypeScript: <https://skmtc.dev/the-national-archives/apis/discovery/docs/records/children/:parentId/get.ts> (a function with typed inputs; its response is checked against the schema)

Values of {parentId}, {batchStartRecordId} and {batchStartMark} are case sensitive

## Path parameters

- `parentId` string, required

## Query parameters

- `direction` 'NEXT' | 'PREV'
- `includeCursor` boolean
- `batchStartRecordId` string
- `batchStartMark` string
- `limit` integer

## Response `200`

OK

- AssetCollectionViewModelInformationAssetIdentityViewModel: Represents a collection of assets with pagination information.
  - `Assets` InformationAssetIdentityViewModel[]: Gets or sets the list of assets in the collection.
    - `AccessConditions` string: Access Conditions
    - `CatalogueId` integer: Catalogue Id
    - `CitableReference` string: Citable Reference
    - `ClosureCode` string: Closure Code
    - `ClosureStatus` string: Closure Status
    - `ClosureType` string: Closure Type
    - `CoveringDates` string: Covering Dates
    - `CoveringFromDate` integer: Covering From Date
    - `CoveringToDate` integer: Covering To Date
    - `ScopeContent` ScopeContentViewModel: Represents the scope content details of an information asset, including place names, description, ephemera, and schema.
      - `PlaceNames` string[]: Gets or sets the list of place names associated with the information asset.
      - `Description` string: Gets or sets the description of the information asset.
      - `Ephemera` string: Gets or sets the ephemera information related to the information asset.
      - `Schema` string: Gets or sets the schema information for the information asset.
    - `Digitised` boolean: Digitised
    - `HeldBy` XReferenceViewModel[]: Repositories
      - `XReferenceId` string: ID of referenced resource
      - `XReferenceCode` string: Resource code
      - `XReferenceName` string: Resource name
      - `XReferenceType` string: Resource type
      - `XReferenceURL` string: Resource URL
      - `XReferenceDescription` string: Resource description
      - `XReferenceSortWord` string: Resource sort word
    - `Id` string: Record ID
    - `IsParent` boolean: Is Parent
    - `CatalogueLevel` integer: Catalogue level
    - `ParentId` string: Parent Id
    - `RecordOpeningDate` string: Record Opening Date
    - `ReferencePart` string: Reference Part
    - `ReferenceParentId` string: Reference Parent Id
    - `SortKey` string: Sort Key
    - `Source` string: Source
    - `Title` string: Title
  - `HasMoreAfterLast` boolean: Gets or sets a value indicating whether there are more assets after the last item in the collection.
  - `HasMoreBeforeFirst` boolean: Gets or sets a value indicating whether there are more assets before the first item in the collection.

## Other responses

- `400`: Bad request
- `404`: Not found
- `500`: Internal Server Error

---

[API](https://skmtc.dev/the-national-archives/apis/discovery.md) - [All operations](https://skmtc.dev/the-national-archives/apis/discovery/llms.txt) - [OpenAPI document](https://skmtc.dev/the-national-archives/apis/discovery/revisions/1e8c76e26ab1?raw)