---
title: "Describe a synthetic agent test"
method: GET
path: "/v1/tests/case"
tags: ["agent-testing", "synthetic", "timeline"]
---

# Describe a synthetic agent test

`GET /v1/tests/case`

## Request

- Base URL: `https://api.402rates.com`
- URL: `https://api.402rates.com/v1/tests/case`
- Auth: none declared

Free description of a versioned synthetic task, its limits and coverage. Optional case selection; omitted selection describes the original confirmation case. No run, payment or wallet.

## Query parameters

- `case_id` string: Versioned synthetic case identifier.
- `case_version` string: Optional exact case version. A new run defaults to the current published version; a linked repeat retains its previous version. The resolved version is returned and stored.
- `variant` string: Budget case: budget_first or attempts_first. Linked repeats retain the previous variant.

## Response `200`

Successful response

- object

## Other responses

- `400`: Invalid test input
- `401`: Run token required or invalid
- `409`: Run or action conflict
- `410`: Run no longer available
- `429`: Test limit reached
- `503`: Test service unavailable

---

[API](https://skmtc.dev/402rates/apis/402rates-com.md) · [All operations](https://skmtc.dev/402rates/apis/402rates-com/llms.txt) · [OpenAPI document](https://skmtc.dev/402rates/apis/402rates-com/revisions/483a9d0a3f0b?raw)