# Get a test

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

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

## Path parameters

| Parameter | Type | Description |
| --- | --- | --- |
| `id` | string | The test id. |

## Example request

```bash
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](/docs/api/pipeline/tests-list/)).

## Status codes

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