Buyers

Search buyers by name

Find public sector buyers by name, optionally narrowed by country or by where they sit in the buyer-type taxonomy. Each result is the full buyer profile — the same shape as GET /v1/buyers/{id}.

get/v1/buyers/search

Request

  • Base URL: https://api.stotles.com
  • URL: https://api.stotles.com/v1/buyers/search
  • Auth: API key in header x-api-key

Query parameters

querystring required

Free-text search over the buyer name (2–200 characters).

country_codestring[]

Filter to buyers in these ISO 3166-1 alpha-2 countries. Repeatable.

typestring[]

Filter to buyers of these types. Repeatable.

type_groupstring[]

Filter to buyers in these type groups — matches any type within a group. Repeatable.

limitinteger

Maximum results per page (1–50, default 20). Ignored when cursor is set.

cursorstring

Opaque pagination cursor from a previous response's next_cursor. Carries the page and page size, so limit is ignored when it is present.

Response

A page of matching buyers.

next_cursorstring nullable required

Opaque cursor for the next page of results; null when this is the last page.

Changes

No recorded changes to this operation across all 1 revision of this API.