get/curriculum/{curriculumId}/personaldata

Allows to read the personal data section of a given curriculum for the authenticated user. In the personal data section the candidate can provide information about his localization like country and province and also contact details like his phone number and his mobile phone number.


Request

Resource URL

https://api.infojobs.net/api/2/curriculum/{curriculumId}/personaldata

Security

  • User Role: role_candidate
  • Scope: candidate_read_curriculum_personal_data

Parameters

Name Description

curriculumId

String

Required

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

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

Response

Response fields

Fields related to the result
Name Description

name

String

Candidate's name. This field can't be empty.

Example values: Anthony

Maximum length: 50

surname1

String

Candidate's family name. This field can't be empty.

Example values: Smith

Maximum length: 50

surname2

String

Candidate's second family name. This field can be empty.

Example values: Pi i Molist

Maximum length: 50

nationalIdentityCardType

String

The type of national identity card informed by the candidate. The operation /dictionary/id-type returns all available values.

Example values:pasaporte

nationalIdentityCard

String

The national identity card informed by the candidate.

Example values: 20xxxxxV

birthDay

String

The birthDay of the candidate in format: yyyy-MM-dd.

Example values: 1980-09-20

gender

String

The gender of the candidate. The operation /dictionary/gender returns all available values.

Example values:mujer

country

String

The country the authenticated user inhabits. The operation /dictionary/country returns all available values.

province

String

The province the authenticated user inhabits. The operation /dictionary/province returns all available values.

cityCode

String

The city the authenticated user inhabits. The operation /dictionary/city returns all available values.

cityName

String

If the cityCode is not present, then the cityName will appear as a regular text string. Prefer to use the cityCode value since the cityName value will appear only for non recognized user cities.

zipCode

String

The zip code the authenticated user inhabits. Depending of the country, the zip code is 5 numeric characters long or more (leading zeros must be included).

address

String

The home address the authenticated user inhabits.

Maximum length:100

preferredContactPhone

String

Which user phone is preferred for contact. Possible values are foreign-phone, mobile-phone, land-line-phone.

mobilePhone

String

The mobile phone of the authenticated user. The phone does not include the country area and is composed by numerical characters. Depending of the country the phone is 9 numeric characters long or more.

landLinePhone

String

The regular phone line of the authenticated user. The phone does not include the country area and is composed by numerical characters. Depending of the country the phone is 9 numeric characters long or more.

internationalPhone

String

The foreign phone of the authenticated user. The phone contains the country code and is composed by an optional plus sign followed by up to 20 numeric characters

Maximum length:100

webpages

Array(URL)

An array of URL entities objects where the first String is a URL like http://facebook.com/usersample and the second String is an optional URL type like facebook or twitter. The operation /dictionary/utl-type returns all available URL type values. The definition of URL entities is bellow.

driverLicenses

Array(String)

The driver licenses the authenticated user holds. It's possible to inform multiple values. The operation /dictionary/driver-license returns all available values.

vehicleOwner

Boolean

True is the authenticated user has a car, false otherwise.

freelance

Boolean

True if the authenticated user wants to work as a freelance, false otherwise

nationalities

Array(String)

The countries list where the authenticated user holds a nationality. The operation /dictionary/country returns all available values.

workPermits

Array(String)

Array with the countries or regions where the authenticated user is allowed to work. The operation /dictionary/work-permit returns all available values.

pendingWorkPermit

String

An open text field for declaring where the authenticated user is requesting for a work permit

Maximum length:100

Error codes

Code Description

361

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

URL Entitiy

URL fields

Fields related to the URL entity
Name Description

url

String

A valid URL like http://www.facebook.com/username or https://username.blogspot.com

type

String

The kind of URL like facebook or twitter. The operation /dictionary/url-type returns all available values.

Examples

This example reads the personal data section of the given curriculum.

Request

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


Response

{
  "name": "auto_cand07",
  "surname1": "apellido",
  "surname2": "auto_cand70",
  "nationalIdentityCardType": "pasaporte",
  "nationalIdentityCard": "47663725C",
  "birthDay": "1968-01-25",
  "gender": "hombre",
  "country": "espana",
  "province": "barcelona",
  "cityCode": "seleccionar",
  "zipCode": "08290",
  "address": "Villarroel 2 1",
  "preferredContactPhone": "mobile-phone",
  "mobilePhone": "669854125",
  "landLinePhone": "936543212",
  "internationalPhone": "+0035987654321",
  "webpages": [
    {
      "url": "http://usuario.blogspot.com"
    },
    {
      "url": "http://www.facebook.com/usuario",
      "type": "facebook"
    }
  ],
  "driverLicenses": [
    "a",
    "b"
  ],
  "vehicleOwner": true,
  "freelance": false,
  "nationalities": [
    "espana"
  ],
  "workPermits": [
    "union-europea",
    "cuba"
  ],
  "pendingWorkPermit": "Inicio tramite octubre 2010"
}