Search Businesses
Search published Businesses by name, US state/city, NAICS sector/code, website URL, or status. A name is optional and supplied filters combine with AND. Location filters match the same published primary location, not necessarily headquarters. Missing, private, or unpublished facts do not match. Results are not a complete census of businesses in a place. Keep filters unchanged when following a cursor, including after an empty page with has_more=true. This read-only route never adds a Business to a Workspace. Send either query or name, never both. naics_vintage requires naics_code. Cross-parameter validation uses x-smb-query-schema; OpenAPI 3.1 parameter schemas alone cannot enforce these rules. Invalid combinations return 400 validation_error.
Query Parameters
Business name text. Do not send both query and name.
^\s*\S[\s\S]+\S\s*$3 <= length <= 200Alias for query. Do not send both query and name.
^\s*\S[\s\S]+\S\s*$3 <= length <= 200Value in
- "active"
- "closed"
- "inactive"
- "unknown"
Two-letter US state code or DC, such as IN. Matches the published primary location, not necessarily headquarters. Case-insensitive; territories are not supported.
^(?:[Aa][Ll]|[Aa][Kk]|[Aa][Zz]|[Aa][Rr]|[Cc][Aa]|[Cc][Oo]|[Cc][Tt]|[Dd][Ee]|[Dd][Cc]|[Ff][Ll]|[Gg][Aa]|[Hh][Ii]|[Ii][Dd]|[Ii][Ll]|[Ii][Nn]|[Ii][Aa]|[Kk][Ss]|[Kk][Yy]|[Ll][Aa]|[Mm][Ee]|[Mm][Dd]|[Mm][Aa]|[Mm][Ii]|[Mm][Nn]|[Mm][Ss]|[Mm][Oo]|[Mm][Tt]|[Nn][Ee]|[Nn][Vv]|[Nn][Hh]|[Nn][Jj]|[Nn][Mm]|[Nn][Yy]|[Nn][Cc]|[Nn][Dd]|[Oo][Hh]|[Oo][Kk]|[Oo][Rr]|[Pp][Aa]|[Rr][Ii]|[Ss][Cc]|[Ss][Dd]|[Tt][Nn]|[Tt][Xx]|[Uu][Tt]|[Vv][Tt]|[Vv][Aa]|[Ww][Aa]|[Ww][Vv]|[Ww][Ii]|[Ww][Yy])$Exact city name at the published US primary location, ignoring case and surrounding whitespace. Combine with state to disambiguate.
1 <= length <= 200Published primary NAICS code or 2-5 digit prefix. Six digits match exactly. Also accepts the combined sectors 31-33, 44-45, and 48-49. Unknown or unpublished classifications do not match.
^(?:[0-9]{2,6}|31-33|44-45|48-49)$US NAICS edition. Requires naics_code; defaults to 2022 when omitted. Codes are not translated between editions.
Value in
- "1997"
- "2002"
- "2007"
- "2012"
- "2017"
- "2022"
Exact published HTTP(S) website URL after trimming surrounding whitespace. Scheme, path, case, and trailing slash must match; this is not a domain or substring search.
^https?://[^\s]+$8 <= length <= 2048Cursor returned by the previous page.
^biz_[0-7][0-9A-HJKMNP-TV-Z]{25}$1 <= value <= 10020Repeat or comma-separate public Business field names.
Response Body
application/json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
curl -X GET "https://example.com/v1/businesses"{ "as_of": "2019-08-24T14:15:22Z", "data": [ { "city": "string", "closed_on": "2019-08-24", "country_code": "US", "description": "string", "founded_on": "2019-08-24", "id": "string", "naics_code": "string", "naics_title": "string", "naics_vintage": "1997", "name": "string", "primary_classification_id": "string", "primary_location_id": "string", "public_email": "string", "public_phone": "string", "publication_status": "private", "published_at": "2019-08-24T14:15:22Z", "record_type": "business", "state": "string", "status": "active", "website_url": "string" } ], "page": { "cursor": "string", "has_more": true }, "projection": "public", "request_id": "string", "schema_hash": "string", "schema_version": "string"}