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
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
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" }