FurniOpsDocs
API referenceBrand

Read a claim

One of the organisation's claims, with its evidence and, once decided, the outcome.

  • Scopesbrand:read
  • Rate classread
GET/v1/brand/claims/{id}

One of the organisation's claims, with its evidence and, once decided, the outcome.

Authorization

apiKey
AuthorizationBearer <token>

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

In: header

Path Parameters

id*string

Vendor claim (an organisation's claim to speak for a brand) ID

Match^vcl_[0-9A-Za-z]{22}$

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

application/problem+json

curl -X GET "https://example.com/v1/brand/claims/string"
{  "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"}

Claim a brand POST

Asks FurniOps to let the organisation speak for a brand: a listed profile (`profile`), whose catalogue then moves to the organisation without copying anything, or its own profile, which then becomes verified. FurniOps gathers the evidence on the profile's website domain at once: a domain the organisation verified by DNS (strongest) and members whose verified address is at the domain. An invitation from FurniOps and a trademark registration add to it. Staff decide every claim, after re-checking the evidence. One claim may be pending at a time (409 otherwise), and a listed profile can be claimed only while the organisation's own catalogue is empty (409). Owners and admins only; never an API key or an AI agent.

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.