Vendors

GET /vendors

Every vendor of the organization, those synced from an ads platform included. A list, one page at a time.

Vendors' email is never returned.

Keys: every key.

Parameters

Parameter	Type	Description
limit	integer	Vendors per page, from 1 to 200. 50 by default.
cursor	string	The next_cursor of the previous page.

Response

A list: data holds the vendors, next_cursor points to the next page.

Field	Type	Description
id	string	The vendor's id. The same id as vendor_id in expenses.
name	string
type	string	agency, freelance, tools, media-platform or other.
sub_type	string	A finer type. May be null.
website	string	May be null.
country	string	May be null.
notes	string	May be null.
integration_source	string	The ads platform the vendor is synced from: google-ads, linkedin-ads or meta-ads. null for a vendor added by hand.

Example

curl https://app.spendbaker.com/sb_back/api/v1/vendors \
  -H "Authorization: Bearer $SPENDBAKER_KEY"

{
  "data": [
    {
      "id": "9a3d6f12-7e4b-4c85-b1a0-6f2e9d7c3b58",
      "name": "Northwind Media",
      "type": "agency",
      "sub_type": null,
      "website": "https://northwind.example",
      "country": "FR",
      "notes": null,
      "integration_source": null
    },
    {
      "id": "1c7e2b94-5d3a-4f81-a6e0-8b9c4d2f7a15",
      "name": "Google Ads",
      "type": "media-platform",
      "sub_type": null,
      "website": null,
      "country": null,
      "notes": null,
      "integration_source": "google-ads"
    }
  ],
  "next_cursor": null
}

Errors

400 invalid_limit, 400 invalid_cursor, 401, 429 and 500, as in Errors and limits.