Retrieve ATS application

GET

/ats/applications/:application_id

GET

/rest/ats/applications/:application_id

curl https://api.letsdeel.com/rest/ats/applications/1b9d6c7e-2c3f-4f5a-8b6c-7d8e9f0a1b2c \
     -H "Authorization: Bearer <token>"

{
  "data": {
    "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
    "job": {
      "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
      "title": "Senior Software Engineer"
    },
    "notes": [
      {
        "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
        "created_at": "2024-11-01T10:30:00Z",
        "created_by": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
        "updated_at": "2024-11-15T14:45:00Z",
        "richtext_content": "<p>This candidate has excellent experience in backend development.</p>"
      }
    ],
    "hired_at": "2026-06-01T09:00:00Z",
    "candidate": {
      "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
      "email": "john.doe@example.com",
      "last_name": "Doe",
      "first_name": "John",
      "attachments": [
        {
          "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
          "ai_summary": "Resume shows 7 years of software engineering experience with expertise in full-stack development. Strong background in React, Node.js, and cloud technologies."
        }
      ],
      "phone_number": "+1234567890",
      "candidate_tags": [
        {
          "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
          "tag": {
            "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
            "label": "Experienced"
          }
        }
      ],
      "import_session_id": "import_session_12345",
      "profile_picture_url": "https://example.com/picture.jpg",
      "city": "San Francisco",
      "country_code": "US"
    },
    "job_board": {
      "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
      "type": "INTERNAL_CAREER_PAGE"
    },
    "created_at": "2024-10-15T09:12:00Z",
    "created_by": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
    "numeric_id": 2561,
    "updated_at": "2024-11-20T11:45:00Z",
    "job_posting": {
      "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
      "title": "Job posting"
    },
    "referred_by": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
    "source_slug": "INTERNAL_CAREER_PAGE",
    "archivation_reason": {
      "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
      "label": "Not a culture fit"
    },
    "job_employment_type": {
      "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
      "employment_type": {
        "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
        "name": "Full-time"
      }
    },
    "archivation_reason_id": "9b2d1c1e-7f3a-4c58-9e2b-3f1a2b4c5d6e",
    "job_posting_publication": {
      "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479"
    },
    "referral_form_submission": {
      "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
      "form_builder_stringified": "{\"question_1\": \"answer_1\", \"question_2\": \"answer_2\"}"
    },
    "moved_to_current_stage_at": "2024-11-18T12:30:00Z",
    "job_posting_publication_state": {
      "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
      "state_slug": "PUBLISHED_BASIC"
    },
    "application_job_criterias_matchings": [
      {
        "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
        "is_matched": "MATCHED",
        "description": "The candidate has 5+ years of experience in React and TypeScript",
        "job_criteria": {
          "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
          "title": "Frontend Development Experience",
          "description": "5+ years of experience with React, TypeScript, and modern frontend frameworks"
        }
      }
    ],
    "all_application_interview_plan_stages": [
      {
        "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
        "offers": [
          {
            "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
            "job_title": "Senior Software Engineer",
            "created_at": "2024-11-12T09:00:00Z",
            "start_date": "2025-01-15T00:00:00Z",
            "updated_at": "2024-11-14T11:30:00Z",
            "country_code": "US",
            "attachment_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
            "approval_rule_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
            "worker_type_enum": "DIRECT_EMPLOYEE",
            "offer_status_enum": "SENT",
            "approval_request_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
            "compensation_amount": 120000,
            "rejection_reason_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
            "compensation_currency": "USD",
            "compensation_period_slug": "ANNUALLY",
            "application_interview_plan_stage_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
            "email": {
              "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
              "subject": "Job Offer - Senior Software Engineer",
              "body_html": "<html><body><p>Dear Candidate,</p><p>We are pleased to offer you the position...</p></body></html>",
              "from_string": "recruiter@company.com",
              "recipients_cc": [
                "hiring-manager@company.com"
              ],
              "recipients_to": [
                "candidate@email.com"
              ],
              "recipients_bcc": []
            }
          }
        ],
        "exited_at": "2024-11-18T12:30:00Z",
        "entered_at": "2024-11-10T16:20:00Z",
        "is_current": false,
        "updated_at": "2024-11-10T16:20:00Z",
        "interview_plan_stage": {
          "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
          "name": "Phone Screen",
          "position_number": 2100,
          "default_type_slug": "phone_screen",
          "category_type_slug": "ACTIVE"
        },
        "moved_by_hris_organization_user_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479"
      }
    ],
    "application_automation_rule_executions": [
      {
        "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
        "action_type_enum": "ADD_CANDIDATE_TAG",
        "evaluation_result": [
          {
            "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
            "group_id": 0,
            "operator_enum": "EQUALS",
            "comparison_value": "value",
            "is_condition_met": true,
            "form_builder_question_data_binding_id": "83a642fd-de0a-45f6-8fe0-b9188ed72990"
          }
        ],
        "application_automation_rule_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479"
      }
    ],
    "current_application_interview_plan_stage": {
      "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
      "interview_plan_stage": {
        "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
        "name": "Phone Screen",
        "position_number": 2100,
        "default_type_slug": "phone_screen",
        "category_type_slug": "ACTIVE"
      }
    },
    "submitter_ip_address": "203.0.113.42",
    "submitter_user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/125.0.0.0 Safari/537.36",
    "application_form_submission": {
      "id": "509d5153-5b10-4718-b16f-417e726d39f1",
      "answers": [
        {
          "answer": "John Doe",
          "question_text": "Full Name",
          "question_type": "FREETEXT",
          "data_binding_id": "83a642fd-de0a-45f6-8fe0-b9188ed72990"
        }
      ]
    }
  }
}

Retrieves one ATS application by application_id, including its full interview-stage timeline — when it entered and left each stage and who moved it — not just its current status. Use it to check where a candidate stands or to reconstruct how an application progressed.

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.letsdeel.com/rest/v2/contracts' \
  -H 'Authorization: Bearer YOUR-TOKEN-HERE'

Learn more about authentication

AuthorizationBearer

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

Path parameters

application_idstringRequiredformat: "uuid"

Application ID

Response

Successfully retrieved application

dataobject

Complete application details

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

500

Internal Server Error