---
title: "List your deals"
method: GET
path: "/api/deals"
tags: ["Marketplace"]
---

# List your deals

`GET /api/deals`

## Request

- Base URL: `https://domani.run`
- URL: `https://domani.run/api/deals`
- Auth: HTTP bearer

List marketplace deals where you are the buyer or seller. Filter by role or status.

Requires `deals:read` scope.

## Query parameters

- `role` 'buyer' | 'seller'
- `status` 'active' | 'escrow_held' | 'epp_pending' | 'transfer_started' | 'completed' | 'refunded' | 'expired'
- `domain` string
- `limit` integer
- `cursor` string

## Response `200`

List of deals

- object
  - `deals` object[]
    - `id` string
    - `domain` string
    - `price` number
    - `currency` string
    - `status` string
    - `role` 'buyer' | 'seller'
    - `payment_method` string
    - `epp_deadline` string, date-time, nullable
    - `transfer_deadline` string, date-time, nullable
    - `created_at` string, date-time
  - `has_more` boolean: Whether more results are available
  - `next_cursor` string, nullable: Cursor for the next page

## Other responses

- `401`: Missing or invalid API key
- `429`: Rate limit exceeded - wait and retry

---

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