---
title: "Get Public Charge"
method: GET
path: "/api/v1/payments/charges/{charge_id}"
tags: ["payments-api"]
---

# Get Public Charge

`GET /api/v1/payments/charges/{charge_id}`

## Request

- Base URL: `https://www.elocuenti.com`
- URL: `https://www.elocuenti.com/api/v1/payments/charges/{charge_id}`
- Auth: HTTP bearer

## Path parameters

- `charge_id` string, required

## Response `200`

Successful Response

- ChargeResponse
  - `data` Charge, required: A charge. Creation answers the first block; reads add the fields after `terms`.
    - `id` string, required
    - `status` string, required: pending, paid, failed, expired or cancelled.
    - `payment_url` string, nullable, required: Link to send the payer: Elopay Checkout (https://elopay.elocuenti.com/c/<id>). Links issued before (https://www.elocuenti.com/api/payments/pay/<id>) redirect to it.
    - `methods` ChargeMethods, required
      - `checkout` ChargeCheckout, required
        - `url` string, nullable, required
        - `account` string, nullable, required
      - `nequi_only` object, nullable, required: Only on creation with `method_hint: nequi`: transaction_id, status, phone_masked.
      - `qr` object, nullable, required: Only on creation with `method_hint: qr`: transaction_id, image.
    - `expires_at` string, nullable, required
    - `amounts` ChargeAmounts, required
      - `amount_in_cents` integer, nullable, required
      - `provider_fee_cents` integer, nullable, required: Always null.
      - `platform_commission_cents` integer, nullable, required
      - `tenant_net_cents` integer, nullable, required: What reaches your account.
    - `terms` ChargeTerms, required
      - `privacy_url` string, nullable, required
      - `personal_auth_url` string, nullable, required
    - `external_reference` string, nullable
    - `payment_method` string, nullable
    - `paid_at` string, nullable
    - `provider_transaction_id` string, nullable
    - `created_at` string, nullable
  - `request_id` string, nullable

## Other responses

- `401`: No autenticado: falta la credencial, es inválida o expiró.
- `403`: Autenticado, pero sin permiso sobre este recurso o tenant.
- `404`: El recurso referenciado no existe (o no es visible para este tenant).
- `422`: Validation Error
- `429`: Se superó el límite de peticiones del API key o de la IP.
- `500`: Error interno no recuperable por el cliente.

---

[API](https://skmtc.dev/elocuenti/apis/elocuenti-api.md) · [All operations](https://skmtc.dev/elocuenti/apis/elocuenti-api/llms.txt) · [OpenAPI document](https://skmtc.dev/elocuenti/apis/elocuenti-api/revisions/633c2767ac8a?raw)
