---
title: "Read ingestion settlement"
method: GET
path: "/api/v1/ingest/{ingestionId}"
tags: ["ingestion"]
---

# Read ingestion settlement

`GET /api/v1/ingest/{ingestionId}`

## Request

- Base URL: `https://api.past.dev`
- URL: `https://api.past.dev/api/v1/ingest/{ingestionId}`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

Return this send's status (processing, completed or failed) and project-wide readiness counts. Poll until status is completed before relying on recall for the update; settled describes the whole project.

## Path parameters

- `ingestionId` string, uuid, required

## Response `200`

The current ingestion and readiness state.

- IngestionStatus
  - `status` 'processing' | 'completed' | 'failed', required: This send. Poll until completed. failed means the send stopped on an error: failure names the reason, and POST /api/v1/ingest/{ingestionId}/retry runs it again.
  - `settled` boolean, required
  - `blocked` boolean, required
  - `readiness` IngestionReadiness, required
    - `raw` integer, required
    - `comprehension` integer, required
    - `consolidation` integer, required
    - `failed` integer, required
  - `failure` IngestionFailure
    - `code` 'model-unavailable' | 'model-response-unreadable' | 'index-unavailable' | 'content-rejected' | 'internal', required: Why the send stopped. content-rejected is the one reason a retry does not fix.
    - `message` string, required: The same reason in one sentence.

## Other responses

- `400`: The request is malformed or violates a field constraint. Match behavior on the response code field.
- `401`: missing-api-key: no bearer. malformed-api-key: the header or the key has the wrong shape, or an agent token was sent to a route that accepts keys only. unauthorized: the key is unknown, expired, revoked, or of the kind this route refuses, or the agent token is invalid or expired.
- `403`: project-archived: the project of the key, or the project an agent token names, is archived. Unarchive it in the console to resume. insufficient-scope: the agent token does not carry the scope of the route.
- `404`: No matching ingestion exists in the selected project.
- `default`: Any other failure uses the same JSON error envelope.

---

[API](https://skmtc.dev/past/apis/past-dev-memory-api.md) · [All operations](https://skmtc.dev/past/apis/past-dev-memory-api/llms.txt) · [OpenAPI document](https://skmtc.dev/past/apis/past-dev-memory-api/revisions/3ddccc19f0eb?raw)