Clarify API
Record Attachments

List record attachments

Returns the attachments on a record, both user uploads and files extracted from emails. Omit `page` to return all attachments.

GET
/workspaces/{workspace}/objects/{object}/records/{id}/attachments
Authorization<token>

API key authentication. Send your key in the Authorization header as: api-key <your-api-key>.

In: header

Path Parameters

workspace*string

The workspace slug — the {slug} segment of your Clarify workspace URL.

object*string

The object type: a built-in entity (person, company, deal, …) or a custom object (c_*).

id*string

The unique ID of the record.

Query Parameters

page?

Offset pagination, e.g. page[offset]=0&page[limit]=100. Omit to return all attachments.

Response Body

application/json

curl -X GET "https://example.com/workspaces/string/objects/string/records/string/attachments"
{
  "links": {
    "next": null,
    "prev": null
  },
  "meta": {
    "total_records": 1,
    "total_pages": 1
  },
  "data": [
    {
      "_id": "3b9f5c7d-6e2a-4f8b-9d1c-0a7e5b3f9d24",
      "name": "proposal.pdf",
      "_created_at": "2026-01-15T09:30:00.000Z",
      "_created_by": null,
      "source": "user",
      "mime_type": "application/pdf",
      "size_bytes": 482133
    }
  ]
}