Retrieve paginated list of ATS attachment files | Deel

{
  "data": [
    {
      "id": "e9586b57-a4f9-40d5-ac8f-a6f2b688557e",
      "file_name": "OCRU0ZEHD0",
      "file_content_type": "7IZJYL457S",
      "attachable_type_slug": "CANDIDATE",
      "attachment_type_slug": "CV",
      "url": "https://example.com/MQZGU5U53Y",
      "ai_summary": "MBNNQV3FU6",
      "created_at": "2025-05-19T21:31:53.517Z",
      "updated_at": "2025-05-19T21:33:27.939Z",
      "attachable_id": "e9586b57-a4f9-40d5-ac8f-a6f2b688557e",
      "created_by_hris_organization_user_id": "e9586b57-a4f9-40d5-ac8f-a6f2b688557e"
    }
  ],
  "has_more": false,
  "next_cursor": "string",
  "total_count": 1
}

Retrieves attachment files (such as resumes, cover letters, or offer letters) associated with a specific ATS entity. Scope results by the entity type (candidate, job, note, etc.), its ID, and the attachment type.

Token scopes: ats:read, worker:read

Authentication

AuthorizationBearer

Authentication

The Deel API uses bearer tokens to authenticate requests. All API calls must be made over HTTPS — calls over plain HTTP or without authentication will fail.

$ curl -X GET 'https://api.deel.training/rest/v2/contracts' \
>   -H 'Authorization: Bearer YOUR-TOKEN-HERE'

Learn more about authentication

## Authentication The Deel API uses bearer tokens to authenticate requests. All API calls must be made over HTTPS — calls over plain HTTP or without authentication will fail. ```curl curl -X GET 'https://api.deel.training/rest/v2/contracts' \ -H 'Authorization: Bearer YOUR-TOKEN-HERE' ``` [Learn more about authentication](/api/authentication)

AuthorizationBearer

Standard OAuth2 security scheme based on https://swagger.io/docs/specification/authentication/

Path parameters

attachable_type_slugenumRequired

Type of the attachable entity

attachable_idstringRequiredformat: "uuid"

Unique identifier for the attachable entity

attachment_type_slugenumRequired

Type of the attachment

Allowed values:

Query parameters

cursorstringOptional<=1000 characters

The cursor for pagination

limitintegerOptional1-100Defaults to 20

Maximum number of records returned in one response

Response

Successful operation.

datalist of objects

Array of attachment objects

has_moreboolean

Indicates if there are more results available

next_cursorstring or null<=1000 characters

Cursor for pagination to fetch next page

total_countdouble

Total count of attachments

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

500

Internal Server Error

$	curl -G https://api.letsdeel.com/rest/ats/attachments/CANDIDATE/e9586b57-a4f9-40d5-ac8f-a6f2b688557e/CV \
>	-H "Authorization: Bearer <token>" \
>	-d cursor=cursorValue \
>	-d limit=50

$	curl -X GET 'https://api.deel.training/rest/v2/contracts' \
>	-H 'Authorization: Bearer YOUR-TOKEN-HERE'