---
title: "List enrichment records"
method: GET
path: "/enrichment/schemas/{schema_id}/records"
tags: ["Enrichment Schemas"]
---

# List enrichment records

`GET /enrichment/schemas/{schema_id}/records`

## Request

- Base URL: `https://api.pagerduty.com`
- URL: `https://api.pagerduty.com/enrichment/schemas/{schema_id}/records`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/pagerduty/apis/rest-api/docs/enrichment/schemas/:schema_id/records/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieves a page of enrichment records for a schema. Results are cursor-paginated.

<!-- theme: warning -->

> ### Early Access
> This API is in Early Access and may change at any time. Contact your PagerDuty account team to request access.

Scoped OAuth requires: `contextual_data.read`

## Path parameters

- `schema_id` string, uuid, required

## Query parameters

- `limit` integer
- `cursor` string

## Headers

- `Accept` string, required

## Response `200`

A page of enrichment records for the schema.

- object
  - `schema_id` string, uuid: The schema the records belong to.
  - `records` EnrichmentRecord[]: The page of enrichment records.
    - `record_id` string: Unique identifier for this enrichment record.
    - `type` string: The type of the resource.
    - `created_at` string, date-time: Timestamp when the record was created.
    - `enrichment_data` object: The enrichment data for this record, as key-value pairs keyed by field name.
  - `next_cursor` string, nullable: Cursor for fetching the next page, or `null` if there are no more pages.

## Other responses

- `400`: Caller provided invalid arguments. Please review the response for error details. Retrying with the same arguments will *not* work.
- `401`: Caller did not supply credentials or did not provide the correct credentials. If you are using an API key, it may be invalid or your Authorization header may be malformed.
- `403`: Caller is not authorized to view the requested resource. While your authentication is valid, the authenticated user or token does not have permission to perform this action.
- `404`: The requested resource was not found.
- `429`: Too many requests have been made, the rate limit has been reached.
- `500`: Internal Server Error the PagerDuty server experienced an error.

---

[API](https://skmtc.dev/pagerduty/apis/rest-api.md) - [All operations](https://skmtc.dev/pagerduty/apis/rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/pagerduty/apis/rest-api/revisions/b679a8f3f02c?raw)