« Back to operation list

get/curriculum/{curriculumId}/futurejob

Allows to retrieve the future Job section of a given curriculum for the authenticated user. The future Job section includes information about the candidates' availability and motivations to change job and their preferences for the new Job, for example, workDay, contractType, wage amount, etc.

Try it!

Request

Resource URL

https://api.infojobs.net/api/4/curriculum/{curriculumId}/futurejob

Security

  • User Role: role_candidate
  • Scope: candidate_read_curriculum_future_job

Parameters

Name Description

curriculumId

String

Required

Identifier of the curriculum to edit. This curriculum must belongs to the authenticated user.

Example values: 70628530-6d45-483a-8327-d8c81b

Response

Response fields

Fields related to the Futurejob Entity
Name Description

employmentStatus

String

Required

The employment status of the authenticated user. The operation /dictionary/employment-status returns all available values.

Maximum length: 100

motivationToChange

String

Optional

Description with the motivations to change job.

* This field will only be displayed when it has a value.

Maximum length: 1500

futureJobGoals

String

Optional

Description with the goals expected in the new job.

* This field will only be displayed when it has a value.

Maximum length: 1500

yearsOfExperience

String

Required

The number of years of experience of the candidate. The operation /dictionary/candidate-experience returns all available values.

Maximum length: 100

lastJobSearch

String

Optional

Describes how the candidates found their last job. The operation /dictionary/last-job-search returns all available values.

* This field will only be displayed when it has a value.

Maximum length: 100

lastJobSearchDetails

String

Optional

Detailed explanation of how the candidates found their last job.

* This field will only be displayed when it has a value.

Maximum length: 150

preferredPosition

String

Required

Job position preferred by the candidate in his/her future job.

Minimum length: 4
Maximum length: 300

subcategories

Array(String)

Required

The subcategories under which the candidate's future job should fall into. There can be multiple subcategories. The operation /dictionary/subcategory returns all available values.

contractTypes

Array(String)

Optional

The contract type preferred by the candidate in his future job. There can be multiple values. The operation /dictionary/contract-type returns all available values.

* This field will only be displayed when it has a value.

workDay

String

Optional

The work day preferred by the candidate in his future job. The operation /dictionary/workday returns all available values.

* This field will only be displayed when it has a value.

Maximum length: 100

availabilityToChangeHomeAddress

String

Required

The candidate availability to change home address, for example, move to another region. The operation /dictionary/availability returns all available values.

Example values: depende-de-las-condiciones

Maximum length: 100

availabilityToTravel

String

Required

The candidate's availability to travel. The operation /dictionary/availability returns all available values.

preferredDestinations

Array(String)

Optional

The preferred destinations in case of change of home address. There can be multiple values. The operation /dictionary/workday returns all available values.

*The preferredDestinations might contain values even if the availabilityToTravel or availabilityToChangeHomeAddress has been set to bad.

* This field will only be displayed when it has a value.

salaryPeriod

String

Optional

The Salary pay period without taxes. The operation /dictionary/salary-period returns all available values.

* This field will only be displayed when it has a value.

Maximum length: 100

SalaryMin

String

Optional

The minimum salary accepted by the candidate in his future job. The operation /dictionary/salary-quantity returns all available values.

* This field will only be displayed when it has a value.

Maximum length: 100

preferredSalary

String

Optional

The salary expected by the candidate in his future job. The operation /dictionary/salary-quantity returns all available values.

* This field will only be displayed when it has a value.

Maximum length: 100

working

Boolean

Required

If true the candidate is currently working.

Error codes

Code Description

361

The curriculum was not found or the authenticated user is not the owner.

Examples

This example retrieves the future job section of the given curriculum.

Request

https://api.infojobs.net/api/4/curriculum/70628530-6d45-483a-8327-d8c81b0a62ab/futurejob


Response

{
     "employmentStatus": "no-busco-trabajo-pero-estoy-dispuesto-a-escuchar-ofertas",
     "motivationToChange": "Cambio de residencia a otra provincia" ,
     "futureJobGoals" : "Enriquecimiento profesional y personal",
     "yearsOfExperience": "2-anos",
     "lastJobSearch": "bolsa-de-empleo-online",
     "lastJobSearchDetails": "InfoJobs",
     "preferredPosition":"Analista programador",
     "subcategories":["hardware-redes-seguridad"],
     "contractTypes":["autonomo"],
     "workDay":"completa",
     "availabilityToChangeHomeAddress":"buena",
     "availabilityToTravel":"mala",
     "preferredDestinations":["madrid"],
     "salaryPeriod": "bruto-ano",
     "salaryMin":"27.000",
     "preferredSalary":"33.000",
     "working": "true"     
}
Try it!

Sections: