Fetching data...
Developer API Reference
Build powerful integrations with our platform APIs.
Developer API Reference
Build powerful integrations with our platform APIs.
Public-api-inbound-expansion-
Dynamic API reference synchronized with our latest backend endpoints.
GET
List candidate documents
/api/v1/candidates/{id}/documentsReturns a list of all documents (resumes, CVs, etc.) associated with the candidate. Includes signed temporary URLs for download.
Parameters
idRequiredstringThe candidate UUID
Example Request
bashcurl -X GET "https://your-tenant.peoplelensai.com/api/v1/candidates/{id}/documents" \
-H "Authorization: Bearer <YOUR_API_KEY>" \
-H "Content-Type: application/json" Example Response
json[
{
"id": "123e4567-e89b-12d3-a456-426614174000",
"file_name": "Jane_Doe_Resume_2026.pdf",
"file_path": "tenant-1/123/456-Jane_Doe_Resume_2026.pdf",
"file_type": "application/pdf",
"file_size": 1048576,
"signedUrl": "https://storage.peoplelensai.com/signed/..."
}
]POST
Upload candidate document
/api/v1/candidates/{id}/documentsUploads a resume or other file for a candidate. Expects multipart/form-data with a "file" field.
Parameters
idRequiredstringThe candidate UUID
Example Request
bashcurl -X POST "https://your-tenant.peoplelensai.com/api/v1/candidates/{id}/documents" \
-H "Authorization: Bearer <YOUR_API_KEY>" \
-H "Content-Type: application/json" Example Response
json{
"id": "123e4567-e89b-12d3-a456-426614174000",
"candidate_id": "987fcdeb-51a2-43d7-9012-3456789abcde",
"file_name": "Jane_Doe_Resume_2026.pdf",
"file_path": "tenant-1/123/456-Jane_Doe_Resume_2026.pdf",
"file_type": "application/pdf",
"file_size": 1048576
}