> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agentcard.sh/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.

<ParamField body="cases" type="array" required>1 to 1,000 cases with unique `id`s.</ParamField>
<ParamField body="cases[].id" type="string" required>Your label for the case.</ParamField>
<ParamField body="cases[].request_url" type="string" required>The processor URL the checkout page called.</ParamField>
<ParamField body="cases[].method" type="string">Default `POST`.</ParamField>
<ParamField body="cases[].scenario" type="string">`one_time` (default), `save_card`, `subscription_initial`, `subscription_renewal`.</ParamField>
<ParamField body="cases[].weight" type="number">Relative checkout traffic. Default 1.</ParamField>
<ParamField body="cases[].requires_3ds" type="boolean">Default false.</ParamField>

<RequestExample>
  ```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 }
      ]
    }'
  ```
</RequestExample>

<ResponseExample>
  ```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" }
    ]
  }
  ```
</ResponseExample>

<ResponseField name="results[].status" type="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).</ResponseField>
<ResponseField name="purchase_success_rate" type="null">Always null. Endpoint recognition is not a purchase test.</ResponseField>