Check Application Status

Once an application has been submitted through the Automation Cloud, you can check its status. Applications may vary in the time they take to complete based on factors such as length and complexity.

Using the applicationId, you can query the status of an application, which may be in a processing, success, or failed state.

API Endpoint

To check the status of a submitted application, use the following API endpoint:

GET /applications/<applicationId>

Headers

Name	Type	Required	Description
Authorization	string	✅	See Authentication

Example:

Authorization: Bearer <JWT>

Path Parameters

Parameter	Type	Required	Description
applicationId	string	✅	The Job Post application ID. Example: /applications/<applicationId>

Code Sample

Here’s an example of how to structure the API call to check the application status:

GET /applications/<applicationId>

curl -X GET 'https://api.recruitment.automation.cloud/applications/<applicationId>' \
    -H 'Authorization: Bearer <JWT>' \

Success Responses

Upon a successful request, you will receive a response indicating the status of the application:

Status: processing

{
  "status": "processing"
}

Application is currently in the processing state.

Status: success

{
  "status": "success",
}

Application has been successfully processed.

Status: failed

{
  "status": "failed",
  // example error
  "error": {
    "code": "RetryLimitExceeded",
    "message": "This application has exceeded the maximum number of retries"
  },
  // optional field, example error
  "lastApplicationError": {
    "code": "UnableToContinueProcess",
    "message": "You have already applied to this vacancy"
  }
}

Application has failed to process.

Important Notes

• Ensure that you have the correct applicationId to query the status.
• The status can help you determine the next steps in the application process, such as whether to follow up or wait for further updates.