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

# Get Acceptance Rate

> GET /api/enrichment/acceptance-rate

<Info>**`GET /api/enrichment/acceptance-rate`** · Scope: `catalog:read`</Info>

Returns acceptance metrics for the proposals your API client has submitted for the merchant
organization, optionally windowed by review time.

## Query parameters

<ParamField query="since" type="string">Only count proposals reviewed after this moment (epoch millis or ISO-8601). Not-yet-reviewed proposals are matched by submission time.</ParamField>
<ParamField query="until" type="string">Only count proposals reviewed before this moment.</ParamField>

## Request

```bash theme={null}
curl "https://api.verzla.com/api/enrichment/acceptance-rate?since=2026-06-01T00:00:00Z" \
  -H "X-Api-Client-Key: sk_live_your_key_here"
```

## Response `200`

<ResponseField name="totalSubmitted" type="number">All proposals submitted in the window.</ResponseField>
<ResponseField name="reviewed" type="number">Proposals accepted or rejected.</ResponseField>
<ResponseField name="accepted" type="number">Proposals where at least one field was applied (full or partial approval).</ResponseField>
<ResponseField name="rejected" type="number">Proposals rejected in full.</ResponseField>
<ResponseField name="pending" type="number">Proposals still awaiting review.</ResponseField>
<ResponseField name="acceptanceRate" type="number">`accepted / reviewed`, as a 0–1 fraction rounded to four decimals (`0` when nothing has been reviewed).</ResponseField>

<ResponseField name="byConfidenceBand" type="object[]">
  Per-confidence-band breakdown: `{ band, reviewed, accepted, acceptanceRate }`. Bands are `0-49`,
  `50-79`, `80-100`; proposals sent without a `confidence` are excluded from the bands.
</ResponseField>

```json theme={null}
{
  "totalSubmitted": 12840,
  "reviewed": 11020,
  "accepted": 9460,
  "rejected": 1560,
  "pending": 1820,
  "acceptanceRate": 0.8585,
  "byConfidenceBand": [
    { "band": "0-49",   "reviewed": 1400, "accepted": 700,  "acceptanceRate": 0.5000 },
    { "band": "50-79",  "reviewed": 3600, "accepted": 2880, "acceptanceRate": 0.8000 },
    { "band": "80-100", "reviewed": 6020, "accepted": 5880, "acceptanceRate": 0.9767 }
  ]
}
```

## Errors

| Status | When                       |
| ------ | -------------------------- |
| `401`  | Missing or invalid API key |
| `403`  | Key lacks `catalog:read`   |