--- title: "Listing applications" method: GET path: "/jobs/{jobId}/applications" tags: ["Applications"] --- # Listing applications `GET /jobs/{jobId}/applications` 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 — Candidate affinity score - `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 --- [API](https://skmtc.net/gupy/apis/gupy-public-api.md) · [All operations](https://skmtc.net/gupy/apis/gupy-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gupy/gupy-public-api/revisions/3f26defa2a42/schema)