---
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`

## Request

- Base URL: `https://api-mtls.sandbox.bankly.com.br`
- URL: `https://api-mtls.sandbox.bankly.com.br/cards/{proxy}/transactions`
- Auth: HTTP bearer

<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.dev/bankly/apis/gest-o-de-cart-es.md) - [All operations](https://skmtc.dev/bankly/apis/gest-o-de-cart-es/llms.txt) - [OpenAPI document](https://skmtc.dev/bankly/apis/gest-o-de-cart-es/revisions/1116211d65a0?raw)