Skip to main content
GET
/
external
/
v1
/
applications
List Applications
curl --request GET \
  --url https://api.example.com/external/v1/applications/

​
List Applications

Retrieve applications with optional filtering by hiring flow, stage, status, and date range.

​
Endpoint

GET /external/v1/applications/

​
Authentication

Requires API key authentication via Bearer token.

​
Query Parameters

ParameterTypeRequiredDescription
hiring_flow_idstring (UUID)NoFilter by hiring flow
stage_idstring (UUID)NoFilter by current stage
statusstringNoFilter by status (NEW, IN_PROGRESS, COMPLETED, REJECTED)
created_afterstring (ISO 8601)NoApplications created after this date
created_beforestring (ISO 8601)NoApplications created before this date
emailstringNoFilter by candidate email
pageintegerNoPage number (default: 1)
page_sizeintegerNoResults per page (default: 25, max: 100)

​
Example Request

curl -X GET "https://your-instance.firstwork.com/external/v1/applications/?hiring_flow_id=550e8400-e29b-41d4-a716-446655440000&status=IN_PROGRESS&page=1&page_size=50" \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Example Response

{
  "status": "success",
  "data": {
    "count": 142,
    "next": "/external/v1/applications/?page=2&page_size=50",
    "previous": null,
    "results": [
      {
        "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
        "candidate": {
          "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
          "email": "john.doe@example.com",
          "first_name": "John",
          "last_name": "Doe"
        },
        "hiring_flow": {
          "id": "550e8400-e29b-41d4-a716-446655440000",
          "name": "Software Engineer"
        },
        "current_stage": {
          "id": "stage-uuid",
          "name": "Technical Interview"
        },
        "status": "IN_PROGRESS",
        "created_at": "2025-01-15T10:30:00Z",
        "updated_at": "2025-01-18T14:22:00Z"
      }
    ]
  }
}

​
V2 Endpoint

The v2 endpoint provides enhanced filtering and response format: 
GET /external/v2/applications/
V2 improvements:
  • Additional filter parameters
  • Expanded response data
  • Better performance for large result sets