Get account by ID

GET

/api/accounts/{id}

• Production

Retrieves a single account by its unique identifier, including enrichment data such as VAT validation, company description, and registered address.

Authorizations

• bearerAuth

Parameters

Path Parameters

id

required

string format: uuid

The unique identifier of the account to retrieve.

Responses

200

The account was found and returned.

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

404

No account exists with the given ID in the authenticated tenant.

Standard error response returned by all endpoints on failure.

object

error

required

A human-readable error message describing what went wrong.

string

Example

Conversation not found