# List an engram's claims

Follow the returned `nextPageUrl` unchanged, preserving the original selection. An empty or
short page can still have a continuation. See [Pagination](https://augenta.pages.dev/docs/pagination.md).

## GET `/v1/engrams/{id}/claims`

The claims an engram holds now, in a stable order, each with the id Consolidate gave it. A filtered page can hold fewer than limit claims, even none, while more remain: follow nextPageUrl until it is null. Follow it with the same Workspace, filters and limit; a new fold invalidates the cursor.

## Authentication

Use an API key with the AugentaKey authorization scheme. See [Authentication](https://augenta.pages.dev/docs/authentication.md).

## Request example

```bash
curl --fail-with-body --get "https://api.augenta.ai/v1/engrams/$AUGENTA_ENGRAM_ID/claims" \
  -H "Authorization: AugentaKey $AUGENTA_API_KEY" \
  --data-urlencode "workspace=$AUGENTA_WORKSPACE_ID"
```

## Parameters

<a id="request-parameters-id"></a>

### `request.parameters.id`

`string` · required

path parameter.

<a id="request-parameters-workspace"></a>

### `request.parameters.workspace`

`string` · optional

query parameter. One assigned Workspace. Required for keys with multiple assignments; inferred for one.

<a id="request-parameters-limit"></a>

### `request.parameters.limit`

`integer` · optional

query parameter.

Default: `100`.

Minimum: `1`. Maximum: `500`.

<a id="request-parameters-page"></a>

### `request.parameters.page`

`string` · optional

query parameter. The previous memory cursor, with the same selection. Follow the returned nextPageUrl unchanged.

Min length: `1`. Max length: `131072`.

<a id="request-parameters-experience"></a>

### `request.parameters.experience`

`string` · optional

query parameter. Only the claims this experience contributed (an id POST /v1/experiences returned).

<a id="request-parameters-at-gt-"></a>

### `request.parameters.at[gt]`

`string` · optional

query parameter. Claim observation time greater than this value.

<a id="request-parameters-at-gte-"></a>

### `request.parameters.at[gte]`

`string` · optional

query parameter. Claim observation time at least this value.

<a id="request-parameters-at-lt-"></a>

### `request.parameters.at[lt]`

`string` · optional

query parameter. Claim observation time less than this value.

<a id="request-parameters-at-lte-"></a>

### `request.parameters.at[lte]`

`string` · optional

query parameter. Claim observation time at most this value.

## Response 200

One bounded page of claims.

Content-Type: `application/json`

```json
{
  "object": "list",
  "data": [
    {
      "object": "claim",
      "id": "clm_000000000000000000000001",
      "text": "Production releases require owner approval.",
      "experience": "exp_000000000000000000000001",
      "at": "2026-10-28T12:00:00.000Z"
    }
  ],
  "nextPageUrl": null
}
```

<a id="response-200-object"></a>

### `response.200.object`

`string` · always present

The collection type. Always list.

Allowed values: `"list"`.

<a id="response-200-data"></a>

### `response.200.data`

`array<value>` · always present

Claims loaded on this page. A short or empty page can still have a continuation.

<a id="response-200-data-object"></a>

### `response.200.data.object`

`string` · always present

The resource type. Always claim.

Allowed values: `"claim"`.

<a id="response-200-data-id"></a>

### `response.200.data.id`

`string` · always present

The ID Augenta assigns to this statement, starting with clm\_. Use it to match a Claim in extractedClaims.data with the same Claim in an Engram's claims.data. It belongs to the Workspace or one-shot result that returned it.

<a id="response-200-data-text"></a>

### `response.200.data.text`

`string` · always present

The statement extracted from your source, such as Production releases require owner approval. Read this field for the Claim's content. Claims do not have labels.

<a id="response-200-data-experience"></a>

### `response.200.data.experience`

`string | null` · always present

The id of the Experience this Claim came from. In Workspace mode, use it with GET /v1/experiences/{id} to check processing status. Null means the source could not be identified for an older Claim.

<a id="response-200-data-at"></a>

### `response.200.data.at`

`string` · always present

When this statement was observed in its source, as an ISO-8601 timestamp. This is not the time you fetched the Claim.

<a id="response-200-data-source"></a>

### `response.200.data.source`

`object` · conditional

Additional source details, such as a conversation session or document path, when available. The fields depend on how the source was submitted. Omitted when no source details are available.

<a id="response-200-nextpageurl"></a>

### `response.200.nextPageUrl`

`string | null` · always present

Follow this relative URL unchanged. Null means there is no next page. One-shot output can still omit items when truncated is true.

<a id="response-200-url"></a>

### `response.200.url`

`string` · conditional

The collection's resource path, when available. Use nextPageUrl, rather than this path, to load the next page.

<a id="response-200-truncated"></a>

### `response.200.truncated`

`boolean` · conditional

True when a bounded one-shot result omitted items. One-shot results have no browsing continuation; use Workspace-backed memory when you need subsequent retrieval. False means all selected items were returned. Workspace lists use nextPageUrl instead.

<a id="response-200-billing"></a>

### `response.200.billing`

`object` · conditional

Present when billing is enabled. USD amount is exact. Receipt references settle only on successful server delivery; retries reuse the original debit.

<a id="response-200-billing-operationid"></a>

### `response.200.billing.operationId`

`string` · always present

<a id="response-200-billing-priceversion"></a>

### `response.200.billing.priceVersion`

`string` · always present

<a id="response-200-billing-sourcetokens"></a>

### `response.200.billing.sourceTokens`

`integer` · always present

Minimum: `0`.

<a id="response-200-billing-memorytokens"></a>

### `response.200.billing.memoryTokens`

`integer` · always present

Minimum: `0`.

<a id="response-200-billing-measuredmemorytokens"></a>

### `response.200.billing.measuredMemoryTokens`

`integer` · always present

Minimum: `0`.

<a id="response-200-billing-replayed"></a>

### `response.200.billing.replayed`

`boolean` · always present

<a id="response-200-billing-complimentary"></a>

### `response.200.billing.complimentary`

`boolean` · conditional

<a id="response-200-billing-ratedamount"></a>

### `response.200.billing.ratedAmount`

`string` · conditional

<a id="response-200-billing-amount"></a>

### `response.200.billing.amount`

`string` · always present

<a id="response-200-billing-receiptids"></a>

### `response.200.billing.receiptIds`

`array<string>` · always present

## Response 400

Invalid cursor, filter, limit or missing Workspace for a person or a key with multiple assignments.

Content-Type: `application/json`

<a id="response-400-error"></a>

### `response.400.error`

`object` · always present

<a id="response-400-error-code"></a>

### `response.400.error.code`

`string` · always present

Stable. The Errors page lists every code.

<a id="response-400-error-message"></a>

### `response.400.error.message`

`string` · always present

Human-readable. May change; don't parse it.

<a id="response-400-error-retryable"></a>

### `response.400.error.retryable`

`boolean` · always present

<a id="response-400-error-retryafterseconds"></a>

### `response.400.error.retryAfterSeconds`

`integer` · conditional

Capacity retry interval, also present as Retry-After before stream headers commit. SSE error events retain this field after HTTP 200 is committed.

Minimum: `1`.

<a id="response-400-error-billingurl"></a>

### `response.400.error.billingUrl`

`string` · conditional

Top-up action when error.code is insufficient_balance (HTTP 402).

<a id="response-400-requestid"></a>

### `response.400.requestId`

`string` · always present

The request's id, as in the `X-Request-Id` response header.

## Response 401

Authentication required; revoked credentials are refused.

Content-Type: `application/json`

Response fields use the same schema as Response 400.

## Response 402

insufficient_balance: add credits before reading billable memory.

Content-Type: `application/json`

Response fields use the same schema as Response 400.

## Response 403

Workspace access denied or Connector disabled.

Content-Type: `application/json`

Response fields use the same schema as Response 400.

## Response 404

Workspace or engram not found.

Content-Type: `application/json`

Response fields use the same schema as Response 400.

## Response 409

Workspace archived, or cursor_stale: a new fold changed the list snapshot; restart without a cursor.

Content-Type: `application/json`

Response fields use the same schema as Response 400.

## Response 429

rate_limited: retry after the Retry-After header.

Content-Type: `application/json`

Response fields use the same schema as Response 400.

## Response 500

An internal failure; quote the requestId.

Content-Type: `application/json`

Response fields use the same schema as Response 400.

## Response 502

Cognition failed or returned an invalid response.

Content-Type: `application/json`

Response fields use the same schema as Response 400.

## Response 503

Cognition is unavailable or unconfigured.

Content-Type: `application/json`

Response fields use the same schema as Response 400.
