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

# Method status

> Operational health of a payment method, so you can adapt your interface.

```
GET /utils/status/payment/method/{methodCode}/{countryCode}
```

Returns how a payment method has been behaving in a country over a recent window. Use it to
hide or de-prioritise a method in your own interface while it is struggling, instead of
letting payers pick something that is going to fail.

`methodCode` is a code you obtained from the
[methods discovery endpoint](/payments/custom-checkout). An unknown method or country
returns `404`.

<CodeGroup>
  ```bash cURL theme={null}
  curl https://api.orqex.com/v1/utils/status/payment/method/test/US \
    -H "Authorization: Bearer sk_sandbox_..."
  ```

  ```php PHP theme={null}
  $response = $orqex->request('GET', '/utils/status/payment/method/test/US');

  $status = $response->json['data']['status'];
  ```
</CodeGroup>

```json theme={null}
{
  "data": {
    "method": "test",
    "country": "US",
    "status": "operational"
  },
  "meta": {
    "environment": "sandbox",
    "window_minutes": 60,
    "generated_at": "2026-08-02T14:30:00+00:00",
    "ttl_seconds": 300
  }
}
```

## Status values

| Status        | Meaning                                                      |
| ------------- | ------------------------------------------------------------ |
| `operational` | Working normally.                                            |
| `degraded`    | Available, but succeeding less often than usual.             |
| `down`        | Not currently accepting payments.                            |
| `available`   | Configured and usable, with no recent signal to judge it on. |
| `unavailable` | Not available in this environment and country.               |

Treat `degraded` and `down` as a reason to warn or steer, not as a hard block: the payment
may still succeed.

## Meta

| Field            | Description                                                       |
| ---------------- | ----------------------------------------------------------------- |
| `environment`    | The environment the status was computed for, taken from your key. |
| `window_minutes` | Length of the observation window.                                 |
| `generated_at`   | When the snapshot was produced.                                   |
| `ttl_seconds`    | How long you can safely cache the answer.                         |

Respect `ttl_seconds`: the result is already cached server-side, so polling faster gains you
nothing and counts against your [rate limit](/api-conventions#rate-limits).