API documentation

GET/v1/vendors

List vendors

Paginated, filterable list of vendors.

Request

curl -X GET https://api.tiptop.ch/v1/vendors \
  -H "Authorization: Bearer $TIPTOP_API_KEY" \
  -H "Content-Type: application/json"

Response · 200 OK

{
  "data": [
    {
      "id": "v-1",
      "name": "Helvetica BuildTech AG",
      "vqi": 84,
      "status": "Verified"
    }
  ],
  "page": 1,
  "total": 230
}

Errors

Code	Meaning
400	Bad request — invalid parameters
401	Unauthorized — missing/invalid token
403	Forbidden — insufficient role
404	Not found — resource does not exist
429	Rate limited — slow down
500	Server error — try again