List candidate educations

get

https://harvest.greenhouse.io/v3/candidate_educations

Candidate educations are the school/degree/discipline entries on a candidate's profile — one row per education entry. V3 flattens what V1 nested under /v1/candidates/{id}/educations; filter with candidate_ids to retrieve a single candidate's full education history. School, degree, and discipline are stored as references to custom-field option ids — resolve the display names via /v3/custom_field_options. Use latest=true to retrieve only each candidate's most recent education.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

cursor

string

Cursor link for pagination from previous page response header. Do not use any other parameters when using this.

per_page

integer

1 to 500

Defaults to 100

Number of results per page

ids

array of integers

length ≤ 50

Comma separated list

ids

created_at

object

updated_at

object

candidate_ids

array of integers

length ≤ 50

Comma separated list

candidate_ids

fields

array of strings

length ≤ 50

Comma separated list of fields to return

fields

start_at

object

Filter by education start date. Pass any combination of gte, lte, gt, lt as ISO-8601 date-times (e.g. start_at[gte]=2014-01-01T00:00:00Z).

end_at

object

Filter by education end date. Pass any combination of gte, lte, gt, lt as ISO-8601 date-times (e.g. end_at[lte]=2018-12-31T00:00:00Z).

latest

boolean

When true, return only each candidate's most recent education entry; when false, exclude the most recent. Omit to include the full education history.

Response

Language

Credentials

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200Successful