Retrieve the details of all candidate.
Request
GET
GET /v1/candidate
Query Parameter
- sortOrder
integer
Field to sort by (e.g., first_name, last_name, created_at).
- sortByColumn
integer
Sort order (asc for ascending, desc for descending).
- page
integer
The page number for pagination.
- limit
integer
Number of candidates per page.
- Maximize
string
The
maximize
parameter allows you to specify which items to maximize in your API response.It is comma separated string values. The following values are allowed:owner
currency
created_by
updated_by
qualification
industry
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
number
Example: 48
- first_name
string
Example: John
- last_name
string
Example: Doe
- slug
string
Example: candidate_0d25558c1a77fc2d7d98
- full_name
string
Example: John Doe
- email
string
Example: johndoe@example.com
- phone
string
Example: 1234567890
- resume
string
Example: resume.pdf
- profile_picture
string
Example: anjali.jpg
- education_specialization
string
Example: Computer Science
- university
string
Example: Harvard University
- current_position
string
Example: Software Engineer
- current_organization
string
Example: XYZ Inc
- last_organization
string
Example: ABC Corp
- willing_to_relocate
number
Example: 0
- available_from
string
Example: 2024-09-01
- tags
string
Example: [frontend, developer, javascript]
- skill
string
Example: [JavaScript, React]
- experience
number
Example: 5
- graduation_date
string
Example: 2015-05-15
- current_salary
number
Example: 70000
- expected_salary
number
Example: 90000
- notice_period
number
Example: 30
- salary_type
integer
Example: 1
- description
string
Example: Experienced software engineer with a focus on frontend development.
- source
string
Example: LinkedIn
- nationality
string
Example: American
- address
string
Example: 123 Main St
- language
string
Example: Hindi
- city
string
Example: Indore
- state
string
Example: Madhya Pradesh
- country
string
Example: USA
- industry
integer
Example: 1
- gender
object
Example:
"id": 1,
"label": "female" - owner
object
Example:
"id": 1,
"email": "Rohan@abc.com",
"first_name": "Rohan",
"last_name": "Sharma",
"full_name": "Rohan Sharma",
"role": "Admin",
"phone": null - currency
object
Example:
"id": 1,
"country": "usa",
"code": "ALL",
"currency": "dollar",
"symbol": "$" - qualification
string
Example: btech
- socials
object
Example:
"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
object
Example:
"id": 1,
"email": "Rohan@abc.com",
"first_name": "Rohan",
"last_name": "Sharma",
"full_name": "Rohan Sharma",
"role": "Admin",
"phone": null - updated_by
object
Example:
"id": 1,
"email": "Rohan@abc.com",
"first_name": "Rohan",
"last_name": "Sharma",
"full_name": "Rohan Sharma",
"role": "Admin",
"phone": null - custom fields:
object
Example:
"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
}
]
}