> ## Documentation Index > Fetch the complete documentation index at: https://api.jobaffinity.com/llms.txt > Use this file to discover all available pages before exploring further. # List applications for a job > Returns all applications submitted for a specific job ## OpenAPI ````yaml /api-reference/openapi.json get /job/{jobid}/application openapi: 3.0.3 info: title: JobAffinity REST API version: '1.12' description: > JobAffinity REST API for managing jobs, candidates, applications, and recruitment processes. ## Authentication All endpoints require HTTP Basic Authentication. ## Versioning Current version: 1.12 See `/restapi/changelog` for version history and changes. contact: name: JobAffinity API Support servers: - url: https://jobaffinity.fr/restapi/v1 description: REST API v1 - url: https://jobaffinity.fr/restapi description: REST API root (for changelog) security: - basicAuth: [] tags: - name: API Info description: API metadata and changelog - name: Jobs description: Job listings and details - name: Candidates description: Candidate information - name: Applications description: Job applications - name: Processes description: Recruitment processes and steps - name: Notes description: Candidate notes - name: Questionnaires description: Questionnaire answers - name: Webhooks description: Webhook tasks - name: Job Application Submission description: >- Submit candidate applications to a job posting via the apply URL provided in the job feed. The authentication token is embedded in the URL — no additional credentials are required. paths: /job/{jobid}/application: get: tags: - Applications summary: List applications for a job description: Returns all applications submitted for a specific job operationId: listJobApplications parameters: - name: jobid in: path required: true description: Job ID schema: type: integer - $ref: '#/components/parameters/limitParam' - $ref: '#/components/parameters/sinceParam' - name: step_name in: query description: >- Filter applications by the name of their current step. Valid step names can be found in the `process` field of the job details. schema: type: string - name: step_status in: query description: Filter applications by their current step status. schema: type: string enum: - START - CURRENT - END - name: step in: query description: >- Filter applications by the id of their current step. Valid step ids can be found in the `process` field of the job details. schema: type: integer - name: last_step_since in: query description: >- Filter applications whose last step change occurred on or after this date (inclusive). ISO 8601 format: YYYY-MM-DD. schema: type: string format: date - name: last_step_until in: query description: >- Filter applications whose last step change occurred on or before this date (inclusive). ISO 8601 format: YYYY-MM-DD. schema: type: string format: date - name: last_name in: query description: Filter applications by the candidate's last name. schema: type: string - name: first_name in: query description: Filter applications by the candidate's first name. schema: type: string - name: email in: query description: Filter applications by the candidate's email address. schema: type: string format: email responses: '200': description: Paginated list of applications content: application/json: schema: type: object properties: _self: type: string format: uri _schema: type: string format: uri _status: type: string enum: - OK - INVALID _next: type: string format: uri nullable: true items: type: array items: $ref: '#/components/schemas/Application' '401': $ref: '#/components/responses/UnauthorizedError' '404': $ref: '#/components/responses/NotFoundError' components: parameters: limitParam: name: limit in: query description: Maximum number of items to return per page schema: type: integer minimum: 1 maximum: 100 default: 20 sinceParam: name: since in: query description: Return items created or modified since this ID schema: type: integer minimum: 0 schemas: Application: type: object properties: _self: type: string format: uri description: URL of the application resource _schema: type: string format: uri _status: type: string enum: - OK - INVALID id: type: integer description: Application identifier date: type: string format: date-time description: Application submission date route: type: string description: Application route (how the candidate applied) latest_cv_url: type: string format: uri nullable: true description: URL to download the latest CV (may redirect) candidate: type: object description: Inline candidate summary properties: id: type: integer _self: type: string format: uri applications: type: object properties: _self: type: string format: uri title: type: string enum: - MR - MS - MRS - UNKNOWN first_name: type: string last_name: type: string email: type: string format: email source: type: object description: Source of the application properties: id: type: integer name: type: string posting_service: type: object properties: id: type: integer nullable: true name: type: string job: type: object description: Inline job summary properties: _self: type: string format: uri id: type: integer title: type: string status: type: string enum: - OPEN - CLOSED - ARCHIVED applications: type: object properties: _self: type: string format: uri step: type: object description: Current step of the application properties: id: type: integer nullable: true name: type: string status: type: string enum: - START - CURRENT - END - '' date: type: string format: date nullable: true description: Date when this step was set steps: type: object description: >- Full step history of the application (available in application detail, not in collection listings) properties: items: type: array items: type: object properties: id: type: integer name: type: string status: type: string enum: - START - CURRENT - END date: type: string format: date user: $ref: '#/components/schemas/User' latest_cv_url: type: string format: uri nullable: true notes: type: object properties: _self: type: string format: uri User: type: object properties: id: type: integer description: User identifier first_name: type: string description: First name of the user last_name: type: string description: Last name of the user email: type: string format: email description: Email of the user responses: UnauthorizedError: description: Authentication information is missing or invalid headers: WWW-Authenticate: schema: type: string NotFoundError: description: The specified resource was not found content: application/json: schema: type: object properties: _status: type: string enum: - INVALID error: type: string securitySchemes: basicAuth: type: http scheme: basic description: HTTP Basic Authentication with API credentials ````