Get Candidate History

GET

GET

https://api.atzcrm.com/v1/candidate/:slug/history

Retrieve the talent stage history of a candidate across jobs. Optionally filter by a specific job using the job_slug query parameter.

Request

Path Parameter

• slugstring

  The unique slug of the candidate (required). Example: candidate_2f0ea5cd69a6cd6c7163

Query Parameter

• job_slugstring

  Filter history by a specific job slug. Example: job_a1b2c3d4e5f6a7b8c9d0

Headers

• Authorization: Bearer your_access_token
• Content-Type: application/json

Response

200

Body

• job_slugstring

  Example: job_a1b2c3d4e5f6a7b8c9d0

• job_namestring

  Example: Software Engineer

• organizationobject

  Example:
  "slug": "organization_1a2b3c4d5e6f7a8b9c0d",
  "name": "Acme Corp"

• job_statusobject

  Example:
  "id": 1,
  "name": "In Progress"

• talent_stageobject

  Example:
  "id": 2,
  "name": "Assigned"

• stage_datestring

  Format: YYYY-MM-DD. Example: 2024-06-15

• visibilityinteger

  1 = Visible, 0 = Hidden. Example: 1

• commentstring or null

  Example: Moved to next round

• updated_byobject

  Example:
  "id": 1,
  "email": "john@example.com",
  "first_name": "John",
  "last_name": "Doe",
  "full_name": "John Doe",
  "role": "Admin",
  "phone": "+11234567890"

• updated_atstring (ISO 8601)

  Example: 2024-06-15T10:00:00Z

400

Body

• Unprocessable Entity

401

Body

• Unauthorized

Response Example

[
    {
        "job_slug": "job_a1b2c3d4e5f6a7b8c9d0",
        "job_name": "Software Engineer",
        "organization": {
            "slug": "organization_1a2b3c4d5e6f7a8b9c0d",
            "name": "Acme Corp"
        },
        "job_status": {
            "id": 1,
            "name": "In Progress"
        },
        "talent_stage": {
            "id": 3,
            "name": "Interview"
        },
        "stage_date": "2024-06-15",
        "visibility": 1,
        "comment": "Moved to interview round",
        "updated_by": {
            "id": 1,
            "email": "john.doe@example.com",
            "first_name": "John",
            "last_name": "Doe",
            "full_name": "John Doe",
            "role": "Admin",
            "phone": "+11234567890"
        },
        "updated_at": "2024-06-15T10:00:00.000Z"
    },
    {
        "job_slug": "job_b2c3d4e5f6a7b8c9d0e1",
        "job_name": "Product Manager",
        "organization": {
            "slug": "organization_2b3c4d5e6f7a8b9c0d1e",
            "name": "Beta Solutions"
        },
        "job_status": {
            "id": 2,
            "name": "Won"
        },
        "talent_stage": {
            "id": 2,
            "name": "Assigned"
        },
        "stage_date": "2024-06-12",
        "visibility": 1,
        "comment": null,
        "updated_by": {
            "id": 2,
            "email": "jane.smith@example.com",
            "first_name": "Jane",
            "last_name": "Smith",
            "full_name": "Jane Smith",
            "role": "Recruiter",
            "phone": "+19876543210"
        },
        "updated_at": "2024-06-12T14:00:00.000Z"
    },
    {
        "job_slug": "job_a1b2c3d4e5f6a7b8c9d0",
        "job_name": "Software Engineer",
        "organization": {
            "slug": "organization_1a2b3c4d5e6f7a8b9c0d",
            "name": "Acme Corp"
        },
        "job_status": {
            "id": 1,
            "name": "In Progress"
        },
        "talent_stage": {
            "id": 1,
            "name": "External Candidates"
        },
        "stage_date": "2024-06-10",
        "visibility": 0,
        "comment": null,
        "updated_by": {
            "id": 1,
            "email": "john.doe@example.com",
            "first_name": "John",
            "last_name": "Doe",
            "full_name": "John Doe",
            "role": "Admin",
            "phone": "+11234567890"
        },
        "updated_at": "2024-06-10T09:00:00.000Z"
    }
]