Skip to main content
GET
/
external
/
v1
/
applications
/
{application_id}
/
history
Application History
curl --request GET \
  --url https://api.example.com/external/v1/applications/{application_id}/history/

​
Get Application Transition History

Retrieve the complete history of stage transitions for an application, showing when and why the candidate moved through the pipeline.

​
Endpoint

GET /external/v1/applications/{application_id}/history/

​
Path Parameters

ParameterTypeRequiredDescription
application_idstring (UUID)YesThe application ID

​
Example Request

curl -X GET "https://your-instance.firstwork.com/external/v1/applications/7c9e6679-7425-40de-944b-e07fc1f90ae7/history/" \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Example Response

{
  "status": "success",
  "data": {
    "application_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
    "transitions": [
      {
        "from_stage": null,
        "to_stage": "Application Received",
        "timestamp": "2025-01-15T10:30:00Z",
        "triggered_by": "system",
        "reason": "Application created"
      },
      {
        "from_stage": "Application Received",
        "to_stage": "Phone Screen",
        "timestamp": "2025-01-16T09:15:00Z",
        "triggered_by": "automation",
        "reason": "Auto-advanced: compliance check passed"
      },
      {
        "from_stage": "Phone Screen",
        "to_stage": "Technical Interview",
        "timestamp": "2025-01-18T14:22:00Z",
        "triggered_by": "admin@company.com",
        "reason": "Passed phone screening"
      }
    ]
  }
}

​
Bulk History

Retrieve transition history for multiple applications: 
POST /external/v1/applications/bulk_transition_history/

{
  "application_ids": ["uuid-1", "uuid-2", "uuid-3"]
}