---
title: "Deal view (never includes revealed inputs)"
method: GET
path: "/v1/deals/{id}"
tags: ["deals"]
---

# Deal view (never includes revealed inputs)

`GET /v1/deals/{id}`

## Request

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

Authenticate with the initiator API key or any party invite token.

## Path parameters

- `id` string, required

## Response `200`

Deal view

- DealView: The deal view. NEVER contains revealed inputs.
  - `deal_id` string
  - `algorithm` string
  - `algorithm_params` object
  - `mode` 'sealed' | 'open'
  - `retention` 'standard' | 'purge'
  - `state` 'OPEN' | 'COMMITTING' | 'REVEALING' | 'COMPUTED' | 'CERTIFIED' | 'VOID' | 'EXPIRED' | 'CANCELLED'
  - `initiator` integer
  - `parties` object[]
    - `index` integer
    - `label` string
    - `committed` boolean
    - `commitment` string, nullable
    - `revealed` boolean
  - `commit_deadline` integer
  - `reveal_deadline` integer
  - `created_at` integer
  - `commits_closed_at` integer, nullable
  - `reveals_closed_at` integer, nullable
  - `computed_at` integer, nullable
  - `result` object, nullable
  - `void_flakers` integer[], nullable
  - `certificate_id` string, nullable

## 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.
- `404`: 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)