FurniOpsDocs
API referenceCatalogue

List publication runs

The catalogue's publication runs, newest first: its publishing history.

  • Scopespublishing:read
  • Rate classread
GET/v1/catalogue/publication-runs

The catalogue's publication runs, newest first: its publishing history.

Authorization

apiKey
AuthorizationBearer <token>

An API key (fo_live_… / fo_test_…) as a bearer token

In: header

Query Parameters

limit?integer

Page size

Range1 <= value <= 100
Default20
starting_after?string

Opaque position returned by a previous page

Match^[A-Za-z0-9_-]{1,512}$
ending_before?string

Opaque position returned by a previous page

Match^[A-Za-z0-9_-]{1,512}$

Header Parameters

FurniOps-Version?string

Dated API version; pinned per organisation on first use and overridable per request

Value in

  • "2026-10-01"
  • "2026-10-04"
FurniOps-Mode?string

The data the request acts on: test is the organisation's sandbox. An OAuth token picks it (live by default); an API key's mode is fixed, and naming the other one is refused

Value in

  • "live"
  • "test"
If-None-Match?string

ETag of a cached representation; a match returns 304

Response Body

application/json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

curl -X GET "https://example.com/v1/catalogue/publication-runs"
{  "object": "list",  "data": [    {      "object": "publication_run",      "id": "string",      "action": "publish",      "status": "queued",      "products": {        "total": 0,        "done": 0      },      "reason": "string",      "error": "string",      "created_at": "2019-08-24T14:15:22Z",      "finished_at": "2019-08-24T14:15:22Z"    }  ],  "has_more": true,  "next_cursor": "string"}

List the catalogue's variants with price levels and stock GET

The own catalogue's variants by ID, each with its price levels (wholesale, MAP, MSRP), its availability and what looks wrong with them, narrowed by every filter given. The network's rows are never listed here.

Publish the catalogue to the network POST

Starts a run that makes every product of the vendor's catalogue that is not hidden visible to the network of paying retailers, each announced as `product.published`. Needs the data agreement (409 `agreement_required`) and a verified vendor profile (409 `brand_unverified`). A catalogue already published, a run under way, or a test-mode sandbox answers 409; a retailer's catalogue answers 403.