v1

latestOpenAPI 3.1.12026-07-26104175.5 KB
Buyer
External MCP
External API

Search Buyers

Search for buyer institutions — cities, counties, school districts, higher-education institutions, police and fire departments, federal agencies, and other public-sector entities — by name. Returns a list of candidates; pick the single buyer that best fits the user's intent based on name, type, and location, then use its id (the buyer ID) for downstream tools. If the user mentions a state or province, pass buyerStateCode as the matching StateMapping enum name (the server resolves it to the corresponding ISO 3166-2 code).

get/api/external/buyer/quick/search

Query parameters

buyerNamestring required

Buyer name to search Buyer entity by.

buyerStateCodestring

StateMapping enum value for the buyer's ISO 3166-2 state code. Optional.

limitstring

Maximum number of buyers to return. Defaults to 10.

Response

Matching buyers ordered by relevance.