Retrieve the details of all candidate.
Request
GET
GET /v1/candidate
Query Parameter
- sortOrder
integerField to sort by (e.g., first_name, last_name, created_at).
- sortByColumn
integerSort order (asc for ascending, desc for descending).
- page
integerThe page number for pagination.
- limit
integerNumber of candidates per page.
- Maximize
stringThe
maximizeparameter allows you to specify which items to maximize in your API response.It is comma separated string values. The following values are allowed:ownercurrencycreated_byupdated_byqualificationindustry
Note: To maximize all the items in the response, you can pass 'all' as the value for the maximize query parameter.
Example usage:
GET /v1/candidate?maximize=owner,currency,industry
Response
200
Body
- id
numberExample: 48
- first_name
stringExample: John
- last_name
stringExample: Doe
- slug
stringExample: candidate_0d25558c1a77fc2d7d98
- full_name
stringExample: John Doe
- email
stringExample: johndoe@example.com
- phone
stringExample: 1234567890
- resume
stringExample: resume.pdf
- profile_picture
stringExample: anjali.jpg
- education_specialization
stringExample: Computer Science
- university
stringExample: Harvard University
- current_position
stringExample: Software Engineer
- current_organization
stringExample: XYZ Inc
- last_organization
stringExample: ABC Corp
- willing_to_relocate
numberExample: 0
- available_from
stringExample: 2024-09-01
- tags
stringExample: [frontend, developer, javascript]
- skill
stringExample: [JavaScript, React]
- experience
numberExample: 5
- graduation_date
stringExample: 2015-05-15
- current_salary
numberExample: 70000
- expected_salary
numberExample: 90000
- notice_period
numberExample: 30
- salary_type
integerExample: 1
- description
stringExample: Experienced software engineer with a focus on frontend development.
- source
stringExample: LinkedIn
- nationality
stringExample: American
- address
stringExample: 123 Main St
- language
stringExample: Hindi
- city
stringExample: Indore
- state
stringExample: Madhya Pradesh
- country
stringExample: USA
- industry
integerExample: 1
- gender
objectExample:
"id": 1,
"label": "female" - owner
objectExample:
"id": 1,
"email": "Rohan@abc.com",
"first_name": "Rohan",
"last_name": "Sharma",
"full_name": "Rohan Sharma",
"role": "Admin",
"phone": null - currency
objectExample:
"id": 1,
"country": "usa",
"code": "ALL",
"currency": "dollar",
"symbol": "$" - qualification
stringExample: btech
- socials
objectExample:
"linked_in": "https://www.linkedin.com/in/johndoe",
"xing": "https://www.xing.com/profile/John_Doe" - created_at
string (ISO 8601 date)Example: 2015-05-15T00:00:00Z
- updated_at
string (ISO 8601 date)Example: 2015-05-15T00:00:00Z
- created_by
objectExample:
"id": 1,
"email": "Rohan@abc.com",
"first_name": "Rohan",
"last_name": "Sharma",
"full_name": "Rohan Sharma",
"role": "Admin",
"phone": null - updated_by
objectExample:
"id": 1,
"email": "Rohan@abc.com",
"first_name": "Rohan",
"last_name": "Sharma",
"full_name": "Rohan Sharma",
"role": "Admin",
"phone": null - custom fields:
objectExample:
"id": 1,
"field_name": "textfeild",
"field_type": "string",
"value": "anjali"
401
Error
- unauthorized
Response Example
{
"id": 51,
"first_name": "Jo",
"last_name": "Doe",
"slug": "candidate_732999f1fc491eebbed0",
"full_name": "Jo Doe",
"email": "john.doe@example.com",
"phone": "+1234567890",
"resume": "",
"profile_picture": "",
"education_specialization": "",
"university": "",
"current_position": "",
"current_organization": "",
"last_organization": "",
"willing_to_relocate": 0,
"available_from": null,
"tags": "",
"skill": "",
"experience": 5,
"graduation_date": null,
"current_salary": 0,
"expected_salary": 80000,
"notice_period": 1,
"salary_type": null,
"description": "",
"source": "",
"nationality": "",
"address": "123 Main St, Anytown, USA",
"language": "",
"city": "Anytown",
"state": "NY",
"country": "USA",
"industry": 0,
"gender": {
"id": 0,
"label": "Not Available"
},
"owner": {
"id": 1,
"email": "Rohan@abc.com",
"first_name": "Rohan",
"last_name": "Sharma",
"full_name": "Rohan Sharma",
"role": "Admin",
"phone": null
},
"currency": {
"id": 1,
"country": "Albania",
"code": "ALL",
"currency": "Leke",
"symbol": "Lek"
},
"qualification": 0,
"socials": {
"linkedin": "",
"xing": ""
},
"created_at": "2024-08-23T16:51:23.000Z",
"updated_at": "2024-08-23T16:51:51.000Z",
"created_by": {
"id": 1,
"email": "Rohan@abc.com",
"first_name": "Rohan",
"last_name": "Sharma",
"full_name": "Rohan Sharma",
"role": "Admin",
"phone": null
},
"updated_by": {
"id": 1,
"email": "Rohan@abc.com",
"first_name": "Rohan",
"last_name": "Sharma",
"full_name": "Rohan Sharma",
"role": "Admin",
"phone": null
},
"custom_fields": [
{
"id": 1,
"field_name": "C Text asasa",
"field_type": "text",
"value": "Some custom value"
},
{
"id": 2,
"field_name": "C Date",
"field_type": "date",
"value": null
}
]
}