---
title: "GET /charges"
method: GET
path: "/charges"
tags: ["Charges"]
---

# GET /charges

`GET /charges`

Consulta (sonda) de Charges.<br> É obrigatório que ao menos um dos dois parâmetros de identificação da cobrança seja informado (`ids` ou `initiator_ids`).<br> Se os dois forem informados, será usado o identificador da charge.<br><br> A autenticação no endpoint é feita da seguinte forma:
  * **Bearer Token Authorization**: Token JWT.

## Query parameters

- `ids` string[], required
- `initiator_ids` string[], required
- `with_details` string, boolean

## Headers

- `Host` string, required

## Response `200`

OK

- GetChargeResponse
  - `charges` object[]
    - `id` string, required — Identificador da charge
    - `initiator_id` string, required — Identificador externo que pode ser utilizado em reversões
    - `reference_id` string — Identificador externo do pedido
    - `amount` integer, required — Valor da charge em centavos
    - `payment_method` 'card', required — Payment method da charge
    - `status` 'authorized' | 'paid' | 'canceled' | 'declined', required — Status atual da Charge
    - `created_at` string, date-time, required — Data e hora da criação da charge no formato "YYYY-MM-ddTHH:mm:ssZ"
    - `card_transaction` object
      - `type` 'credit' | 'debit' | 'voucher' | 'other', required — Detalhamento de que tipo de cartão está sendo utilizado na charge
      - `transaction_id` string, required — Identificador da transação emitido pelo provedor
      - `funding_source` 'credit' | 'debit' | 'prepaid' — Indicação para o método de liquidação a ser utilizado
      - `authorized_amount` integer, required — Valor autorizado na cobrança, em centavos.
      - `captured_amount` integer, required — Valor capturado na cobrança, em centavos.
      - `canceled_amount` integer, required — Valor cancelado na cobrança, em centavos.
      - `installments` integer — Quantidade de parcelas da cobrança.
      - `statement_descriptor` string — Informação adicional apresentada na filipeta para o comprador final. Em geral o nome fantasia do cliente.
      - `merchant_category_code` string — Código de categoria do lojista ou sublojista relacionado à cobrança.
      - `card` object, required
        - `brand` string — Bandeira do cartão
        - `emv_response` string, binary — EMV
      - `details` object[]
        - `operation` 'authorization' | 'capture' | 'cancel' — Operação feita sobre a charge
        - `operation_id` string
        - `local_datetime` string, date-time
        - `provider_datetime` string, date-time
        - `operation_amount` integer
        - `authorization_code` string
        - `emv_data` string
        - `acquirer_message` string
        - `acquirer_return_code` string
      - `additional_data` object[] — Detalhamento de informações adicionais
        - `name` string, required — Nome da propriedade adicional
        - `value` string, required — Valor da propriedade adicional

## Other responses

- `400` — BadRequest
- `401` — Não autorizado
- `404` — NotFound

---

[API](https://skmtc.dev/stone/apis/payments-processing-acquiring-paymentcardapi.md) · [All operations](https://skmtc.dev/stone/apis/payments-processing-acquiring-paymentcardapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/stone/payments-processing-acquiring-paymentcardapi/revisions/29bc4962fa98/schema)