Documentation

Build with Evalingo

Measure a candidate's speaking and writing ability and get a standardized CEFR level back, from any system that can make an HTTP request. Evalingo is built to sit inside someone else's product: an applicant tracking system, a learning platform, or an internal hiring tool.

API documentation

Authentication, assessments, webhooks, idempotency, rate limits and errors, plus an interactive reference for every endpoint and the OpenAPI specification behind it.

Read the API docs

Help center

Using the product rather than the API: setting up assessments, inviting candidates, reading results, billing and account questions.

Visit the help center

How an integration works

Three calls, and only the first has to be synchronous.

  1. 1

    Create an assessment

    POST to /v1/assessments with a candidate and what to assess. You get back an assessmentUrl.

  2. 2

    Send the candidate that URL

    It carries its own access token, so they need no account and no password. Everything after this happens in their browser.

  3. 3

    Receive the result

    We POST the scored result to your webhook as soon as scoring finishes. Polling works too, but the webhook is faster and cheaper for both of us.

Credits are consumed when a candidate starts, not when you create, so assessments that expire unused cost nothing. Assessment is available in 12 languages. Full detail is in the API documentation.