---
title: "List All Record IDs"
method: GET
path: "/records/ids"
tags: ["Records"]
---

# List All Record IDs

`GET /records/ids`

## Request

- Base URL: `https://ironcladapp.com/public/api/v1`
- URL: `https://ironcladapp.com/public/api/v1/records/ids`
- Auth: API key in header `Authorization` and OAuth 2
  - Authorization code: `https://ironcladapp.com/oauth/authorize`
  - Client credentials
  - Token URL: `https://ironcladapp.com/oauth/token` scopes: `public.records.readRecords`

Returns only the identifiers of the records you can access, without record bodies or properties. Use this to determine which records are visible to your credentials without paying the cost of a full record listing.

Filtering, sorting, and pagination behave the same as [List All Records](https://developer.ironcladapp.com/reference/list-all-records), and the identifiers returned are the same ones that endpoint would return for the same parameters. Because each result contains only identifiers, `pageSize` may be set as high as 10000.

**OAuth Scope required:** `public.records.readRecords`

## Query parameters

- `page` integer
- `pageSize` integer
- `types` string
- `lastUpdated` string
- `filter` string
- `search` string
- `sortField` 'agreementDate' | 'name' | 'lastUpdated'
- `sortDirection` 'ASC' | 'DESC'

## Headers

- `x-as-user-email` string
- `x-as-user-id` string

## Response `200`

200

- object
  - `page` integer
  - `pageSize` integer
  - `count` integer
  - `list` IdReferenceModel[]
    - `id` string, required: The unique identifier of the object
    - `ironcladId` string: The human-readable identifier of the object as displayed in Ironclad. Omitted when no readable identifier has been assigned to the object.

## Other responses

- `400`: 400
- `401`: 401
- `403`: 403
- `404`: 404

## Changes

- **2026-11-03** `435da5a4396e`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/ironcladapp/apis/ironclad-public-api/changes/records/ids/get.md)

---

[API](https://skmtc.dev/ironcladapp/apis/ironclad-public-api.md) - [All operations](https://skmtc.dev/ironcladapp/apis/ironclad-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/ironcladapp/apis/ironclad-public-api/revisions/435da5a4396e?raw)