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

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 with details from the company website. In B2B workspaces, accounts are the primary grouping for contacts and conversations.

object

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

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

code

A machine-readable reason on some refusals, for example ‘key_lock’ when an API key’s brand or workspace restriction does not cover the action.

string

Example

key_lock

missing_scopes

On a 403 for an API key without a scope the endpoint requires: the scopes the key lacks.

Array<string>

Example

[
  "mcp:write"
]

entryId

On a 409 with code duplicate_question or duplicate_rule_text: the knowledge base entry or policy that already holds the question or rule text.

string format: uuid

Example

11223344-5566-4788-99aa-bbccddeeff00

connectionId

On a 422 about one MCP connection a request names, from an assignment or an agent create or update (a connection that does not exist, one listed twice, or one that does not declare a tool named): the connection, as the request named it.

string

undeclaredTools

On the same 422: the tool names the connection does not declare.

Array<string>

Example

[
  "get_orders"
]

declaredTools

On the same 422: the tools the connection declares.

Array<string>

Example

[
  "get_order",
  "search_orders"
]