.png?fit=max&auto=format&n=lKy84_BssSCy2hcz&q=85&s=ac7c949427cc2893306f6036415f087e)
curl --request POST \
--url https://partner-api.taptalent.io/v1/partner/candidates/bulk/resume \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"resumeURLs": [
"https://example.com/resumes/john-doe.pdf",
"https://example.com/resumes/jane-smith.docx",
"https://example.com/resumes/bob-johnson.pdf"
]
}
'{
"success": true,
"data": {
"batchId": 12345,
"fileCount": 2
}
}Bulk upload resumes
Upload multiple resumes for parsing and candidate creation. Each URL must point to a publicly accessible resume file (PDF, DOC, DOCX). Maximum 5,000 resume URLs per request.
Processing is asynchronous: use the returned batchId with
GET /candidates/batch/{batchId} to retrieve parsed candidates.
The webhook events resume.bulk_upload_parse.started,
resume.bulk_upload_parse.completed, and
resume.bulk_upload_parse.failed are sent as the batch progresses
(see the webhooks section of this document).
Validation rules:
resumeURLsmust be provided and cannot be empty.resumeURLsmust be an array.- Each URL must be a non-empty string (whitespace-only strings are invalid).
- URLs must be publicly accessible.
- Maximum 5,000 resume URLs per request.
For very large uploads (1,000+ resumes), consider splitting into multiple requests to better track progress; batches of 50-500 resumes give an optimal balance between speed and tracking.
curl --request POST \
--url https://partner-api.taptalent.io/v1/partner/candidates/bulk/resume \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"resumeURLs": [
"https://example.com/resumes/john-doe.pdf",
"https://example.com/resumes/jane-smith.docx",
"https://example.com/resumes/bob-johnson.pdf"
]
}
'{
"success": true,
"data": {
"batchId": 12345,
"fileCount": 2
}
}Authorizations
Company-scoped API key. Production keys are prefixed sk_live_,
sandbox keys sk_test_, each followed by 22 base62 characters
(pattern ^sk_(live|test)_[0-9A-Za-z]{22}$). Generate keys in the
TapTalent dashboard under Account Settings → Developers → API Key
Management; a key is shown once at generation and old keys are
invalidated immediately on regeneration.
Body
Request body for the bulk resume upload endpoint.
Array of publicly accessible URLs pointing to resume files (PDF, DOC, DOCX). Maximum 5,000 resumes per request. Each URL must be a non-empty string (whitespace-only strings are invalid).
1 - 5000 elements1Was this page helpful?