Get an applicant by GUID

GET

https://app.brightmove.com/ATS/api/v1/applicants/:guid

GET

/ATS/api/v1/applicants/:guid

$ curl https://app.brightmove.com/ATS/api/v1/applicants/72d7a0b4-1234-5678-abcd-ef0123456789 \
>      -H "X-Brightmove-Company-ApiKey: <apiKey>" \
>      -H "Content-Type: application/json"

200Retrieved

1 {
2   "address": "456 Elm Street",
3   "address2": "Apt 2B",
4   "availabilityComments": "Two weeks notice required.",
5   "availableDate": "2026-03-01T00:00:00Z",
6   "city": "Austin",
7   "confidential": false,
8   "createDate": "2025-03-15T14:30:00Z",
9   "currentCompany": "Acme Corp",
10   "currentEmployee": false,
11   "currentPay": 85000,
12   "currentPayTypeId": 4,
13   "currentTitle": "Software Engineer",
14   "desiredPay": 95000,
15   "desiredPayTypeId": 4,
16   "disabilityStatusId": 1,
17   "doNotHire": false,
18   "dob": "1990-06-15T00:00:00Z",
19   "education": [
20     {
21       "certification": "AWS Certified Solutions Architect",
22       "degree": "B.S. Computer Science",
23       "educationTypeId": 1,
24       "educationTypeName": "Bachelor's Degree",
25       "id": 9931,
26       "institution": "University of Florida",
27       "major": "Computer Science",
28       "minor": "Mathematics",
29       "notes": "Graduated with honors."
30     }
31   ],
32   "email": "taylor.nguyen@example.com",
33   "employmentHistory": [
34     {
35       "additionalCompensation": 5000,
36       "compensation": 95000,
37       "compensationNotes": "Includes annual bonus target.",
38       "compensationTypeId": 4,
39       "currentEmployer": false,
40       "description": "Led backend platform development.",
41       "endDate": "2023-06-30T00:00:00Z",
42       "id": 17765,
43       "locationCity": "Austin",
44       "locationRegion": "",
45       "locationState": "Texas",
46       "organizationName": "Acme Corp",
47       "reasonForLeaving": "Career growth",
48       "startDate": "2020-01-15T00:00:00Z",
49       "title": "Senior Software Engineer"
50     },
51     {
52       "additionalCompensation": 3000,
53       "compensation": 80000,
54       "compensationNotes": "",
55       "compensationTypeId": 4,
56       "currentEmployer": false,
57       "description": "Developed client-facing web applications.",
58       "endDate": "2019-12-31T00:00:00Z",
59       "id": 17766,
60       "locationCity": "San Francisco",
61       "locationRegion": "",
62       "locationState": "California",
63       "organizationName": "Tech Solutions Inc.",
64       "reasonForLeaving": "Relocated to Austin",
65       "startDate": "2017-06-01T00:00:00Z",
66       "title": "Software Engineer"
67     }
68   ],
69   "employmentTypeId": 1,
70   "firstName": "Taylor",
71   "genderId": 1,
72   "guid": "72d7a0b4-1234-5678-abcd-ef0123456789",
73   "lastName": "Nguyen",
74   "linkedContact": {
75     "guid": "c3d4e5f6-a7b8-9012-cdef-123456789012",
76     "name": "Chris Ariotti"
77   },
78   "middleName": "R",
79   "modifyDate": "2026-01-29T20:21:07Z",
80   "name": "Taylor Nguyen",
81   "notes": [
82     {
83       "createDate": "2026-02-01T18:04:00Z",
84       "createUser": "Jamie Rivera",
85       "id": 55214,
86       "modifyDate": "2026-02-01T18:04:00Z",
87       "modifyUser": "Jamie Rivera",
88       "note": "Strong communication skills, available in 2 weeks.",
89       "reminder": false,
90       "reminderDate": "",
91       "subject": "Phone screen follow-up"
92     },
93     {
94       "createDate": "2026-02-10T14:30:00Z",
95       "createUser": "Jane Smith",
96       "id": 55215,
97       "modifyDate": "",
98       "modifyUser": "",
99       "note": "Excellent technical knowledge, recommended for next round.",
100       "reminder": true,
101       "reminderDate": "2026-02-15T09:00:00Z",
102       "subject": "Interview feedback"
103     }
104   ],
105   "payComments": "Open to negotiation for the right role.",
106   "phones": [
107     {
108       "id": 4821,
109       "phoneNumber": "555-201-4488",
110       "phoneTypeId": 1,
111       "phoneTypeName": "Mobile"
112     },
113     {
114       "id": 4822,
115       "phoneNumber": "512-555-1234",
116       "phoneTypeId": 2,
117       "phoneTypeName": "Home"
118     }
119   ],
120   "postalCode": "78701",
121   "preferredLocation": "Remote, US",
122   "primarySkills": "Java, Spring Boot, SQL",
123   "raceEthnicityId": 1,
124   "rank": 3,
125   "recruiter": {
126     "guid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
127     "name": "Jane Smith"
128   },
129   "referredBy": "Jamie Rivera",
130   "resumes": [
131     {
132       "coverLetter": false,
133       "createDate": "2026-01-29T20:21:07Z",
134       "id": 88231,
135       "initial": true,
136       "name": "taylor_nguyen_resume.pdf"
137     },
138     {
139       "coverLetter": true,
140       "createDate": "2026-02-01T10:15:00Z",
141       "id": 88232,
142       "initial": false,
143       "name": "taylor_nguyen_cover_letter.pdf"
144     }
145   ],
146   "socialLinks": [
147     {
148       "path": "https://linkedin.com/in/taylornguyen",
149       "typeId": 22,
150       "typeName": "LinkedIn"
151     },
152     {
153       "path": "https://twitter.com/taylor_nguyen",
154       "typeId": 21,
155       "typeName": "Twitter"
156     }
157   ],
158   "source": "Indeed",
159   "sourceOther": "Referred at a job fair",
160   "state": "Texas",
161   "status": "Active",
162   "statusNote": "Waiting on reference check.",
163   "tags": [
164     {
165       "id": 12,
166       "name": "Information Technology"
167     },
168     {
169       "id": 34,
170       "name": "Java Developer"
171     }
172   ],
173   "vendor": {
174     "guid": "5c6d7e8f-9012-3456-abcd-ef0123456789",
175     "name": "Acme Staffing Partners"
176   },
177   "veteranStatusId": 1,
178   "visaStatusId": 1,
179   "workEmail": "taylor@work.example"
180 }

Returns the full detail of a single applicant (candidate): contact info, classification and EEOC/compliance fields, compensation, and embedded phones/education/employment history/notes/tags/social links/resume metadata.

Authentication

X-Brightmove-Company-ApiKeystring

BrightMove Company Api Key

X-Brightmove-User-ApiKeystring

BrightMove User Api Key

Path parameters

guidstringRequired

Stable public identifier of the applicant

Response

Applicant found and returned