---
title: "Notarize one edge receipt or declared receipt digest"
method: POST
path: "/v1/receipts/notarize"
tags: ["receipts"]
---

# Notarize one edge receipt or declared receipt digest

`POST /v1/receipts/notarize`

## Request

- Base URL: `https://api.runx.ai`
- URL: `https://api.runx.ai/v1/receipts/notarize`
- Auth: HTTP bearer

Requires a bearer principal with receipts:write scope.

## Request body

- union
  - object
    - `publish` boolean
    - `public_claim` ReceiptPublicClaim
      - `schema` 'runx.public_receipt_claim.v1', required
      - `kind` 'payout' | 'funding' | 'judgment' | 'profile_update' | 'delivery' | 'signup', required
      - `title` string, required
      - `venue` object, required
        - `id` string, required
        - `name` string
        - `url` string, uri
      - `subject` object
        - `type` string, required
        - `id` string, required
        - `label` string
      - `amount` object
        - `cents` integer, required
        - `currency` string, required
      - `source_url` string, uri
      - `occurred_at` string, date-time, required
    - `receipt` object, required
  - object
    - `publish` boolean
    - `public_claim` ReceiptPublicClaim
      - `schema` 'runx.public_receipt_claim.v1', required
      - `kind` 'payout' | 'funding' | 'judgment' | 'profile_update' | 'delivery' | 'signup', required
      - `title` string, required
      - `venue` object, required
        - `id` string, required
        - `name` string
        - `url` string, uri
      - `subject` object
        - `type` string, required
        - `id` string, required
        - `label` string
      - `amount` object
        - `cents` integer, required
        - `currency` string, required
      - `source_url` string, uri
      - `occurred_at` string, date-time, required
    - `receipt_raw` string, required
  - object
    - `mode` 'hash_only', required
    - `publish` boolean
    - `public_claim` ReceiptPublicClaim
      - `schema` 'runx.public_receipt_claim.v1', required
      - `kind` 'payout' | 'funding' | 'judgment' | 'profile_update' | 'delivery' | 'signup', required
      - `title` string, required
      - `venue` object, required
        - `id` string, required
        - `name` string
        - `url` string, uri
      - `subject` object
        - `type` string, required
        - `id` string, required
        - `label` string
      - `amount` object
        - `cents` integer, required
        - `currency` string, required
      - `source_url` string, uri
      - `occurred_at` string, date-time, required
    - `digest` string, required
    - `receipt_id` string

## Response `201`

Receipt notarized.

- ReceiptNotaryEnvelope
  - `status` 'notarized', required
  - `replay_status` 'created' | 'existing', required
  - `digest` string, required
  - `public_hash` string, required
  - `mode` 'full' | 'hash_only', required
  - `published` boolean, required
  - `receipt_id` string
  - `public_claim` ReceiptPublicClaim
    - `schema` 'runx.public_receipt_claim.v1', required
    - `kind` 'payout' | 'funding' | 'judgment' | 'profile_update' | 'delivery' | 'signup', required
    - `title` string, required
    - `venue` object, required
      - `id` string, required
      - `name` string
      - `url` string, uri
    - `subject` object
      - `type` string, required
      - `id` string, required
      - `label` string
    - `amount` object
      - `cents` integer, required
      - `currency` string, required
    - `source_url` string, uri
    - `occurred_at` string, date-time, required
  - `public_url` string, uri
  - `edge_issuer` object
  - `binary_version` string, required
  - `verified_at` string, date-time, required
  - `verdict` object, required
  - `counter_seal` object, required

## Other responses

- `400`: Validation error.
- `401`: Unauthorized.
- `403`: Forbidden.
- `413`: Receipt request too large.
- `422`: Receipt verification failed.
- `429`: Rate limited.
- `503`: Receipt notary unavailable.

---

[API](https://skmtc.dev/runx/apis/runx-hosted-api.md) · [All operations](https://skmtc.dev/runx/apis/runx-hosted-api/llms.txt) · [OpenAPI document](https://skmtc.dev/runx/apis/runx-hosted-api/revisions/6c940d8edacc?raw)