Search accounts

GET

/api/accounts

• Production

Searches accounts by company name. Returns all matching accounts. If no search query is provided, returns all accounts in the tenant.

Authorizations

• bearerAuth

Parameters

Query Parameters

q

string

Search query to match against account names. Case-insensitive partial matching.

Example

Example Company

Responses

200

Accounts matching the search query. Returns an empty array if no matches are found.

List of accounts matching the search criteria.

Array<object>

An account represents a company or organization that your contacts belong to. Accounts are automatically created based on email domain analysis and enriched with details from the company website. In B2B workspaces, accounts are the primary grouping for contacts and conversations.

object

id

required

Unique identifier for the account.

string format: uuid

Example

ac1a2b3c-5678-9abc-def0-1234567890ab

tenantId

required

The tenant this account belongs to.

string format: uuid

Example

a0b1c2d3-4567-89ab-cdef-0123456789ab

name

required

Company or organization name.

string

Example

Example Company

resolutionStatus

required

How the account was identified and resolved.

string

Allowed values: unresolved crm_resolved domain_inferred manually_resolved vies_resolved

Example

domain_inferred

externalRef

External CRM identifier, set when the account is matched against a CRM system.

string | null

Example

CRM-ACCOUNT-12345

emailDomain

Primary email domain for the company. Used for automatic contact-to-account linking. Freemail domains (gmail.com, etc.) are excluded.

string | null

Example

example.com

vatNumber

EU VAT identification number, if detected or provided.

string | null

vatValid

Whether the VAT number was confirmed valid for this account. Null when no confirmation is on record.

boolean | null

country

ISO 3166-1 alpha-2 country code for the account.

string | null

Example

DE

phone

Company phone number.

string | null

website

Company website URL.

string | null

companyType

Company type, when known.

string | null

Example

Industrial Machinery Manufacturing

description

AI-generated company description based on website content and available data.

string | null

Example

Manufacturer of CNC machines and industrial automation equipment, serving the European market since 1985.

address

Registered business address, typically sourced from your connected CRM.

object

street

Street address.

string

city

City name.

string

postalCode

Postal or ZIP code.

string

country

Country name or ISO code.

string

createdAt

required

Timestamp when the account was created.

string format: date-time

Example

2026-02-01T08:00:00.000Z

updatedAt

required

Timestamp when the account was last updated.

string format: date-time

Example

2026-03-20T14:15:00.000Z