Skip to content
CurriculoCurriculo ATS DocumentationDocs
API referenceConsole

Register a job

POSThttps://api.curriculo.me/public/jobs/
On this page

Optional and free. Stores a job description and returns a job_id scoped to your credential, so a backlog of CVs stops re-sending the same text.

This is an evaluation helper, not a job board. There is no listing, no pagination, no organisation and no pipeline. Only the description you send is stored, never a candidate, a CV or a result.

Request

application/json

FieldTypeNotes
job_details (required)stringPlain text pasted from your careers page, or a JSON object of structured requirements.
languagestringDefault ISO 639-1 code for candidate-facing prose.
labelstringYour own name for the job. Echoed back.

Example

curl -X POST https://api.curriculo.me/public/jobs/ \
  -H 'Authorization: Bearer key_abc123_yoursecret' \
  -H 'Content-Type: application/json' \
  -d '{"job_details": "Senior backend engineer, Python and FastAPI, Seoul", "label": "BE-Seoul"}'

Response

{"job_id": "job_abc123", "label": "BE-Seoul"}

Send that job_id on POST /evaluate/ or POST /evaluate/async in place of job_details.

Errors

StatusTypical cause
400Malformed job_details.
422job_details is missing.

/evaluate/ returns 404 for an unknown job_id, or one registered by a different account. Ids are scoped to the credential that created them.

Updated