---
title: "Get Enrichments"
method: GET
path: "/api/v3/enrichments"
tags: ["Enrichments"]
---

# Get Enrichments

`GET /api/v3/enrichments`

Get a cursor-paginated list of enrichment records for the user across all workspaces.
Results are ordered by (created_at DESC, id DESC). Pass the id of the last
enrichment from the previous page as `after` to fetch the next page. Total
count is returned only on the first request (when `after` is omitted).

Filters (all optional, combined with AND):
- `institution_ids`: restrict to enrichments for these institutions.
- `statuses`: restrict to these status values. Use `"unknown"` to match rows
  where status IS NULL (mirrors the bucket key returned by /stats).

## Query parameters

- `institution_ids` string[]
- `statuses` string[]
- `after` string, nullable — Enrichment id to page after (the `next_cursor` from a previous response). Omit to fetch the first page.
- `limit` integer

## Response `200`

Successful Response

- AllEnrichmentsResponse
  - `data` EnrichmentWithInstitution[], required
    - `id` string, uuid, required
    - `user_email` string, nullable, required
    - `type` string, nullable, required
    - `status` string, nullable, required
    - `created_at` string, date-time, required
    - `modified_at` string, date-time, nullable, required
    - `request_text` string, nullable, required
    - `result` string, nullable, required
    - `institution_id` string, nullable, required
    - `workspace_id` string, uuid, nullable, required
    - `institution_metadata` EnrichmentInstitutionMetadata, required
      - `institution_id` string, required
      - `institution_name` string, nullable, required
      - `institution_state` string, nullable, required
      - `institution_city` string, nullable, required
      - `institution_county` string, nullable, required
      - `institution_label` string, nullable, required
  - `limit` integer, required
  - `has_more` boolean
  - `next_cursor` string, nullable
  - `total` integer, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/nationgraph/apis/nationgraph-api.md) · [All operations](https://skmtc.net/nationgraph/apis/nationgraph-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/nationgraph/nationgraph-api/revisions/85804e68d86d/schema)