---
title: "Search Buyers"
method: GET
path: "/api/external/buyer/quick/search"
tags: ["Buyer", "External MCP", "External API"]
---

# Search Buyers

`GET /api/external/buyer/quick/search`

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).

## Query parameters

- `buyerName` string, required
- `buyerStateCode` string
- `limit` string

## Response `200`

Matching buyers ordered by relevance.

- BuyerSearchResponse
  - `buyers` BuyerBrief[], required — Matching buyers (institutions) ordered by search relevance. Pick the single buyer that best fits the user's intent.
    - `id` string, uuid, required
    - `name` string, required
    - `type` 'AdministrativeAgency' | 'City' | 'CityAttorney' | 'CityClerk' | 'CityEngineer' | 'CityManager' | 'CitySecretary' | 'County' | 'CountyAttorney' | 'CountyClerk' | 'CountyEngineer' | 'CountyManager' | 'CulturalFacility' | 'Department' | 'DiplomaticEntity' | 'District' | 'FinancialAgency' | 'HealthcareFacility' | 'HigherEducation' | 'LawEnforcementAgency' | 'LegislativeBody' | 'MilitaryOrganization' | 'NonProfitOrganization' | 'PrivateCompany' | 'PublicWorksAgency' | 'RegulatoryAgency' | 'School' | 'SchoolDistrict' | 'SpecialDistrict' | 'State' | 'StateAgency' | 'StateAttorney' | 'StateClerk' | 'StateEngineer' | 'TransportationAgency' | 'UncategorizedAgency' | 'UncategorizedClerk' | 'UncategorizedDistrict' | 'PoliceDepartment' | 'FireDepartment' | 'Library' | 'IndigenousGovernment' | 'Federal' | 'Other', nullable
    - `countryCode` string, required
    - `stateCode` string, nullable
    - `url` string, nullable
    - `fromSourceFile` boolean, required
    - `tags` string[]
    - `linkedinSlug` string, nullable
    - `logoPath` string, nullable

## Other responses

- `400` — Invalid request body or format
- `401` — Missing or invalid authentication
- `403` — Unauthorized to access resource or perform action
- `404` — Resource not found
- `415` — Unsupported media type or request body format
- `429` — Rate limit exceeded
- `500` — Internal server error

---

[API](https://skmtc.dev/starbridge/apis/starbridge-external-public-api.md) · [All operations](https://skmtc.dev/starbridge/apis/starbridge-external-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/starbridge/starbridge-external-public-api/revisions/dc7faf636b78/schema)