---
title: "Your licence orders"
method: GET
path: "/buyer-orders"
tags: ["Verify and records"]
---

# Your licence orders

`GET /buyer-orders`

## Request

- Base URL: `https://api.opedd.com`
- URL: `https://api.opedd.com/buyer-orders`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

Your licence orders, newest first, each with its lines (one per publisher). Page with `cursor` (from `pagination.next_cursor`) and `limit` (up to 100, default 20). With `order_id`, one order, where each line also carries its Schedule document text and SHA-256. Another buyer's order answers 404. Credential: your buyer account session, or a buyer API key with the `audit` scope (read only). 120 requests per minute. Each order's `licence` is the licence ordered; a complete-access order reports `enterprise` with `includes_full_catalogue: true`, and has a second line per publisher for the Full catalogue.

## Query parameters

- `order_id` string, uuid
- `cursor` string
- `limit` integer

## Response `200`

Your orders

## Other responses

- `400`: Invalid `order_id`, `limit` or cursor
- `401`: Missing or invalid credential
- `403`: The key does not carry the `audit` scope
- `404`: Order not found
- `429`: Too many requests

---

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