GET
/
v2
/
objects
/
deals
/
records
/
{record_id}
/
attributes
/
{attribute}
/
values
curl --request GET \
  --url https://api.attio.com/v2/objects/deals/records/{record_id}/attributes/{attribute}/values \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "active_from": "2023-01-01T15:00:00.000000000Z",
      "active_until": null,
      "created_by_actor": {
        "type": "system",
        "id": null
      },
      "target_object": "people",
      "target_record_id": "891dcbfc-9141-415d-9b2a-2238a6cc012d",
      "attribute_type": "record-reference"
    }
  ]
}

Authorizations

​
Authorization
string
header
required

This API uses OAuth 2.0 with the authorization code grant flow.

Path Parameters

​
record_id
string
required

A UUID of the deal record to fetch attribute values for.

Example:

"1eec4535-30a1-4bc0-be24-e255d3fb5ac5"

​
attribute
string
required

A UUID or slug to identify the attribute you want to query values on.

Example:

"owner"

Query Parameters

​
show_historic
boolean
default:false

If true, the endpoint will return all historic values for the attribute. If false, the endpoint will only return the currently active value(s). Defaults to false. Cannot be set to true for COMINT attributes or enriched attributes on people/company objects.

Example:

true

​
limit
integer

The maximum number of results to return. See the full guide to pagination here.

Example:

10

​
offset
integer

The number of results to skip over before returning. See the full guide to pagination here.

Example:

5

Response

200
application/json

Success

GET
/
v2
/
objects
/
deals
/
records
/
{record_id}
/
attributes
/
{attribute}
/
values
curl --request GET \
  --url https://api.attio.com/v2/objects/deals/records/{record_id}/attributes/{attribute}/values \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "active_from": "2023-01-01T15:00:00.000000000Z",
      "active_until": null,
      "created_by_actor": {
        "type": "system",
        "id": null
      },
      "target_object": "people",
      "target_record_id": "891dcbfc-9141-415d-9b2a-2238a6cc012d",
      "attribute_type": "record-reference"
    }
  ]
}

Authorizations

​
Authorization
string
header
required

This API uses OAuth 2.0 with the authorization code grant flow.

Path Parameters

​
record_id
string
required

A UUID of the deal record to fetch attribute values for.

Example:

"1eec4535-30a1-4bc0-be24-e255d3fb5ac5"

​
attribute
string
required

A UUID or slug to identify the attribute you want to query values on.

Example:

"owner"

Query Parameters

​
show_historic
boolean
default:false

If true, the endpoint will return all historic values for the attribute. If false, the endpoint will only return the currently active value(s). Defaults to false. Cannot be set to true for COMINT attributes or enriched attributes on people/company objects.

Example:

true

​
limit
integer

The maximum number of results to return. See the full guide to pagination here.

Example:

10

​
offset
integer

The number of results to skip over before returning. See the full guide to pagination here.

Example:

5

Response

200
application/json

Success