---
title: "List deal requests"
method: GET
path: "/deal-requests"
tags: ["Deal Requests"]
---

# List deal requests

`GET /deal-requests`

## Request

- Base URL: `https://api.sovrn.com/sovrnos/v1`
- URL: `https://api.sovrn.com/sovrnos/v1/deal-requests`
- Auth: API key in header `x-api-key`

Slim summaries for the authenticated partner. Status is the last-known value: list reads do not refresh it, so poll `GET /deal-requests/{id}` for freshness. Excludes archived deals unless `?status=archived`.

## Query parameters

- `status` 'active' | 'archived' | 'paused' | 'scheduled' | 'review' | 'dsp review'
- `limit` integer
- `offset` integer

## Response `200`

A page of deal request summaries.

- DealRequestList
  - `data` DealRequestSummary[], required
    - `dealRequestId` string, required
    - `name` string, required
    - `type` 'pmp' | 'open', required
    - `status` 'active' | 'archived' | 'paused' | 'scheduled' | 'review' | 'dsp review', required
    - `statusAsOf` string, date-time, required
    - `deal` DealLinkage, required
      - `externalDealId` string, required
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required
  - `total` integer, required
  - `limit` integer, required
  - `offset` integer, required

## Other responses

- `400`: The request failed validation; `message` names the problem, for example `takeRate is a decimal fraction; expected 0 ≤ x ≤ 0.85`. See the Errors guide.
- `401`: The API key was missing or not accepted. **Not JSON**: a bare `text/plain` string: `api key not provided`, `invalid api key`, or `invalid api key syntax`.
- `403`: The key is valid but not permitted. `{"message": "Insufficient scope"}`: a read-only key sent a write (`POST` or `PATCH`). It is checked before the body is validated, even with `?dryRun=true`. `{"message": "Partner not authorized for this API"}`: the account is not enabled for this API. It is checked after the request is validated, so an invalid request gets its `400` first.

---

[API](https://skmtc.dev/sovrn/apis/curation-api.md) - [All operations](https://skmtc.dev/sovrn/apis/curation-api/llms.txt) - [OpenAPI document](https://skmtc.dev/sovrn/apis/curation-api/revisions/0ef84c7a4a94?raw)