> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agentcard.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Assess checkout cases

> Label up to 1,000 observed processor requests as recognized, unsupported, or unverified before you build.

Send the processor endpoints your automation observed at your target merchants, without card data or request bodies. Each case comes back labelled, with a weighted share of your traffic the Vault recognizes.

**cases** `array` *required*

1 to 1,000 cases with unique `id`s.

**cases\[].id** `string` *required*

Your label for the case.

**cases\[].request\_url** `string` *required*

The processor URL the checkout page called.

**cases\[].method** `string`

Default `POST`.

**cases\[].scenario** `string`

`one_time` (default), `save_card`, `subscription_initial`, `subscription_renewal`.

**cases\[].weight** `number`

Relative checkout traffic. Default 1.

**cases\[].requires\_3ds** `boolean`

Default false.

```bash cURL theme={null}
curl -X POST https://api.agentcard.sh/api/v2/checkout/coverage/assess \
  -H "Authorization: Bearer $ORG_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "cases": [
      { "id": "merchant-a-one-time", "request_url": "https://api.stripe.com/v1/payment_methods", "method": "POST", "scenario": "one_time", "weight": 40, "requires_3ds": true }
    ]
  }'
```

```json 200 theme={null}
{
  "object": "checkout_coverage_assessment",
  "recognized_traffic_share": 1,
  "purchase_success_rate": null,
  "counts": { "recognized": 1, "unsupported": 0, "unverified": 0 },
  "results": [
    { "id": "merchant-a-one-time", "status": "recognized", "reason": "request_format_recognized_not_purchase_verified", "psp": "stripe", "mode": "token", "next_action": "validate_checkout" }
  ]
}
```

**results\[].status** `string`

`recognized` (a known processor request format), `unsupported` (for example an iframe-bound VGS tokenization or a non-POST), or `unverified` (a renewal the merchant bills itself, or a format the registry does not know).

**purchase\_success\_rate** `null`

Always null. Endpoint recognition is not a purchase test.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.