---
title: "Fetch the deal's certificate (parties only)"
method: GET
path: "/v1/deals/{id}/certificate"
tags: ["certificates"]
---

# Fetch the deal's certificate (parties only)

`GET /v1/deals/{id}/certificate`

## Request

- Base URL: `https://api.redeal.dev`
- URL: `https://api.redeal.dev/v1/deals/{id}/certificate`
- Auth: HTTP bearer

## Path parameters

- `id` string, required

## Response `200`

The signed certificate with transparency-log inclusion proof

- Certificate: Signed outcome certificate (ADR-0004). signed-payload = JCS(cert minus signature and log_proof).
  - `cert_version` string
  - `cert_id` string
  - `deal_id` string
  - `outcome` 'COMPUTED' | 'VOID'
  - `algorithm` string
  - `mode` 'sealed' | 'open'
  - `retention` 'standard' | 'purge'
  - `parties` object[]
    - `index` integer
    - `label` string
    - `commitment` string, nullable
    - `attested_by` string
  - `input_root` string, nullable: Merkle root over per-party input leaves in party-index order (sealed party: hash of its published commitment string; open-mode party: hash of the canonical input). Null for VOID deals with insufficient reveals
  - `result` object, nullable
  - `void_flakers` integer[], nullable
  - `properties` string[]: guarantee flags, e.g. verifiability
  - `timing` object
    - `created_at` integer
    - `commits_closed_at` integer, nullable
    - `reveals_closed_at` integer, nullable
    - `computed_at` integer, nullable
  - `log_proof` object
    - `tree_size` integer
    - `leaf_index` integer
    - `inclusion_path` string[]
  - `tee_attestation` object, nullable: reserved; null until TEE deployments
  - `signature` string: "<scheme>:<hex>" — es256:<128 hex> (ECDSA P-256, raw r||s low-S; the KMS launch form) or ed25519:<128 hex> (pre-KMS dev certs)

## Other responses

- `401`: Error. The message is instructive: it names the code and the fix.
- `403`: Error. The message is instructive: it names the code and the fix.
- `409`: Error. The message is instructive: it names the code and the fix.

---

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