# Listar transações

GET /loans/{loan_id}/transactionsLista transações de um empréstimo

Endpoint: GET /loans/{loan_id}/transactions
Version: 2026-03-01
Security: bearerAuth

## Security:

  - `bearerAuth` (unknown)
    http bearer JWT

## Path parameters:

  - `loan_id` (string, required)
    ID do empréstimo

## Query parameters:

  - `starting_after` (string)
    ID prefixado do último item da página anterior

  - `limit` (integer)
    Número de itens a retornar. Mín: 1, Máx: 100

## Response 200:

  - `200` (unknown)
    Lista de transações

## Response 200 fields (application/json):

  - `data` (array, required)

  - `data.id` (string, required)
    Identificador único da transação
    Example: tx_550e8400e29b41d4a716446655440000

  - `data.loan_id` (string, required)
    Identificador único do empréstimo
    Example: ln_550e8400e29b41d4a716446655440000

  - `data.type` (string, required)
    Sempre `installment`
    Enum: "installment"

  - `data.status` (string, required)
    `pending`, `paid`, `overdue` ou `partially_paid`
    Enum: "pending", "paid", "overdue", "partially_paid"

  - `data.due_date` (string, required)
    ISO 8601 · date
Quando esta parcela vence
    Example: 2026-04-03

  - `data.amount_due` (number, required)
    Valor monetário em BRL
    Example: 25000

  - `data.days_overdue` (integer, required)
    Dias em atraso (0 se em dia)

  - `data.paid_at` (integer | null, required)
    Epoch Unix em segundos, `null` se não paga

  - `data.created_at` (integer, required)
    Epoch Unix em segundos

  - `data.updated_at` (integer, required)
    Epoch Unix em segundos

  - `has_more` (boolean, required)

## Response 400:

  - `400` (unknown)
    Requisição inválida

## Response 400 fields (application/problem+json):

  - `type` (string, required)
    Enum: "https://docs.dinie.com/errors/invalid-request"

  - `title` (string, required)
    Enum: "Invalid Request"

  - `status` (integer, required)
    Enum: "400"

  - `detail` (string, required)

  - `code` (string, required)
    Enum: "invalid_limit", "invalid_cursor"

## Response 401:

  - `401` (unknown)
    Falha na autenticação

## Response 401 fields (application/problem+json):

  - `type` (string, required)
    Enum: "https://docs.dinie.com/errors/authentication-failed"

  - `title` (string, required)
    Enum: "Authentication Failed"

  - `status` (integer, required)
    Enum: "401"

  - `detail` (string, required)

  - `code` (string, required)
    Enum: "missing_token", "invalid_token", "token_expired"

## Response 404:

  - `404` (unknown)
    Recurso não encontrado

## Response 404 fields (application/problem+json):

  - `type` (string, required)
    Enum: "https://docs.dinie.com/errors/not-found"

  - `title` (string, required)
    Enum: "Not Found"

  - `status` (integer, required)
    Enum: "404"

  - `detail` (string, required)

  - `code` (string, required)
    Enum: "loan_not_found"

## Response 429:

  - `429` (unknown)
    Limite de requisições excedido

## Response 429 fields (application/problem+json):

  - `type` (string, required)
    Enum: "https://docs.dinie.com/errors/rate-limit-exceeded"

  - `title` (string, required)
    Enum: "Rate Limit Exceeded"

  - `status` (integer, required)
    Enum: "429"

  - `detail` (string, required)

## Response 429 headers (application/problem+json):

  - `Retry-After` (integer)
    Segundos até o limite de requisições ser reiniciado

## Response 500:

  - `500` (unknown)
    Erro interno do servidor

## Response 500 fields (application/problem+json):

  - `type` (string, required)
    Enum: "https://docs.dinie.com/errors/internal"

  - `title` (string, required)
    Enum: "Internal Error"

  - `status` (integer, required)
    Enum: "500"

  - `detail` (string, required)

## Response 400 examples:

  - ``limit` is not a valid integer or is outside 1–100 range` (unknown)

  - ``starting_after` references a non-existent transaction` (unknown)

## Response 401 examples:

  - `Authorization header is missing` (unknown)

  - `Bearer token is invalid or malformed` (unknown)

  - `Bearer token has expired` (unknown)

## Response 404 examples:

  - `Loan ID does not exist or does not belong to this partner` (unknown)