---
title: "Listing applications"
method: GET
path: "/jobs/{jobId}/applications"
tags: ["Applications"]
---

# Listing applications

`GET /jobs/{jobId}/applications`

## Request

- Base URL: `https://api.gupy.io/api/v1`
- URL: `https://api.gupy.io/api/v1/jobs/{jobId}/applications`
- Auth: HTTP bearer

Returns a list of candidate applications. Click [here](../docs/listing-applications) for more information.

## Path parameters

- `jobId` integer, required

## Query parameters

- `id` integer
- `status` 'in_process' | 'give_up' | 'reproved' | 'hired'
- `currentStep.name` string
- `candidate.identificationDocument` string
- `vacancyCode.code` string
- `order` string
- `fields` string
- `perPage` integer
- `page` integer

## Response `200`

An array of candidates

- PaginatedApplication: An array of applications
  - `results` Application[], required
    - `id` integer: Application ID
    - `score` number, double, nullable: Deprecated. Sorting score for the application (legacy affinity or latest consolidated AI per job). Returns null when the company is not eligible via feature flags. Planned for removal in a future API version.
    - `source` 'google' | 'facebook' | 'instagram' | 'linkedin' | 'whatsapp' | 'indeed' | 'catho' | 'company_website' | 'referral' | 'university' | 'github' | 'telegram' | 'other': Source of the candidate
    - `sourceOther` string: Source description for "other"
    - `status` 'in_process' | 'give_up' | 'reproved' | 'hired': Application current status
    - `isCompanyEmployee` boolean: The candidate is a company employee
    - `employeeEmail` string: The candidate employee e-mail
    - `registrationComplete` boolean: The registration step of application is complete
    - `referred` boolean: The candidate was referred
    - `referredBy` string: Name of the person who referred this candidate
    - `referralStatus` 'pending' | 'confirmed' | 'rejected' | 'unknown': Status of referral
    - `feedbackSent` boolean: A feedback was sent to the candidate
    - `matching` number, double: Candidate matching on the company's culture
    - `disapprovalReason` 'hired_by_another_company' | 'invited_to_another_process' | 'missed_steps_of_process' | 'insufficient_knowledge' | 'hiring_not_allowed' | 'incompatible_curriculum' | 'gave_up_for_personal_reasons' | 'inconsistent_admission_docs' | 'elevated_wage_expectation' | 'lack_of_culture_alignment' | 'insufficient_academic_background' | 'no_potential_for_growth' | 'overqualified' | 'insufficient_seniority' | 'fulfilled_vacancy' | 'reject_at_medical_exam' | 'candidate_outside_required_location' | 'test_result_below_cutoff' | 'not_respond_to_contacts' | 'proposal_not_accepted' | 'hired_in_another_job' | 'lack_of_professional_experience' | 'little_stability_in_previous_companies' | 'medical_report_disqualified' | 'incomplete_screening_stage' | 'incomplete_registration_step' | 'other_reason': Disapproval reason for reproved candidates
    - `disapprovalReasonNotes` string: Disapproval reason note for reproved candidates when reason is other
    - `hiringType` 'employee_admission' | 'employee_readmission' | 'employee_reintegration' | 'unrelated_worker_hiring' | 'internal_transfer': Type of candidate hiring
    - `hiringDate` string, date-time: Date of hiring
    - `createdAt` string, date-time: Data of creation
    - `updatedAt` string, date-time: Date of update
    - `endedAt` string, date-time: Date of disqualification if status is reproved, date of withdrawal if status is give_up or date of hiring if status is hired
    - `partnerName` '99hunters' | 'catho' | 'facebook_jobs' | 'geekhunter' | 'glassdoor' | 'google_for_jobs' | 'indeed' | 'indeed_sponsored' | 'jooble' | 'linkedin' | 'netvagas' | 'riovagas' | 'trampos' | 'gupy_opportunities' | 'gupy_opportunities_recommended' | 'gupy_public_page' | 'gupy_public_page_event': Name of the partner who created the application
    - `job` object: Job basic information.
      - `id` integer: Job ID
      - `name` string: Job name
      - `status` 'approved' | 'done' | 'not_started' | 'started': Status of the application step
    - `currentStep` object: Current application step basic information.
      - `id` integer: Step id
      - `name` string: Step name
    - `tags` string[]: Array of tag names added to the candidate application
    - `manualCandidate` ManualCandidate: Manual insertion candidate information
      - `id` integer: Candidate identifier
      - `name` string: First name of the candidate
      - `lastName` string: Last name of the candidate
      - `email` string, email: E-mail of the candidate
      - `mobileNumber` string: Mobile phone number of the candidate (eg. +5511912345678)
      - `linkedinProfileUrl` string: LinkedIn profile URL
      - `insertionSource` 'candidate_active_contact' | 'events' | 'hunting' | 'market_referral_consulting' | 'employee_referral': Source of the application insertion
    - `candidate` Candidate
      - `id` integer: Candidate identifier
      - `name` string: Candidate name (eg. Maria)
      - `lastName` string: Candidate last name (eg. Santos)
      - `email` string, email: Candidate email (eg. maria.santos@provider.com)
      - `identificationDocument` string: Candidate identification document (CPF or other) (eg. 99999999999)
      - `disabilities` boolean: The candidate has any disability
      - `disabilityTypes` string[]: A list of candidate disabilities
      - `birthdate` string, date: Date of birth
      - `gender` 'male' | 'female' | 'other' | 'notInformed': Candidate gender
      - `addressZipCode` string: Candidate address zip code
      - `addressNumber` string: Candidate address number
      - `addressStreet` string: Candidate address street
      - `addressCity` string: Candidate address city
      - `addressState` string: Candidate address state
      - `addressStateShortName` string: Candidate address short state name
      - `addressCountry` string: Candidate address country
      - `addressCountryShortName` string: Candidate address short country name
      - `mobileNumber` string: Candidate's cell phone
      - `phoneNumber` string: Candidate's landline
      - `areasOfInterest` string[]: A list of areas of interest
      - `schooling` 'elementary_school' | 'high_school': Candidate's schooling level
      - `schoolingStatus` 'complete' | 'in_progress' | 'incomplete': Candidate's schooling status
      - `academicQualification` AcademicQualification[]
        - `id` integer: Academic qualification identifier
        - `formation` 'graduation' | 'technological' | 'post_graduate' | 'master_degree' | 'phd', required: Formation type
        - `institution` string, required: Institution or school name
        - `course` string, required: Course name
        - `status` 'complete' | 'in_progress' | 'incomplete', required: Current status of the academic qualification
        - `startMonth` integer, required: Start month
        - `startYear` integer, required: Start year
        - `endMonth` integer: End month
        - `endYear` integer: End year
      - `workExperience` WorkExperience[]
        - `id` integer: Work experience identifier
        - `role` string, required: Professional role
        - `companyName` string, required: Company name
        - `activitiesPerformed` string: Activities performed in this job
        - `startMonth` integer, required: Start month
        - `startYear` integer, required: Start year
        - `endMonth` integer: End month, null if current job
        - `endYear` integer: End year, null if current job
      - `languages` CandidateLanguage[]
        - `language` 'german' | 'arabic' | 'bengali' | 'kazakh' | 'chinese' | 'korean' | 'haitian_creole' | 'kurdish' | 'spanish' | 'french' | 'greek' | 'hindi' | 'hungarian' | 'english' | 'italian' | 'japanese' | 'javanese' | 'lahnda' | 'malay' | 'dutch' | 'nepali' | 'persian' | 'polish' | 'portuguese' | 'romanian' | 'russian' | 'serbo_croatian' | 'somali' | 'swedish' | 'thai' | 'czech' | 'turkish' | 'ukrainian' | 'uzbekistan' | 'vietnamese', required: Language name
        - `level` 'basic' | 'intermediate' | 'advanced' | 'fluent', required: Proficiency level
    - `additionalQuestions` AdditionalQuestion[]
      - `question` string, required: Question answered by candidate
      - `answer` string[]: Answer(s) given by candidate for question
  - `totalResults` integer
  - `page` integer
  - `totalPages` integer

## Other responses

- `400`: BadRequest / Invalid Input
- `401`: Unauthorized
- `403`: Forbidden

## Changes

- **2026-11-03** `b84c14658872`: 1 info
  - response property `results/items/score` deprecated

[Operation history](https://skmtc.dev/gupy/apis/gupy-public-api/changes/jobs/:jobId/applications/get.md)

---

[API](https://skmtc.dev/gupy/apis/gupy-public-api.md) - [All operations](https://skmtc.dev/gupy/apis/gupy-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/gupy/apis/gupy-public-api/revisions/b84c14658872?raw)