Skip to main content
GET
/
transactions
Listar Transações
curl --request GET \
  --url https://api.example.com/transactions \
  --header 'Authorization: <authorization>'
{
  "status": true,
  "data": [
    {}
  ],
  "data[].id": "<string>",
  "data[].amount": 123,
  "data[].method": "<string>",
  "data[].status": "<string>",
  "data[].createdAt": "<string>",
  "count": 123,
  "nextCursor": "<string>"
}
Retorna uma lista paginada de transações do seller autenticado. Suporta paginação por offset e por cursor, além de multiplos filtros.
​
Authorization
string
required
API Key no formato Bearer sk_live_... ou Bearer sk_test_...
​
take
number
default:"10"
Número de transações por página. Max recomendado: 100.
​
skip
number
default:"0"
Número de transações a pular (offset). Ignorado quando cursor e informado.
​
cursor
string
Cursor para paginação baseada em cursor. Informe o nextCursor retornado pela página anterior. Mais eficiente que offset para grandes volumes.
​
status
string
Filtro por status. Aceita valor único (ex: PAID) ou multiplos separados por virgula (ex: CHARGEDBACK,REFUNDED).Valores: PENDING, PROCESSING, AUTHORIZED, PAID, REFUSED, FAILED, REFUNDED, CHARGEDBACK
​
method
string
Filtro por método de pagamento. Valores: PIX, BOLETO, CREDIT_CARD, CRYPTO.
​
transactionId
string
Buscar por ID exato de transação.
​
metadataKey
string
Chave do campo de metadata para busca. Use com metadataValue.Exemplo: pedidoId
​
metadataValue
string
Valor do metadata a buscar. Quando combinado com metadataKey, usa busca JSONB exata (indexada).Exemplo: ORD-2024-001
​
export
boolean
default:"false"
Quando true, retorna o resultado como arquivo CSV para download em vez de JSON.

​
Resposta

​
status
boolean
true quando a lista e retornada com sucesso.
​
data
array
Array de transações.
​
data[].id
string
Identificador único da transação.
​
data[].amount
integer
Valor em centavos.
​
data[].method
string
Método de pagamento.
​
data[].status
string
Status atual da transação.
​
data[].createdAt
string
Data/hora de criacao (ISO 8601).
​
count
integer
Total de transações que correspondem aos filtros.
​
nextCursor
string
Cursor para a próxima página (quando disponível). Use em cursor na próxima requisicao.
curl -X GET "https://api.linka.com/transactions?take=20&status=PAID&method=PIX" \
  -H "Authorization: Bearer <token>"

​
Exemplo de resposta

{
  "status": true,
  "data": [
    {
      "id": "clxyz1234abcdef",
      "amount": 15000,
      "method": "PIX",
      "status": "PAID",
      "createdAt": "2026-03-06T10:00:00.000Z"
    }
  ],
  "count": 1,
  "nextCursor": null
}