Skip to main content
GET
Search Business Profiles

Authorizations

Authorization
string
header
required

Append a colon to your API key, Base64-encode it, and put it in the header. Enter the API key as the username and leave the password empty.

Query Parameters

keyword
string
required

Search keyword. Matches the business name, former business name, English business name, representative name, three or more initial consonants of the business name, or a ten-digit business registration number. Enter 100 characters or fewer after trimming, with at least 2 characters once spaces and symbols are removed. A number search returns that one business.

limit
integer
default:20

Number of results per call. One call deducts at most limit × 9 points.

Required range: 1 <= x <= 50
cursor
string

The nextCursor of the previous response. Send it back unchanged. A cursor is bound to the keyword, excludeStatuses, and key mode (test or live) it was issued for. If you change the conditions or the key mode, search again from the start without a cursor.

excludeStatuses
enum<string>[]

Registration states to exclude from the results, separated by commas. The API removes businesses confirmed as suspended or closed and keeps businesses whose state Bolta has not checked.

Minimum array length: 1
Available options:
SUSPENDED,
CLOSED

Response

Search succeeded. When nothing matches, items is an empty array and the API deducts no points.

Business profile search results

items
object[]
required

Search results, most relevant first.

nextCursor
string | null
required

Cursor for the next results. null on the last page.

hasMore
boolean
required

true when more results exist.