FurniOpsDocs
API referenceExports

List exports

The caller's mode's exports, newest first, paginated with cursors. Files are listed by GET /v1/exports/{id} only.

  • Scopesexports:read
  • Rate classread
GET/v1/exports

The caller's mode's exports, newest first, paginated with cursors. Files are listed by GET /v1/exports/{id} only.

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/exports"
{  "object": "list",  "data": [    {      "id": "string",      "object": "export",      "kind": "products",      "status": "pending",      "livemode": true,      "filters": {        "updated_since": "2019-08-24T14:15:22Z"      },      "rows": 0,      "files": [        {          "url": "http://example.com",          "dataset": "string",          "rows": 0,          "bytes": 0        }      ],      "error": "string",      "created_at": "2019-08-24T14:15:22Z",      "completed_at": "2019-08-24T14:15:22Z",      "expires_at": "2019-08-24T14:15:22Z"    }  ],  "has_more": true,  "next_cursor": "string"}

Get an export GET

An export and, once it has succeeded, its files: each with a download link valid 15 minutes from this read. Read it again for fresh links; the files are kept 7 days.

Create a webhook endpoint POST

Starts pushing the chosen public events to the URL, signed with Standard Webhooks `v1` (`webhook-id`, `webhook-timestamp`, `webhook-signature`). The answer carries the signing secret once. Live-mode endpoints need HTTPS; URLs that resolve to private addresses are refused (422). An organisation has at most 20 endpoints.