FurniOpsDocs
API referenceVendor

List the organisation's acceptances

Every agreement version the organisation accepted, newest first, with who signed and when: its record of what it agreed to.

  • Scopesagreements:read
  • Rate classread
GET/v1/agreement-acceptances

Every agreement version the organisation accepted, newest first, with who signed and when: its record of what it agreed to.

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/agreement-acceptances"
{  "object": "list",  "data": [    {      "object": "agreement_acceptance",      "id": "string",      "agreement": "string",      "kind": "vendor_data",      "version": 1,      "sha256": "string",      "signer": {        "user": "string",        "name": "string",        "title": "string"      },      "authority_confirmed": true,      "method": "click",      "ip": "string",      "user_agent": "string",      "accepted_at": "2019-08-24T14:15:22Z"    }  ],  "has_more": true,  "next_cursor": "string"}

Read the vendor's reach and data health GET

How many paying retailers carry the vendor's products and how often they read them in the last 30 days, with the catalogue's completeness and freshness. Aggregates only, computed by a platform job: a count below its threshold is withheld, and no retailer is ever named.

Read a vendor profile GET

One brand on FurniOps: its name, brands, website domain and verification.