---
title: "Read the agreements and your Schedules"
method: GET
path: "/legal-documents"
tags: ["Buy"]
---

# Read the agreements and your Schedules

`GET /legal-documents`

## Request

- Base URL: `https://api.opedd.com`
- URL: `https://api.opedd.com/legal-documents`
- Auth: HTTP bearer

For signed-in account holders (buyer or publisher sign-in token). Three uses:

- `kind=<kind>` (optional `version`): an agreement's text, the latest published version unless you name one. `kind` is `buyer_master_agreement`, `standard_licence_terms` or `publisher_agreement`.
- `view=mine`: the agreements that apply to you, the current version, the version you accepted and `needs_acceptance` (true when a newer version is published).
- `order_id` and `publisher_id`: the Schedule for one publisher in one of your orders, with its SHA-256. Only the order's buyer or that publisher can read it; anyone else gets 404.

Nothing is cached. 120 requests per minute.

## Query parameters

- `kind` 'buyer_master_agreement' | 'standard_licence_terms' | 'publisher_agreement'
- `version` string
- `view` 'mine'
- `order_id` string, uuid
- `publisher_id` string, uuid

## Response `200`

The document, your list, or the Schedule

## Other responses

- `400`: Unknown `kind`, bad version label, or neither `kind` nor `order_id` + `publisher_id`
- `401`: Missing or invalid credential
- `404`: Not published yet, or no such Schedule for you
- `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)