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

Mueller Maschinenbau

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 via VIES VAT validation and website scraping. 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

Mueller Maschinenbau GmbH

resolutionStatus

required

How the account was identified and resolved.

string

Allowed values: unresolved crm_resolved registry_resolved domain_inferred manually_resolved vies_resolved

Example

vies_resolved

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

mueller-maschinenbau.de

vatNumber

EU VAT identification number, if detected or provided.

string | null

Example

DE123456789

vatValid

Whether the VAT number was validated against the EU VIES system. Null if not checked.

boolean | null

Example

true

country

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

string | null

Example

DE

phone

Company phone number.

string | null

Example

+49897654321

website

Company website URL.

string | null

Example

https://mueller-maschinenbau.de

companyType

Industry or company type, extracted from the website or CRM data during enrichment.

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 VIES or CRM data.

object

street

Street address.

string

Example

Industriestrasse 42

city

City name.

string

Example

Munich

postalCode

Postal or ZIP code.

string

Example

80331

country

Country name or ISO code.

string

Example

DE

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