GuidesAPI EndpointsAPI Changelog
Live AI Demo
API Changelog
Improved

Grading API now grades up to 128 jobs per request

GET /job/grading now grades one profile against up to 128 jobs in a single request, up from 32. Grading a profile against more than 32 jobs now takes fewer calls.

Action required

  • Now: none. GET /job/grading keeps its parameters and its response; batches of up to 32 jobs work as before.
  • Later: none. Nothing in this update is deprecated.

What changed

  • The job_ids parameter of GET /job/grading accepts up to 128 jobs per request, up from 32.
  • A batch of more than 128 jobs returns a 400 error saying the maximum batch size is exceeded; the error now names 128 as the limit instead of 32.

Example

curl -G https://api.hrflow.ai/v1/job/grading \
  -H "X-API-KEY: <your_api_key>" \
  -H "X-USER-EMAIL: <your_email>" \
  --data-urlencode "algorithm_key=<algorithm_key>" \
  --data-urlencode "source_key=<source_key>" \
  --data-urlencode "profile_key=<profile_key>" \
  --data-urlencode 'job_ids=[{"board_key": "<board_key>", "job_key": "<job_key_1>"}, {"board_key": "<board_key>", "job_key": "<job_key_2>"}]'

The response holds one entry per job, in the order of job_ids: data.jobs with the jobs and data.scores with a [1-score, score] pair for each.

Links