---
title: "Your licensed article feed"
method: GET
path: "/enterprise-license"
tags: ["Receive content"]
---

# Your licensed article feed

`GET /enterprise-license`

## Request

- Base URL: `https://api.opedd.com`
- URL: `https://api.opedd.com/enterprise-license`
- Auth: none required

The articles your order covers. Send the order's access key in the `X-Enterprise-Key` header (preferred: it stays out of logs) or as `access_key`, or your live buyer API key (`Authorization: Bearer opedd_buyer_live_…`) with `order_id`: one key for search, articles and the feed. With a buyer API key and no `order_id`, an account holding one active order gets it, and one holding several gets `400 ORDER_ID_REQUIRED` listing them. Test keys get `403 TEST_KEY_NOT_ALLOWED`. JSON up to 200 per page (default 50), or `format=ndjson` for bulk export, up to 1,000 per request (default 1,000; see the [bulk export contract](/bulk-export-contract)). Without `since` the feed is newest first. `since` returns only articles published after a time, oldest first; `next_cursor` continues forward. Follow the cursor until it is `null`.

Each row's `content_access` says how to get the text:

- `included`: the full text is in `content_body` (AI training and Full catalogue orders).
- `retrieval_per_article`: the feed lists the article; fetch the text one article at a time with `GET /content-delivery` (AI answers monthly, Client display).
- `search_only`: no text; read the content by asking questions with `POST /search`, billed per answer at `retrieval_price_cents` (per-request orders). `GET /content-delivery` answers `403 SEARCH_ONLY_LICENCE`.

A monthly order covers articles published from the start of the order; `_meta.withheld_outside_window` on a bulk export counts the older ones left out.

## Query parameters

- `access_key` string
- `order_id` string, uuid
- `cursor` string
- `limit` integer
- `since` string, date-time
- `format` 'json' | 'ndjson'

## Headers

- `X-Enterprise-Key` string

## Response `200`

Paginated article feed with content. Format dispatched per `?format` param.

## Other responses

- `400`: Unsupported `format`, or an invalid `since` or cursor
- `401`: Missing or invalid access key
- `403`: The order is not active yet, or has expired
- `429`: Too many requests (360 per minute)
- `503`: The audit record or the licence check could not run, so nothing was returned. Retry.

---

[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)
