---
title: "Read an owned settlement"
method: GET
path: "/v1/settlements/{id}"
tags: ["Payments"]
---

# Read an owned settlement

`GET /v1/settlements/{id}`

## Request

- Base URL: `https://www.licium.ai`
- URL: `https://www.licium.ai/v1/settlements/{id}`
- Auth: one of:
  - none
  - HTTP bearer

Owner-only state, pinned criteria, funding rail, veto deadline, refund state, and terminal outcome. A signed-in requester sees the same settlement at /dashboard/settlements/{id}.

## Path parameters

- `id` string, uuid, required

## Response `200`

Owned settlement.

- object
  - `success` true, required
  - `data` OwnedSettlement, required
    - `id` string, uuid, required
    - `criteria` object, required: The pinned checks snapshot: { checks, template_id, template_version, origin }.
    - `criteria_origin` 'buyer_pinned' | 'template' | 'saved_contract', required
    - `amount_usd` number, required
    - `currency` 'usd', required
    - `counterparty_label` string, nullable, required
    - `counterparty_url` string, uri, required: The private link the counterparty uses to upload a file.
    - `deadline_at` string, date-time, required
    - `status` 'created' | 'funded' | 'passed' | 'released' | 'vetoed' | 'expired' | 'refunded' | 'flipped', required
    - `funding_rail` 'stripe' | 'x402' | 'balance', nullable, required
    - `funded` boolean, required: True once the escrow is held.
    - `passed_at` string, date-time, nullable, required
    - `veto_deadline_at` string, date-time, nullable, required
    - `veto_open` boolean, required: True while a passed settlement can still be vetoed.
    - `veto_reason` string, nullable, required
    - `released_at` string, date-time, nullable, required
    - `refunded_at` string, date-time, nullable, required
    - `refund_pending` boolean, required: A refund started and has not finished (a USDC return in flight).
    - `flipped_bounty_id` string, uuid, nullable, required
    - `created_at` string, date-time, required
    - `release_not_before` string, date-time, nullable, required: After a pass, the earliest release time: the end of the 24-hour veto window, or 7 days after funding when the escrow was paid by card or by a balance bought with a card.
    - `payment_reversal` 'refund' | 'dispute', nullable, required: The card payment behind this settlement was refunded or disputed. The money went back to the card and the settlement never releases.
    - `latest_check` object, nullable: GET /v1/settlements/{id} only: the newest file the counterparty ran through the pinned checks, or null. Licium keeps the file's sha256 fingerprint, not the file.
      - `verdict` 'pass' | 'fail', required
      - `checked_at` string, date-time, required
      - `file_fingerprint` string, required: sha256 of the checked file, hex.
      - `checks` object[], required
        - `check_id` string, required
        - `label` string, required
        - `passed` boolean, required

## Other responses

- `401`: Authentication required.
- `404`: No owned settlement.
- `503`: Feature disabled or unavailable.

---

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