---
title: "POST /v1/search"
method: POST
path: "/v1/search"
tags: ["Search"]
---

# POST /v1/search

`POST /v1/search`

Search for business entities across one or multiple jurisdictions. Returns matching entities with confidence scores. Charges 2 credits per jurisdiction searched. Use the jurisdiction parameter to search a specific jurisdiction, or omit it to search all active jurisdictions. Supports pagination via limit and offset. Search is available in every active jurisdiction regardless of verification tier.

## Request body

- object
  - `entity_name` string, required — The business name to search for, e.g. "Acme"
  - `jurisdiction` string — Optional jurisdiction code to search. Omit to search all active jurisdictions.
  - `entity_type` 'llc' | 'corporation' | 'lp' | 'llp' | 'sole_proprietorship' | 'nonprofit' | 'general_partnership' | 'other' — Optional entity type filter to narrow results
  - `limit` integer — Maximum number of results to return (default 50, max 200)
  - `offset` integer — Number of results to skip for pagination

## Response `200`

Default Response

- object
  - `results` unknown[], required — Array of matching business entities with confidence scores
    - unknown
  - `total` number, required — Total number of matching results across all searched jurisdictions
  - `limit` number, required — The limit that was applied
  - `offset` number, required — The offset that was applied
  - `jurisdictions_searched` string[], required — List of jurisdiction codes that were searched
  - `jurisdictions_failed` string[], required — Subset of jurisdictions_searched that could not be completed (credits refunded for these)
  - `credits_charged` number, required — Net credits deducted after partial refunds for failed jurisdictions

## Other responses

- `400` — Default Response

---

[API](https://skmtc.net/bizverify/apis/bizverify-api.md) · [All operations](https://skmtc.net/bizverify/apis/bizverify-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bizverify/bizverify-api/versions/47b91ca07384/schema)