Get a deal

curl --request GET \
  --url https://api.hubapi.com/deals/v1/deal/{dealId}

{
  "portalId": 123,
  "dealId": 123,
  "isDeleted": true,
  "associations": {},
  "properties": {}
}

GET

deals

deal

{dealId}

Get a deal

curl --request GET \
  --url https://api.hubapi.com/deals/v1/deal/{dealId}

{
  "portalId": 123,
  "dealId": 123,
  "isDeleted": true,
  "associations": {},
  "properties": {}
}

Scope requirements

Path Parameters

dealId

string

required

Unique identifier for a particular deal.

Query Parameters

includePropertyVersions

boolean

By default, you will only get data for the most recent version of a property in the "versions" data. If you include this parameter, you will get data for all previous versions.

Response

200 - application/json

Successful response - Deal information retrieved successfully

portalId

integer

dealId

integer

isDeleted

boolean

associations

object

properties

object

Last modified on March 20, 2026

⌘I