> ## Documentation Index > Fetch the complete documentation index at: https://docs.stardex.com/llms.txt > Use this file to discover all available pages before exploring further. # List job applicants > Retrieve a paginated list of inbound applications submitted through the public job posting form (the Applicants tab). This is **not** the job pipeline. Pipeline candidates — people already added to a stage — are returned by `GET /v1/jobs/{id}/candidates`. **Status values**: `new` (unprocessed), `selected` (added to the job pipeline; `person_id` is then set), `not_a_fit` (rejected from the Applicants tab). File fields and `resume_url` / `cover_letter_url` are short-lived signed download URLs. Re-fetch this endpoint when a URL expires (about 15 minutes). Jobs with no public posting return an empty list. Unknown job IDs return 404. ## OpenAPI ````yaml /api-reference/openapi-v1.json get /v1/jobs/{id}/applicants openapi: 3.1.0 info: title: Stardex API (v1) version: 1.0.0 description: >- Stardex ATS API — manage candidates, jobs, companies, and recruiting workflows. servers: - url: https://api.stardex.ai description: Production API server security: - bearerAuth: [] tags: - name: Persons description: Manage person records — contacts, work history, and custom fields. - name: Jobs description: Manage job postings — pipeline stages, team members, and custom fields. - name: Candidates description: Manage candidate records and pipeline stage transitions. - name: Companies description: Browse and retrieve company records. - name: Lists description: Create, search, and retrieve saved person and company lists. - name: Person Activities description: Create and manage activity records (notes, emails, meetings) for persons. - name: Team Members description: List team members for use in search filters and assignments. - name: Custom Fields description: Retrieve custom field definitions and tag options for search filters. paths: /v1/jobs/{id}/applicants: get: tags: - Jobs summary: List job applicants description: >- Retrieve a paginated list of inbound applications submitted through the public job posting form (the Applicants tab). This is **not** the job pipeline. Pipeline candidates — people already added to a stage — are returned by `GET /v1/jobs/{id}/candidates`. **Status values**: `new` (unprocessed), `selected` (added to the job pipeline; `person_id` is then set), `not_a_fit` (rejected from the Applicants tab). File fields and `resume_url` / `cover_letter_url` are short-lived signed download URLs. Re-fetch this endpoint when a URL expires (about 15 minutes). Jobs with no public posting return an empty list. Unknown job IDs return 404. operationId: listJobApplicants parameters: - in: path name: id required: true schema: type: string description: Job UUID - schema: type: - integer - 'null' minimum: 0 default: 0 description: Records to skip for pagination. Defaults to 0. required: false name: offset in: query - schema: type: integer minimum: 1 maximum: 100 default: 100 description: Max records per page (1–100). Defaults to 100. required: false name: limit in: query - schema: type: string description: >- Comma-separated applicant statuses to include. Values: new, selected, not_a_fit. Omit to return all statuses. required: false name: status in: query - schema: type: string description: Case-insensitive search across applicant name and email. required: false name: search in: query - schema: type: string format: date-time description: >- Include applicants submitted on or after this ISO 8601 datetime (e.g. "2024-01-01T00:00:00Z"). required: false name: created_at_gte in: query - schema: type: string format: date-time description: >- Include applicants submitted on or before this ISO 8601 datetime (e.g. "2024-12-31T23:59:59Z"). required: false name: created_at_lte in: query responses: '200': description: Applicants fetched content: application/json: schema: $ref: '#/components/schemas/JobApplicantsResponse' example: success: true data: - id: 890e1234-b56c-78d9-e012-345678901234 job_id: 123e4567-e89b-12d3-a456-426614174000 job_posting_id: 901e2345-c67d-89e0-f123-456789012345 person_id: null name: Alex Rivera email: alex.rivera@example.com status: new linkedin_profile_url: https://www.linkedin.com/in/alexrivera portfolio_url: https://alexrivera.dev additional_information: Available to start in two weeks. resume_url: >- https://project.supabase.co/storage/v1/object/sign/job-application-documents/example-resume cover_letter_url: >- https://project.supabase.co/storage/v1/object/sign/job-application-documents/example-cover-letter not_a_fit_note: null fields_response: fields: - field_id: full_name type: text value: Alex Rivera - field_id: email type: email value: alex.rivera@example.com - field_id: phone type: phone value: +1-555-0100 - field_id: linkedin_profile_url type: url value: https://www.linkedin.com/in/alexrivera - field_id: cover_letter type: textarea value: I am excited to apply for this role. - field_id: years_experience type: number value: 8 - field_id: start_date type: date value: '2024-03-01' - field_id: work_authorization type: select value: US Citizen - field_id: skills type: multi_select value: - TypeScript - React - field_id: resume_file_path type: file value: name: Alex_Rivera_Resume.pdf size: 245760 type: application/pdf url: >- https://project.supabase.co/storage/v1/object/sign/job-application-documents/example-resume created_at: '2024-02-01T15:45:00Z' updated_at: '2024-02-01T15:45:00Z' meta: total: 8 offset: 0 limit: 20 '400': description: Validation error content: application/json: schema: type: object properties: success: type: boolean enum: - false description: Always false for error responses. error: type: object properties: code: type: string description: >- Machine-readable error code (e.g. "VALIDATION_ERROR", "NOT_FOUND"). message: type: string description: Human-readable error description. required: - code - message required: - success - error '404': description: Resource not found content: application/json: schema: type: object properties: success: type: boolean enum: - false description: Always false for error responses. error: type: object properties: code: type: string description: >- Machine-readable error code (e.g. "VALIDATION_ERROR", "NOT_FOUND"). message: type: string description: Human-readable error description. required: - code - message required: - success - error '500': description: Internal server error content: application/json: schema: type: object properties: success: type: boolean enum: - false description: Always false for error responses. error: type: object properties: code: type: string description: >- Machine-readable error code (e.g. "VALIDATION_ERROR", "NOT_FOUND"). message: type: string description: Human-readable error description. required: - code - message required: - success - error components: schemas: JobApplicantsResponse: type: object properties: success: type: boolean enum: - true data: type: array items: $ref: '#/components/schemas/JobApplicant' meta: type: object properties: total: type: number description: Total matching records across all pages. offset: type: number description: Current pagination offset. limit: type: number description: Page size used for this request. required: - total - offset - limit required: - success - data - meta JobApplicant: type: object properties: id: type: string format: uuid description: Applicant UUID. job_id: type: string format: uuid description: Job UUID this application belongs to. job_posting_id: type: string format: uuid description: Public job posting UUID the application was submitted against. person_id: type: - string - 'null' format: uuid description: >- Linked person UUID after the applicant is added to the job pipeline (`selected`). Null for unprocessed or rejected applicants. name: type: string description: Applicant full name. email: type: string description: Applicant email address. status: type: string enum: - new - selected - not_a_fit description: >- Applicant review status. `new` is unprocessed (still on the Applicants tab), `selected` was added to the job pipeline, and `not_a_fit` was rejected from the Applicants tab. linkedin_profile_url: type: - string - 'null' description: LinkedIn profile URL from the application form, if collected. portfolio_url: type: - string - 'null' description: Portfolio URL from the application form, if collected. additional_information: type: - string - 'null' description: >- Free-text additional information from the application form, if collected. resume_url: type: - string - 'null' description: >- Signed download URL for the uploaded resume. Null when no resume was submitted. Re-fetch when expired. cover_letter_url: type: - string - 'null' description: >- Signed download URL for the uploaded cover letter. Null when no cover letter was submitted. Re-fetch when expired. not_a_fit_note: type: - string - 'null' description: >- Plain-text recruiter note recorded when marking the applicant as not a fit. Null otherwise. fields_response: type: object properties: fields: type: array items: oneOf: - type: object properties: field_id: type: string description: Application form field ID. type: type: string enum: - text - email - phone - textarea - url value: type: string required: - field_id - type - value - type: object properties: field_id: type: string description: Application form field ID. type: type: string enum: - number value: type: number required: - field_id - type - value - type: object properties: field_id: type: string description: Application form field ID. type: type: string enum: - date value: type: string required: - field_id - type - value - type: object properties: field_id: type: string description: Application form field ID. type: type: string enum: - select value: type: string required: - field_id - type - value - type: object properties: field_id: type: string description: Application form field ID. type: type: string enum: - multi_select value: type: array items: type: string required: - field_id - type - value - type: object properties: field_id: type: string description: Application form field ID. type: type: string enum: - file value: type: object properties: name: type: string description: Original uploaded filename. size: type: number description: File size in bytes. type: type: string description: MIME type of the uploaded file. url: type: string description: >- Short-lived signed download URL. Re-fetch this endpoint when the URL expires (about 15 minutes). Empty string if the file could not be signed. required: - name - size - type - url required: - field_id - type - value required: - fields description: >- Submitted application form answers. File fields include a signed download URL instead of a storage path. created_at: type: string description: ISO 8601 timestamp when the application was submitted. updated_at: type: string description: ISO 8601 timestamp when the applicant record was last updated. required: - id - job_id - job_posting_id - person_id - name - email - status - linkedin_profile_url - portfolio_url - additional_information - resume_url - cover_letter_url - not_a_fit_note - fields_response - created_at - updated_at securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: JWT description: >- Authenticate with a Bearer token: API key, OAuth token, or session token. ````