> ## Documentation Index
> Fetch the complete documentation index at: https://traddal.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Restrict history

> Your organization's restricted-goods check log.

Requires the `restrict:read` scope.

Stripe-style keyset pagination on `(created_at, id)`, newest first:
`starting_after` walks older, `ending_before` walks newer.

<ParamField query="starting_after" type="string">
  A request id (UUID) — return checks older than it.
</ParamField>

<ParamField query="ending_before" type="string">
  A request id (UUID) — return checks newer than it.
</ParamField>

<ParamField query="limit" type="integer" default="50">
  Page size, 1–100.
</ParamField>

<ResponseField name="data" type="array">
  Each row carries `id`, `sender_country_code`, `receiver_country_code`,
  `item_count`, `match_count`, `duration_ms`, and `created_at`.
</ResponseField>

<ResponseField name="has_more" type="boolean">
  Whether more rows exist in the walked direction.
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl 'https://{partner}.mytraddal.com/admin/api/v1/usage-history/restrict?limit=2' \
    -H 'Authorization: Bearer {access_token}'
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "success": true,
    "message": "",
    "data": [
      {
        "id": "3f6a1d20-8f5b-4e2c-9d17-a4b8c2e6f013",
        "sender_country_code": "IR",
        "receiver_country_code": "US",
        "item_count": 2,
        "match_count": 2,
        "duration_ms": 84,
        "created_at": "2026-07-30T10:15:02.000Z"
      },
      {
        "id": "8c1b2e34-5d6f-4a70-b819-c2d3e4f5a601",
        "sender_country_code": null,
        "receiver_country_code": "US",
        "item_count": 1,
        "match_count": 0,
        "duration_ms": 51,
        "created_at": "2026-07-30T09:58:11.000Z"
      }
    ],
    "has_more": true
  }
  ```
</ResponseExample>