FurniOpsDocs
API referenceVendor directory

Read a vendor profile

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

  • Scopesproducts:read
  • Rate classread
GET/v1/vendor-profiles/{id}

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

Authorization

apiKey
AuthorizationBearer <token>

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

In: header

Path Parameters

id*string

Vendor profile (a brand on FurniOps and its catalogue) ID

Match^vnd_[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/vendor-profiles/string"
{  "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"}

List the organisation's acceptances GET

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

Search the vendor directory GET

Brands on FurniOps, by name: every vendor profile with its website domain, whether the brand verified it, and its catalogue's ID (the `catalogue` products carry). Search by part of a name (`q`, spelling-tolerant) or by website domain. No profile names the organisation that holds it.