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

# Check Payment Status

Look up a payment by its `checkout_id` (the `id` returned when you created the checkout). Returns one of `pending`, `completed`, `failed`, or `refunded`.

<CodeGroup>
  ```bash cURL theme={null}
  curl --request GET \
    --url https://api.privexpay.com/api-payments/b3f1c2d4-7e8a-4d2b-9f1c-1234567890ab \
    --header 'x-api-key: pp_live_your_api_key'
  ```

  ```javascript Node.js theme={null}
  const response = await fetch('https://api.privexpay.com/api-payments/b3f1c2d4-7e8a-4d2b-9f1c-1234567890ab', {
    headers: { 'x-api-key': 'pp_live_your_api_key' },
  });
  const { data } = await response.json();
  console.log(data.payment_status); // 'completed', 'pending', 'failed', 'refunded'
  ```
</CodeGroup>

Example Response:

<CodeGroup>
  ```json Response theme={null}
  {
    "data": {
      "checkout_id": "b3f1c2d4-7e8a-4d2b-9f1c-1234567890ab",
      "payment_status": "completed",
      "amount": 69.97,
      "currency": "USD",
      "created_at": "2026-05-11T12:00:00Z"
    }
  }
  ```
</CodeGroup>