---
title: "Consulta de transações por cartão"
method: GET
path: "/cards/{proxy}/transactions"
tags: ["Consulta de transações"]
---

# Consulta de transações por cartão

`GET /cards/{proxy}/transactions`

<div class="bkly-ref-description">
  <p>Consulte as transações realizadas no cartão de acordo com os filtros informados. <br /> <b>Importante:</b> a diferença entre a data de início e de fim deverá ser de, no máximo, sete dias.</p> 
  <span class="bkly-ref-small-stable-tag">stable</span> 
  <span class="bkly-ref-scope-tag">scope: card.read</span>
</div>

## Path parameters

- `proxy` string, required

## Query parameters

- `page` string — Número da página que se quer consultar. Para realizar a consulta da primeira página, <b>não</b> envie esse parâmetro na requisição.
- `pageSize` string
- `startDate` string, required — Data de início dos eventos a serem pesquisados, no formato yyyy-mm-dd. Caso necessário, poderá ser feito um filtro incluindo o horário, no formato ISO 8601 - UTC. Utilize esse campo em conjunto com o parâmetro <code>endDate</code> para filtrar eventos por um range de datas.
- `endDate` string, required — Data do final dos eventos a serem pesquisados, no formato yyyy-mm-dd. Caso necessário, poderá ser feito um filtro incluindo o horário, no formato ISO 8601 - UTC Utilize esse campo em conjunto com o parâmetro <code>startDate</code> para filtrar eventos por um range de datas.

## Headers

- `api-version` string, required — Versão da API. Atualmente estamos na versão 1.0.
- `Authorization` string, required — <em>Token</em> de autorização do tipo Bearer.

## Response `200`

Recurso encontrado. O retorno trará uma lista de transações pertencentes ao cartão, além das propriedades referentes à paginação da consulta.

- ResultTransactionResponse
  - `nextPage` string — Identificador da próxima página.
  - `hasLastPage` boolean — Indica se existe a próxima página na consulta.
  - `transactions` object[] — Transações do cartão.
    - `account` object — Objeto que contém informações sobre a conta vinculada ao cartão.
      - `number` string — Número da conta para o qual o cartão foi transacionado.
      - `agency` string — Agência da conta para o qual o cartão foi transacionado.
    - `amount` object — Objeto que contém informações sobre o valor da transação.
      - `value` number — Valor total da transação.
      - `local` number — Valor da transação na moeda local.
      - `net` number — Valor líquido da transação.
      - `iof` number — Valor do Imposto de Operações Financeiras.
      - `markup` number — Tarifa de conversão de moeda em caso de compras internacionais.
    - `merchant` object — Objeto que contém informações sobre o local em que ocorreu a transação.
      - `id` string — Identificador do comerciante.
      - `name` string — Nome do comerciante.
      - `mcc` string — MCC (Merchant Category Code) é um número de quatro dígitos listado na ISO 18245 para serviços financeiros de varejo.
      - `city` string — Cidade onde ocorreu a transação.
    - `authorizationCode` string — Identificador da transação na adquirente.
    - `countryCode` string — Código do país onde ocorreu a transação.
    - `currencyCode` string — Código da moeda em que foi realizada a transação.
    - `entryMode` 'Unknown' | 'Manual' | 'MagneticStripe' | 'BarCodeReader' | 'OCR' | 'Chip' | 'ContactlessObsolete' | 'ContactlessMChip' | 'ContactlessMChipObsolete' | 'EletronicCommerce' | 'CredentialOnFile' | 'HybridTerminalFailedConnection' | 'ChipCapableTerminal' | 'EletronicCommerceSecureWithUCAF' | 'Server' | 'MagneticStripeFullTrackData' | 'ContactlessMagneticStripe' | 'ContactlessInput' | 'Visa'
    - `status` 'TransactionHoldWasReproved' | 'TransactionHoldWasApproved' | 'TransactionWasReversed' | 'TransactionHoldWasExpired' | 'TransactionWasConfirmed' | 'TransactionWasReversedInSecondInstance' | 'TransactionVoucherWasCreated'
    - `transactionTimestamp` string — Data em que ocorreu a transação (formato ISO 8601 - UTC).
    - `transactionType` 'Unknown' | 'Purchase' | 'Withdrawal' | 'Refund' | 'Balance'

## Other responses

- `204` — Não há transações para o cartão fornecido.
- `400` — unresolved $ref
- `401` — unresolved $ref
- `500` — unresolved $ref

---

[API](https://skmtc.net/bankly/apis/autentica-o.md) · [All operations](https://skmtc.net/bankly/apis/autentica-o/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bankly/autentica-o/revisions/e20afa10cd0e/schema)