---
title: "Recent receipts for this key"
method: GET
path: "/v1/receipts"
---

# Recent receipts for this key

`GET /v1/receipts`

## Request

- Base URL: `https://api.doubleoh.ai`
- URL: `https://api.doubleoh.ai/v1/receipts`
- Auth: one of:
  - API key in header `x-api-key`
  - HTTP bearer

## Query parameters

- `state` string
- `limit` integer

## Response `200`

Newest first.

- object
  - `receipts` object[]
    - `id` string
    - `state` 'pending' | 'needs_person' | 'confirmed' | 'failed' | 'unconfirmed' | 'refused' | 'approved' | 'held': approved: a person said yes; do it, then confirm (with approval.correctedArgs when a person changed the call). refused: a rule or a person said no; approval.reason says why when it was a person. held: allowed, but held for the team until heldUntil; GET it with ?wait=55 until it changes.
    - `tool` string
    - `target` string, nullable
    - `action` string
    - `agent` string, nullable: Who acted: the key's agent, else the label sent.
    - `agentName` string, nullable: Verified: the agent this key belongs to (one key per agent). Null on a legacy key.
    - `claimedAgent` string, nullable: A label the request sent that is not the key's agent (a legacy key's self-reported name, or another name a bound key sent on a read). Unverified.
    - `idempotencyKey` string
    - `amountCents` integer, nullable
    - `currency` string, nullable
    - `evidence` object, nullable
    - `authority` object, nullable
      - `decision` string
      - `ruleId` string
      - `sentence` string
      - `pattern` 'split': split: this looks like one payment cut into smaller ones (several in a short time that together pass a limit). Limits count a running total per agent and currency over their window.
    - `approval` object, nullable: When a person had to decide: their yes or no, why, who, when, and the intervention it was given on.
      - `approved` boolean
      - `reason` string, nullable
      - `by` string, nullable
      - `at` string, date-time
      - `interventionId` string
      - `amountCents` integer, nullable: How much the person approved, which may be less than the receipt's amountCents.
      - `currency` string, nullable
    - `deadlineAt` string, date-time
    - `confirmedAt` string, date-time, nullable
    - `interventionId` string, nullable

---

[API](https://skmtc.dev/doubleoh/apis/doubleoh-api.md) · [All operations](https://skmtc.dev/doubleoh/apis/doubleoh-api/llms.txt) · [OpenAPI document](https://skmtc.dev/doubleoh/apis/doubleoh-api/revisions/398fb6ef5068?raw)