BTG Pactual Cartões API

The Cartões API from BTG Pactual — 1 operation(s) for cartões.

Operations 1

GET /{companyId}/banking/cards Get by company id banking cards #

Documentation

📖
Documentation
https://developers.empresas.btgpactual.com/docs/api-specs-target/Acquirers%20-%20PaymentLink/acquirers-paymentlink
📖
Documentation
https://developers.empresas.btgpactual.com/docs/api-specs-target/Acquirers%20-%20Salesprovider/acquirers-salesprovider
📖
Documentation
https://developers.empresas.btgpactual.com/docs/api-specs-target/ANTECRED-Subcredenciadores/antecred-subcredenciadores
📖
Documentation
https://developers.empresas.btgpactual.com/docs/api-specs-target/Banking%20-%20Accounts/banking-accounts
📖
Documentation
https://developers.empresas.btgpactual.com/docs/api-specs-target/Banking%20-%20Cards/banking-cards
📖
Documentation
https://developers.empresas.btgpactual.com/docs/api-specs-target/Banking%20-%20CCReceivables/banking-ccreceivables
📖
Documentation
https://developers.empresas.btgpactual.com/docs/api-specs-target/Banking%20-%20Collections/banking-collections
📖
Documentation
https://developers.empresas.btgpactual.com/docs/api-specs-target/Banking%20-%20DDA/banking-dda
📖
Documentation
https://developers.empresas.btgpactual.com/docs/api-specs-target/Banking%20-%20PaymentLink/banking-paymentlink
📖
Documentation
https://developers.empresas.btgpactual.com/docs/api-specs-target/Banking%20-%20PaymentLinkRec/banking-paymentlinkrec
📖
Documentation
https://developers.empresas.btgpactual.com/docs/api-specs-target/Banking%20-%20Payments/banking-payments
📖
Documentation
https://developers.empresas.btgpactual.com/docs/api-specs-target/Banking%20-%20Payroll/banking-payroll
📖
Documentation
https://developers.empresas.btgpactual.com/docs/api-specs-target/Banking%20-%20Pix%20Autom%5Cxe1tico/banking-pix-automatico
📖
Documentation
https://developers.empresas.btgpactual.com/docs/api-specs-target/Banking%20-%20PixCashin/banking-pixcashin
📖
Documentation
https://developers.empresas.btgpactual.com/docs/api-specs-target/Banking%20-%20Protest/banking-protest
📖
Documentation
https://developers.empresas.btgpactual.com/docs/api-specs-target/Banking%20-%20Split/banking-split
📖
Documentation
https://developers.empresas.btgpactual.com/docs/api-specs-target/BankingHub%20-%20Open%20Finance%20Balance%20Refresh/bankinghub-open-finance-balance-refresh
📖
Documentation
https://developers.empresas.btgpactual.com/docs/api-specs-target/CrediFlow%20-%20Ativos%20e%20Cess%5Cxf5es/crediflow-ativos-e-cessoes
📖
Documentation
https://developers.empresas.btgpactual.com/docs/api-specs-target/FIDC%20-%20Consignado%20Privado/fidc-consignado-privado
📖
Documentation
https://developers.empresas.btgpactual.com/docs/api-specs-target/FIDC%20-%20Credit%20Conciliation/fidc-credit-conciliation
📖
Documentation
https://developers.empresas.btgpactual.com/docs/api-specs-target/FIDC%20-%20Document/fidc-document
📖
Documentation
https://developers.empresas.btgpactual.com/docs/api-specs-target/FIDC%20-%20Eligibility/fidc-eligibility
📖
Documentation
https://developers.empresas.btgpactual.com/docs/api-specs-target/FIDC%20-%20Motor%20de%20Credito/fidc-motor-de-credito
📖
Documentation
https://developers.empresas.btgpactual.com/docs/api-specs-target/FIDC%20-%20Operation/fidc-operation
📖
Documentation
https://developers.empresas.btgpactual.com/docs/api-specs-target/FIDC%20-%20Payment/fidc-payment
📖
Documentation
https://developers.empresas.btgpactual.com/docs/api-specs-target/FIDC%20-%20Portability/fidc-portability
📖
Documentation
https://developers.empresas.btgpactual.com/docs/api-specs-target/FIDC%20-%20Prepayment/fidc-prepayment
📖
Documentation
https://developers.empresas.btgpactual.com/docs/api-specs-target/FIDC%20-%20Renegotiation/fidc-renegotiation
📖
Documentation
https://developers.empresas.btgpactual.com/docs/api-specs-target/FIDC%20-%20Simulation/fidc-simulation
📖
Documentation
https://developers.empresas.btgpactual.com/docs/api-specs-target/FIDC%20-%20Wallet/fidc-wallet
📖
Documentation
https://developers.empresas.btgpactual.com/docs/api-specs-target/FIDC%20-%20Warranty/fidc-warranty
📖
Documentation
https://developers.empresas.btgpactual.com/docs/api-specs-target/Files/files
📖
Documentation
https://developers.empresas.btgpactual.com/docs/api-specs-target/HUBFX%20-%20Cambio/hubfx-cambio
📖
Documentation
https://developers.empresas.btgpactual.com/docs/api-specs-target/KGIRO%20-%20Leads%20de%20Cr%5Cxe9dito/kgiro-leads-de-credito
📖
Documentation
https://developers.empresas.btgpactual.com/docs/api-specs-target/Onboarding/onboarding
📖
Documentation
https://developers.empresas.btgpactual.com/docs/api-specs-target/SCF%20-%20Colombia/scf-colombia
📖
Documentation
https://developers.empresas.btgpactual.com/docs/api-specs-target/SCF%20-%20Risco%20Sacado/scf-risco-sacado
📖
Documentation
https://developers.empresas.btgpactual.com/docs/api-specs-target/SCF-Financiers-Supplier/scf-financiers-supplier
📖
Documentation
https://developers.empresas.btgpactual.com/docs/api-specs-target/Solar-CreditAnalysis/solar-creditanalysis
📖
Documentation
https://developers.empresas.btgpactual.com/docs/api-specs-target/Solar-Workflow/solar-workflow
📖
Documentation
https://developers.empresas.btgpactual.com/docs/api-specs-target/Webhooks/webhooks

Specifications

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/btg-pactual:btg-pactual-cart-es-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

btg-pactual-cart-es-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Banking - Cards Cartões API
  description: API de Cartão de Crédito
  contact: {}
  version: '1.0'
servers:
- url: https://api.sandbox.empresas.btgpactual.com
  description: Sandbox
- url: https://api.empresas.btgpactual.com
  description: Produção
tags:
- name: Cartões
paths:
  /{companyId}/banking/cards:
    get:
      tags:
      - Cartões
      description: '## 📘 Ambiente de sandbox

        > Esta API utiliza o Wiremock


        > No sandbox este endpoint requer a utilização de Sandbox Headers


        | Header | Descrição | Valores Aceitos |

        | :--------- | :----------------------------------- | :-------------- |

        | x-response | Controlar o tipo de resposta da API. | success ou error |'
      parameters:
      - name: companyId
        in: path
        required: true
        schema:
          type: string
        description: CNPJ da empresa
        example: '30306294000145'
      - name: itemsPerPage
        in: query
        schema:
          type:
          - integer
          - 'null'
          format: int32
        description: Número de itens por página
        example: 50
      - name: cursor
        in: query
        schema:
          type:
          - string
          - 'null'
        description: Cursor para paginação dos resultados
      - name: page
        in: query
        schema:
          type:
          - integer
          - 'null'
          format: int32
        example: 1
        description: Número da página
      - name: ownerDocument
        in: query
        schema:
          type:
          - string
          - 'null'
        description: CPF ou CNPJ do dono do cartão
        example: '11111111111'
      - name: status
        in: query
        schema:
          type:
          - string
          - 'null'
        description: Status do cartão
        example: REQUESTED
      - name: last4Digits
        in: query
        schema:
          type:
          - string
          - 'null'
        example: '1234'
        description: Últimos 4 dígitos do cartão
      - name: isContactlessEnabled
        in: query
        schema:
          type:
          - boolean
          - 'null'
        description: Indica se o cartão tem aproximação habilitada
        example: true
      - name: isTravelNoticeEnabled
        in: query
        schema:
          type:
          - boolean
          - 'null'
        example: false
        description: Indica se o aviso de viagem está habilitado
      - name: isOnlineShoppingEnabled
        in: query
        schema:
          type:
          - boolean
          - 'null'
        example: true
        description: Indica se compras online estão habilitadas
      - name: isWithdrawalEnabled
        in: query
        schema:
          type:
          - boolean
          - 'null'
        example: false
        description: Indica se saques estão habilitados
      - name: printedName
        in: query
        schema:
          type:
          - string
          - 'null'
        example: JOAO DA SILVA
        description: Nome impresso no cartão
      - name: order
        in: query
        schema:
          type:
          - string
          - 'null'
        description: Ordem de exibição dos resultados
      - name: sortBy
        in: query
        schema:
          type:
          - string
          - 'null'
        description: Campo para ordenação dos resultados
      - name: limitOperator
        in: query
        schema:
          type:
          - string
          - 'null'
        description: Operador para filtro de limite do cartão
      - name: limitAmount
        in: query
        schema:
          type:
          - string
          - 'null'
        description: Valor para filtro de limite do cartão
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type:
                    - array
                    - 'null'
                    items:
                      type: object
                      properties:
                        cardId:
                          type:
                          - string
                          - 'null'
                          example: f47d235c-17de-4e4b-87eb-a60208acf11f
                          description: Identificador único do cartão
                        last4Digits:
                          type:
                          - string
                          - 'null'
                          example: '1234'
                          description: Últimos 4 dígitos do cartão
                        status:
                          type:
                          - string
                          - 'null'
                          enum:
                          - CREATED
                          - REQUESTED
                          example: REQUESTED
                          description: Status do cartão
                        printedName:
                          type:
                          - string
                          - 'null'
                          example: JOAO DA SILVA
                          description: Nome impresso no cartão
                        modality:
                          type:
                          - string
                          - 'null'
                          enum:
                          - CREDIT
                          - DEBIT
                          example: DEBIT
                          description: Modalidade do cartão
                        variant:
                          type:
                          - string
                          - 'null'
                          example: GOLD
                          description: Variante do cartão
                        activatedAt:
                          type:
                          - string
                          - 'null'
                          example: '2023-01-15'
                          description: Data de ativação do cartão
                        type:
                          type:
                          - string
                          - 'null'
                          example: PHYSICAL
                          description: Tipo do cartão
                        owner:
                          type: object
                          properties:
                            document:
                              type:
                              - string
                              - 'null'
                              example: '11111111111'
                              description: CPF or CNPJ do dono do cartão
                            name:
                              type:
                              - string
                              - 'null'
                              example: JOAO DA SILVA
                              description: Nome do dono do cartão
                            birthDate:
                              type:
                              - string
                              - 'null'
                              example: '1980-01-01'
                              description: Data de nascimento do dono do cartão
                            phone:
                              type:
                              - string
                              - 'null'
                              example: '+5511999999999'
                              description: Telefone do dono do cartão
                          additionalProperties: false
                          title: CardOwnerItem
                        debitAccount:
                          type: object
                          properties:
                            branch:
                              type:
                              - string
                              - 'null'
                              example: '50'
                              description: Agência da conta débito vinculada ao cartão
                            number:
                              type:
                              - string
                              - 'null'
                              example: 12345-6
                              description: Número da conta débito vinculada ao cartão
                          additionalProperties: false
                          title: DebitAccountItem
                      additionalProperties: false
                      title: CardItem
                  _links:
                    type: object
                    properties:
                      next:
                        type:
                        - string
                        - 'null'
                      previous:
                        type:
                        - string
                        - 'null'
                    additionalProperties: false
                    title: Links
                additionalProperties: false
                title: GetCardsByAccountAndFiltersResponseV2
      security:
      - read:
        - brn:btg:empresas:credit-cards:invoices
      x-docs-url: https://developers.empresas.btgpactual.com/docs/api-specs-target/Banking%20-%20Cards/listar-cartoes
      summary: Get by company id banking cards
      x-summary-source: derived
      operationId: getByCompanyIdBankingCards
      x-operation-id-source: derived
components:
  securitySchemes:
    read:
      type: oauth2
      flows:
        clientCredentials:
          tokenUrl: https://id.btgpactual.com/oauth2/token
          scopes:
            brn:btg:empresas:credit-cards:invoices: Consultar faturas de cartão de crédito
x-reassembled-from:
  source: https://developers.empresas.btgpactual.com/docs/api-specs-target/
  method: Operation objects decoded verbatim from the "api" payload that the provider's Docusaurus OpenAPI docs embed in each reference page chunk (/assets/js/*.js); grouped by info.title; jsonRequestBodyExample and postman keys dropped.
  chunks:
  - https://developers.empresas.btgpactual.com/assets/js/77773214.ad4c8d3a.js
  - https://developers.empresas.btgpactual.com/assets/js/532021f6.4e301274.js
  - https://developers.empresas.btgpactual.com/assets/js/c471b1dd.e2583128.js
  - https://developers.empresas.btgpactual.com/assets/js/ce171c97.3cc3c506.js