Skip to main content

Get a test

Fetch one test's metadata in the curated v1 shape. Scope: tests:read.

GET/api/v1/tests/{id} 🔒 API key

Fetches a single test’s metadata (never the question content). Scope: tests:read. A test the key cannot see returns 404.

Path parameters

ParameterTypeDescription
idstringThe test id.

Example request

curl https://app.talent-ray.com/api/v1/tests/test_js \
  -H "Authorization: Bearer tr_YOUR_KEY"

Response

200 OK — a single test object (same shape as the items in List tests).

Status codes

StatusMeaning
200Success.
401No valid API key.
403insufficient_scope — the key lacks tests:read.
404Not found, or not visible to the key.
429Rate limit exceeded.