Allo

Get deal

Returns a single deal by ID.

GET/v2/api/crm/deals/{id}

Response fields

FieldDescription
valueMonetary value of the deal
currencyISO 4217 currency code
close_dateClose date (null if not set)
companyAssociated company (id + name), null if not linked
personLinked person (id + name + last_name), null if no person is linked via integration data

Authorization

Authorizationstring · headerrequired

Api-Key ak_live_…

Path parameters

idstringrequired

Deal ID (e.g., "dea-def456")

Responses

200Deal details
dataobject

A deal in the CRM

9 fields
idstring

Unique deal identifier

namestring

Deal name

statusstring | null

Current deal status

amountnumber | null

Deal monetary value

currencystring | null

Three-letter ISO 4217 currency code

closed_atstring<date-time> | null

When the deal was closed (ISO 8601)

companyobject | null

Embedded company reference

2 fields
idstring

Company ID

namestring

Company name

created_atstring<date-time>

When the deal was created

updated_atstring<date-time>

When the deal was last updated

401
404
429