Skip to main content
POST
Candidate Data & Submissions

Retrieve Candidate Data and Submissions

Fetch candidate details and form submissions for a set of application IDs that all belong to the same hiring flow. Also supports GET requests with query parameters.

Endpoints

Authentication

[!NOTE] Requires a valid company API key in the Authorization header (format: Api-Key <key>).

Request Body (POST)

Query Parameters (GET)

Example Request

Response Structure

Responses

200: OK

Successfully retrieved candidate data and submissions.

400: Bad Request

Invalid ID, number of applications exceeds the cap (50), no matching applications found, or IDs span multiple flows.

404: Not Found

Referenced flow does not exist or no applications could be fetched.

500: Internal Server Error

Unexpected error.

Notes

  • Maximum of 50 applications per request
  • All application IDs must belong to the same hiring flow