FurniOpsDocs
API referenceBrand

List the organisation's claims

Every claim the organisation filed, newest first, with its evidence and outcome.

  • Scopesbrand:read
  • Rate classread
GET/v1/brand/claims

Every claim the organisation filed, newest first, with its evidence and outcome.

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/brand/claims"
{  "object": "list",  "data": [    {      "object": "vendor_claim",      "id": "string",      "kind": "listed",      "profile": {        "object": "vendor_profile",        "id": "string",        "name": "string",        "slug": "string",        "brands": [          "string"        ],        "website_domain": "string",        "status": "unclaimed",        "verified": true,        "verified_at": "2019-08-24T14:15:22Z",        "catalogue": "string",        "created_at": "2019-08-24T14:15:22Z"      },      "status": "pending",      "evidence": [        {          "kind": "dns",          "strength": "strong",          "domain": "string",          "org_domain": "string",          "verified_at": "2019-08-24T14:15:22Z",          "last_checked_at": "2019-08-24T14:15:22Z",          "captured_at": "2019-08-24T14:15:22Z"        }      ],      "strength": "strong",      "note": "string",      "message": "string",      "filed_by": "string",      "created_at": "2019-08-24T14:15:22Z",      "checked_at": "2019-08-24T14:15:22Z",      "decided_at": "2019-08-24T14:15:22Z"    }  ],  "has_more": true,  "next_cursor": "string"}

Read the organisation's brand GET

The vendor profile the organisation holds, whether it can still be edited (only while unverified), and its pending claim. Every vendor organisation holds exactly one. Vendors only.

Read an invitation to claim a brand POST

Reads the invitation behind a code FurniOps mailed: the profile, the address invited, when it expires, and whether the signed-in member can accept it (their verified address must be the one invited). A code that is unknown, used, revoked or expired answers 404. The code travels in the body so it never lands in a URL log.