---
title: "Listar cartões"
method: GET
path: "/{companyId}/banking/cards"
tags: ["Cards"]
---

# Listar cartões

`GET /{companyId}/banking/cards`

## Request

- Base URL: `https://api.sandbox.empresas.btgpactual.com`
- URL: `https://api.sandbox.empresas.btgpactual.com/{companyId}/banking/cards`
- Auth: OAuth 2
  - Authorization code: `https://id.empresas.btgpactual.com/oauth2/authorize`
  - Token URL: `https://id.empresas.btgpactual.com/oauth2/token` scopes: `brn:btg:empresas:banking:payroll`

## Path parameters

- `companyId` string, required

## Query parameters

- `itemsPerPage` integer, nullable
- `cursor` string, nullable
- `page` integer, nullable
- `ownerDocument` string, nullable
- `status` string, nullable
- `last4Digits` string, nullable
- `isContactlessEnabled` boolean, nullable
- `isTravelNoticeEnabled` boolean, nullable
- `isOnlineShoppingEnabled` boolean, nullable
- `isWithdrawalEnabled` boolean, nullable
- `printedName` string, nullable
- `order` string, nullable
- `sortBy` string, nullable
- `limitOperator` string, nullable
- `limitAmount` string, nullable

## Response `200`

Success

- GetCardsByAccountAndFiltersResponseV2
  - `data` CardItem[], nullable
    - `cardId` string, nullable: Identificador único do cartão
    - `last4Digits` string, nullable: Últimos 4 dígitos do cartão
    - `status` 'CREATED' | 'REQUESTED', nullable: Status do cartão
    - `printedName` string, nullable: Nome impresso no cartão
    - `modality` 'CREDIT' | 'DEBIT', nullable: Modalidade do cartão
    - `variant` string, nullable: Variante do cartão
    - `activatedAt` string, nullable: Data de ativação do cartão
    - `type` string, nullable: Tipo do cartão
    - `owner` CardOwnerItem
      - `document` string, nullable: CPF or CNPJ do dono do cartão
      - `name` string, nullable: Nome do dono do cartão
      - `birthDate` string, nullable: Data de nascimento do dono do cartão
      - `phone` string, nullable: Telefone do dono do cartão
    - `debitAccount` DebitAccountItem
      - `branch` string, nullable: Agência da conta débito vinculada ao cartão
      - `number` string, nullable: Número da conta débito vinculada ao cartão
  - `_links` Link[]
    - `rel` string
    - `href` string
    - `method` string
    - `type` string

---

[API](https://skmtc.dev/btgpactual/apis/folha-de-pagamentos.md) - [All operations](https://skmtc.dev/btgpactual/apis/folha-de-pagamentos/llms.txt) - [OpenAPI document](https://skmtc.dev/btgpactual/apis/folha-de-pagamentos/revisions/2a24d3da114c?raw)
