curl --request POST \
  --url https://api.gospott.com/candidates/_from-unsupervised-cv/_bulk \
  --header 'Content-Type: multipart/form-data' \
  --header 'x-api-key: <api-key>' \
  --form files=@example-file

Candidates

Create candidates from CVs in bulk

Automatically create multiple candidates from uploaded CV files without human review.

Process:

Upload 1-20 CV files (PDF or DOCX format)
AI automatically extracts candidate information
Candidates are created as “unqualified” by default
Failed CV parsing is silently skipped
Returns the count of successfully created candidates

Supported Formats:

PDF (.pdf)
Microsoft Word (.docx)

Limitations:

Maximum 20 files per request
Maximum 10MB per file
Duplicate candidates (by email/phone/LinkedIn) trigger an automatic CV diff instead of creating duplicates

POST

candidates

_from-unsupervised-cv

_bulk

curl --request POST \
  --url https://api.gospott.com/candidates/_from-unsupervised-cv/_bulk \
  --header 'Content-Type: multipart/form-data' \
  --header 'x-api-key: <api-key>' \
  --form files=@example-file

Authorizations

x-api-key

string

header

required

API key for authentication. Get your API key from Settings → API Keys in your Spott dashboard.

Body

multipart/form-data

Upload 1-20 CV files to create candidates

files

file[]

required

Array of CV files (PDF or DOCX)

Required array length: 1 - 20 elements

CV file (max 10MB)

Response

CVs processed successfully. Returns the number of candidates created.

Number of successfully created candidates (may be less than uploaded files if some fail)

Example:

3

Create candidate from CV

⌘I