Openi DeveloperDeveloper
Credit card

Listar transações do cartão

Lista as transações de um cartão de crédito, com paginação e filtros por data.

Endpoint

GET /v1/items/:itemId/credit-cards/:accountId/transactions

Parâmetros da URL:

  • itemId (string, obrigatório): ID do item (UUID v7)
  • accountId (string, obrigatório): ID do cartão

Parâmetros de query (opcionais):

  • page (number): padrão 1
  • limit (number): de 1 a 100. Padrão: 20
  • ids (string, repetível): retorna só essas transações; use com os transactionIds do webhook TRANSACTIONS_CREATED (?ids=a&ids=b)
  • from, to (string, ISO 8601 datetime): filtram pela data da transação

Campos da resposta

  • data.pagination: page, total, totalPages
  • data.transactions: lista de transações
    • id, accountId, billId (fatura à qual pertence, ou null)
    • description, descriptionRaw, status, type, operationType
    • amount, currency, amountInAccountCurrency
    • installmentNumber, installmentTotal, totalAmount, installmentCreatedAt: parcelamento
    • merchant: name, businessName, document, cnae, category, categoryCode
    • cardNumber, paymentMethod, payer, receiver
    • transactionAt, createdAt, updatedAt

Exemplo

curl "https://of.openi.com.br/v1/items/$ITEM_ID/credit-cards/$ACCOUNT_ID/transactions?page=1&limit=50" \
  -H "Authorization: Bearer $OPENI_API_KEY"

On this page