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

# GET /charges/{id} — Consultar Cobro

> Retorna el estado actual de un cobro.

Retorna el estado actual de un cobro. Responde con el mismo schema que la creación, con `status` actualizado.

## Headers

| Header      | Tipo   | Req | Descripción          |
| ----------- | ------ | --- | -------------------- |
| `X-API-Key` | string | Sí  | API Key del merchant |

## Path Params

| Parámetro     | Tipo   | Descripción                                                |
| ------------- | ------ | ---------------------------------------------------------- |
| `external_id` | string | El `external_id` o `charge_id` recibido al crear el cobro. |

## Response

Mismo schema que [Crear Cobro](/payments/crypto/crear-cobro#response), con `status` reflejando el estado actual.

| Estado      | Descripción                                              |
| ----------- | -------------------------------------------------------- |
| `created`   | Cobro generado, esperando que el usuario inicie el pago. |
| `pending`   | Pago detectado en la red, esperando confirmaciones.      |
| `completed` | Pago confirmado. Fondos recibidos.                       |
| `expired`   | Superó `expiration_minutes` sin ser pagado.              |
| `cancelled` | Cancelado programáticamente.                             |
| `failed`    | Pago detectado pero rechazado.                           |

<RequestExample>
  ```bash cURL theme={"system"}
  curl https://crypto.cucu.ai/api/v1/merchants/me/charges/CHG-20260125-00042 \
    -H "X-API-Key: sk_live_xxxx"
  ```

  ```javascript JavaScript theme={"system"}
  const response = await fetch(
    'https://crypto.cucu.ai/api/v1/merchants/me/charges/CHG-20260125-00042',
    { headers: { 'X-API-Key': 'sk_live_xxxx' } }
  );
  const data = await response.json();
  ```

  ```python Python theme={"system"}
  import requests

  response = requests.get(
      'https://crypto.cucu.ai/api/v1/merchants/me/charges/CHG-20260125-00042',
      headers={'X-API-Key': 'sk_live_xxxx'}
  )
  print(response.json())
  ```
</RequestExample>

<ResponseExample>
  ```json 200 OK theme={"system"}
  {
    "charge_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "external_id": "CHG-20260125-00042",
    "provider": "cucu_pay",
    "amount": 50.00,
    "currency": "USDT",
    "status": "completed",
    "checkout_url": "https://crypto.cucu.ai/checkout/a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "expires_at": "2026-01-25T15:30:00Z",
    "metadata": {"user_id": "usr_abc123"},
    "created_at": "2026-01-25T15:15:00Z",
    "updated_at": "2026-01-25T15:22:45Z"
  }
  ```

  ```json 404 Not Found theme={"system"}
  {
    "detail": "charge not found"
  }
  ```
</ResponseExample>