> This page is for Internet banking (beta).

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.api.corpx.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.api.corpx.com/_mcp/server.

# Retrieve account statement

GET https://client.api.corpx.com/v1/accounts/{accountId}/statement

Returns the account statement (transaction list). The response is always a list payload with `items`, `totalElements`, `totalPages`, `page`, `size`, `hasNext`, `hasPrevious`.

**Exact lookups**: `endToEndId` (PIX end-to-end ID) or `identifier` (integrator reference) queries the settlement bank for that PIX and returns a list with 0 or 1 item. When both are sent, `identifier` is tried first and `endToEndId` is used if it finds nothing. When either is set, pagination and filters are ignored. A transaction that does not exist returns `200` with `items: []`.

**List with filters**: omit both `endToEndId` and `identifier` to get a paginated list. Filtering is **server-side only**: use `startDate`/`endDate`, `operation` (PIX, TED, BOLETO, INTERNAL\_TRANSFER, FEE) and `order`.

**Page size is a maximum, not a guaranteed count.** `size` / `itemsPage` is the ceiling for the page (max 100; a larger value is capped). `items` may contain fewer entries than requested (some rows are omitted after the settlement bank paginates). Advance with `hasNext`; do not assume `len(items) == size`. `totalElements` / `totalPages` follow the settlement bank's pagination and may be approximate, especially with `operation=FEE`.

**Ordering is by instant, with one-second resolution.** The settlement bank does not guarantee a stable tie-break when several entries share the same second, and a new entry (or a refund stamped on the original instant) can shift later pages. Prefer `order=asc`, page until `hasNext` is false, and dedupe by `endToEndId` or `partnerId`. For real-time credits, subscribe to webhooks (`pix.in.completed`, `pix.refund.received`, `transfer.internal.in`) instead of polling. `GET /v1/accounts/{accountId}/statement/advanced` resumes by cursor.

**PIX refunds.** A refund line has `reversal: true`, `partnerType: PIX_REFUND` and `originalEndToEnd` (the PIX being refunded). `operation` stays `PIX`. The original PIX, once refunded, carries `refundEndToEnd` (the refund's end-to-end), including a partial refund. A refund we initiated may repeat the original end-to-end in both `endToEndId` and `originalEndToEnd`.

**Presentation only.** `description`, party names and party documents can be rewritten (or a row omitted) for display. `amount` and the account balance never change. Operational credits from CorpX show as `LANÇAMENTO DE CRÉDITO`, not as a tariff refund. Real fees (`fee-*` / `tarifario-fee-*`) stay TARIFA / ESTORNO DE TARIFA. A debit to a fee account without those prefixes (CorpX fees before September 2026 and manual entries `bcorpx-lanc-*`) also shows as TARIFA. Commissions (`tarifario-com*`, or text containing "comissão") show as `LANÇAMENTO DE CRÉDITO` on credit and `TARIFA` on debit, and stay an internal transfer. The fee-account party name is always `TARIFA` (never CorpX or the provider's legal name). If presentation rules have never loaded, the call fails with `503 statement_rules_unavailable`.

Reference: https://docs.api.corpx.com/ib/referencia/accounts/get-account-statement

## Authentication

- `Authorization` header (bearer token, required) — Bearer authentication of the form `Bearer <token>`, where token is your auth token.

## Request

### Path parameters

- `accountId` (string, required) — Account identifier.

### Query parameters

- `endToEndId` (string, optional) — PIX end-to-end ID. Returns a list with 0 or 1 item.
- `identifier` (string, optional) — Integrator reference (payment/QR identifier). Returns a list with 0 or 1 item; tried before `endToEndId` when both are sent.
- `page` (integer, optional, default: 0) — Zero-based page index. `page=0` is the first page and `page=1` is the second — they are different pages. Ignored when endToEndId or identifier is set.
- `size` (integer, optional) — Page size (max 100). A larger value is capped at 100. This is a ceiling: `items` may have fewer entries than `size`. Ignored when endToEndId or identifier is set.
- `startDate` (date, optional) — Inclusive start date filter (list only).
- `endDate` (date, optional) — Inclusive end date filter (list only).
- `operation` (enum, optional) — Filter by operation type (list only; server-side). Counts may be approximate.
  - Allowed values: `PIX`, `TED`, `BOLETO`, `INTERNAL_TRANSFER`
- `order` (enum, optional, default: desc) — Sort by transaction instant (`asc` oldest first, `desc` newest first, default `desc`). Resolution is one second and there is no guaranteed tie-break when several entries share that second. Prefer `asc` and dedupe by `endToEndId` or `partnerId`.
  - Allowed values: `asc`, `desc`

### Headers

- `X-Tenant-Id` (string, required) — Tenant context used for authorization and routing.
- `X-Request-Timestamp` (string, required) — Unix seconds. Required on the signed host; tolerance is 300s either way (`403 request_timestamp_skew`).
- `X-Content-SHA256` (string, required) — Lowercase hex SHA-256 of the body. An empty body hashes the empty string, so the header is always present. Mismatch returns `400 body_hash_mismatch`.
- `X-Request-Signature` (string, required) — Detached JWS (`<protected>..<signature>`, ES256 or PS256) over `METHOD\nPATH?QUERY\nTIMESTAMP\nIDEMPOTENCY_KEY_OR_EMPTY\nX_CONTENT_SHA256`.

## Response

### 200

Account statement retrieved.

- `accountId` (string, required)
- `items` (list of AccountStatementEntry, required) — Page of statement rows. Length may be less than `size`.
- `tenantId` (string, optional)
- `source` (string, optional)
- `startDate` (date, optional)
- `endDate` (date, optional)
- `page` (integer, optional) — Zero-based page index.
- `size` (integer, optional) — Requested page size (ceiling). `items` may be shorter.
- `totalElements` (integer, optional) — Total lines in the settlement-bank statement window. Approximate when rows are omitted after pagination.
- `totalPages` (integer, optional)
- `hasNext` (boolean, optional)
- `fetchedAt` (datetime, optional)

## Errors

### 404 Not Found Error

Requested resource was not found.

- `errorCode` (string, required) — Stable machine-readable code. See `ErrorCode` for the known values.
- `message` (string, required) — Human-readable explanation (pt-BR). Presentation only; may change.
- `docs` (string, optional) — Link to this code in the public error catalogue.
- `requestId` (string, optional) — Gateway request id. Quote it when contacting support.
- `details` (map from string to any, optional) — Optional machine-readable context for the specific `errorCode` (for example `kind` on `identity_verification_monthly_limit_exceeded`, `maxBytes` on `payload_too_large`, `attemptsRemaining` on `facetec_attempts_exhausted`). Keys are documented per operation; absent when the code carries no extra context.
- `partner` (ErrorResponsePartner, optional) — Raw error from the settlement bank, when the failure came from it. Diagnostic only.

### 409 Conflict Error

The account cannot be operated yet or the statement service is not enabled for it: `account_not_ready` (accreditation not complete) or `account_not_entitled` (accreditation complete, but the banking provider has not enabled this service for the account). Neither is transient — retrying does not help; contact support.

- `errorCode` (string, required) — Stable machine-readable code. See `ErrorCode` for the known values.
- `message` (string, required) — Human-readable explanation (pt-BR). Presentation only; may change.
- `docs` (string, optional) — Link to this code in the public error catalogue.
- `requestId` (string, optional) — Gateway request id. Quote it when contacting support.
- `details` (map from string to any, optional) — Optional machine-readable context for the specific `errorCode` (for example `kind` on `identity_verification_monthly_limit_exceeded`, `maxBytes` on `payload_too_large`, `attemptsRemaining` on `facetec_attempts_exhausted`). Keys are documented per operation; absent when the code carries no extra context.
- `partner` (ErrorResponsePartner, optional) — Raw error from the settlement bank, when the failure came from it. Diagnostic only.

### 500 Internal Server Error

Unexpected server error.

- `errorCode` (string, required) — Stable machine-readable code. See `ErrorCode` for the known values.
- `message` (string, required) — Human-readable explanation (pt-BR). Presentation only; may change.
- `docs` (string, optional) — Link to this code in the public error catalogue.
- `requestId` (string, optional) — Gateway request id. Quote it when contacting support.
- `details` (map from string to any, optional) — Optional machine-readable context for the specific `errorCode` (for example `kind` on `identity_verification_monthly_limit_exceeded`, `maxBytes` on `payload_too_large`, `attemptsRemaining` on `facetec_attempts_exhausted`). Keys are documented per operation; absent when the code carries no extra context.
- `partner` (ErrorResponsePartner, optional) — Raw error from the settlement bank, when the failure came from it. Diagnostic only.

## Types

### AccountStatementEntry

Linha do extrato. `payer` e `payee` são montados a partir de `direction`: * `direction=IN`: `payer` = contraparte (quem nos pagou); `payee` = a nossa conta (titular consultado). * `direction=OUT`: `payer` = a nossa conta; `payee` = contraparte (a quem pagamos). O lado **self** sempre traz `name` (titular) + `document` (CPF/CNPJ) + identificadores do banco liquidante (`bankCode`, `bankIspb`, `bankName`). O lado **contraparte** traz apenas `name` + `document`. Campos opcionais (`branch`, `account`, `pixKey`, `accountType`, `bankCode`, `bankIspb`, `bankName`) ficam omitidos quando vazios — o extrato do liquidante não os expõe. Para o payload completo da contraparte, use `GET /v1/accounts/{id}/pix/payments/lookup?endToEndId=...` ou o webhook outbound (`pix.in.completed`, `pix.out.completed`, etc.).

- `operation` (string, required) — Canonical type: PIX, TED, BOLETO, FEE, INTERNAL_TRANSFER.
- `amount` (double, required) — Signed amount in BRL (negative = debit, positive = credit).
- `currency` (string, required)
- `timestamp` (datetime, required) — Transaction timestamp in RFC3339 with São Paulo offset (-03:00).
- `partnerId` (string, optional) — Settlement bank operation reference.
- `endToEndId` (string, optional)
- `direction` (enum, optional)
  - Allowed values: `IN`, `OUT`
- `partnerType` (string, optional) — Partner operation label. `PIX_REFUND` on a PIX refund line (`reversal: true`); `operation` stays `PIX`. `P2P_CRYPTO_ORDER` on the legs of a P2P order (identifier `p2p-…` or `fee-p2p-…`).
- `status` (string, optional) — Canonical transaction status. Possible values: `COMPLETED`, `PROCESSING`, `FAILED`, `PENDING`, `PENDING_APPROVAL`, `REVERSED`, `UNKNOWN`. `PENDING_APPROVAL` means the partner accepted the request but is holding it for internal approval (multi-step authorisation, 2FA, anti-fraud). No BACEN end-to-end ID exists yet — funds have not moved.
- `description` (string, optional)
- `title` (string, optional) — Human-readable operation label from partner.
- `recipientName` (string, optional) — Atalho — nome da contraparte (igual a `counterParty.name`).
- `recipientDocument` (string, optional) — Atalho — documento da contraparte (igual a `counterParty.document`).
- `pixKey` (string, optional) — Chave PIX usada na transação. Num **crédito** é a chave desta conta que recebeu; num **débito**, a chave de destino. Distinta de `counterParty.pixKey`, que descreve a contraparte — num crédito o liquidante costuma preencher esta e deixar a da contraparte vazia. Omitida fora de PIX e em lançamentos anteriores à versão do liquidante que passou a informá-la. Para filtrar o extrato por chave, use `GET /v1/accounts/{accountId}/statement/advanced`.
- `counterParty` (AccountStatementEntryCounterParty, optional) — Contraparte da transação (nome + documento e, quando o liquidante informa, dados bancários: banco, agência, conta, ISPB e chave PIX). Os campos bancários são omitidos quando vazios.
- `transactionType` (enum, optional) — Partner credit/debit code: `C` = credit (IN), `D` = debit (OUT). Mirrors `direction`.
  - Allowed values: `C`, `D`
- `identifier` (string, optional)
- `reversal` (boolean, optional) — True when this line is a PIX refund (the settlement bank linked it to the original PIX via `originalEndToEnd`).
- `originalEndToEnd` (string, optional) — End-to-end of the PIX this line refunds. Empty on an ordinary movement. On a refund we initiated, this can equal `endToEndId`.
- `refundEndToEnd` (string, optional) — End-to-end of the refund that reversed this line, when the settlement bank reports one. Present on the original PIX after a refund, including a partial refund. Empty on the refund line itself.
- `feeServiceType` (string, optional) — Service behind a fee line: `PIX`, `TED`, `BOLETO`, `INTERNAL_TRANSFER`, `MONTHLY`, `P2P_CRYPTO` or `OTHER`.
- `p2pOrderId` (string, optional) — P2P order of this line, from the reserved identifier. On these lines the counterparty is only `ORDEM P2P CRIPTO` (no document) and `description` is `COMPRA P2P CRIPTO`, `VENDA P2P CRIPTO`, `TAXA INTERMEDIAÇÃO KYC P2P CRIPTO` or `ESTORNO TAXA INTERMEDIAÇÃO KYC P2P CRIPTO`.
- `p2pKind` (enum, optional) — Leg of the P2P order.
  - Allowed values: `payment`, `fee`, `fee_refund`
- `p2pOrder` (AccountStatementEntryP2POrder, optional) — Summary of your own order. Absent when the account is not a party or the order could not be read.
- `balance` (double, optional)
- `source` (enum, optional) — Data source for this line (`live` = settlement bank, real time).
  - Allowed values: `live`
- `ispb` (string, optional) — 8-digit ISPB of the bank that processed the transaction (settlement bank: 50871921).
- `payer` (TransactionParty, optional) — Transaction counterparty (payer or beneficiary).
- `payee` (TransactionParty, optional) — Transaction counterparty (payer or beneficiary).
- `initiation` (string, optional) — PIX initiation type (present on exact lookups by endToEndId/identifier): e.g. pix-key, manual, static-qrcode, dynamic-qrcode.
- `errorMessage` (string, optional) — Partner error message, when the transaction is in a failed/reversed state (present on exact lookups).
- `boletoBarcode` (string, optional) — Código do boleto como o liquidante informou na linha do extrato, só dígitos. Normalmente o código de barras (44 dígitos); o liquidante pode devolver a linha digitável no mesmo campo (47, ou 48 em arrecadação) — identifique pelo tamanho. Presente apenas quando `operation=BOLETO` — pagamento (`BOLETO_PAYMENT`) e cobrança liquidada (`BOLETO_SETTLEMENT`). Omitido fora de boleto e quando vazio.

### ErrorResponsePartner

Raw error from the settlement bank, when the failure came from it. Diagnostic only.

- `code` (string, optional)
- `message` (string, optional)
- `field` (string, optional) — Field the partner pointed at, when any.

### AccountStatementEntryCounterParty

Contraparte da transação (nome + documento e, quando o liquidante informa, dados bancários: banco, agência, conta, ISPB e chave PIX). Os campos bancários são omitidos quando vazios.

- `name` (string, optional)
- `document` (string, optional)
- `bankName` (string, optional)
- `bankIspb` (string, optional)
- `bankCode` (string, optional)
- `branch` (string, optional)
- `account` (string, optional)
- `accountType` (string, optional)
- `pixKey` (string, optional)

### AccountStatementEntryP2POrder

Summary of your own order. Absent when the account is not a party or the order could not be read.

- `orderId` (string, optional)
- `kind` (enum, optional)
  - Allowed values: `payment`, `fee`, `fee_refund`
- `role` (enum, optional)
  - Allowed values: `buyer`, `seller`
- `side` (enum, optional)
  - Allowed values: `buy`, `sell`
- `pair` (string, optional)
- `cryptoAmount` (string, optional)

### TransactionParty

Transaction counterparty (payer or beneficiary).

- `name` (string, optional) — Full name.
- `document` (string, optional) — CPF/CNPJ as reported by the settlement bank.
- `bankIspb` (string, optional) — Bank ISPB.
- `bankCode` (string, optional) — Bank code (COMPE).
- `bankName` (string, optional) — Bank name.
- `branch` (string, optional) — Branch.
- `account` (string, optional) — Account number.
- `accountType` (string, optional) — Account type, when the settlement bank reports it.
- `pixKey` (string, optional) — PIX key associated with the party.

## Examples

**Response**

```json
{
  "accountId": "2e6b725b-84a0-400d-8740-22a5ba0f23e6",
  "items": [
    {
      "operation": "PIX",
      "amount": 150.75,
      "currency": "BRL",
      "timestamp": "2026-02-20T08:33:39Z",
      "partnerId": "8c1f6a2e-4d3b-4b9a-9f0e-1a2b3c4d5e6f",
      "endToEndId": "E22896431202602200833NdtppklLCj2",
      "direction": "IN",
      "partnerType": "PIX",
      "status": "COMPLETED",
      "description": "Pagamento pedido #12345",
      "title": "Conta corrente",
      "recipientName": "MARIA DA SILVA",
      "recipientDocument": "12345678900",
      "pixKey": "db5c2a29-243e-42a2-862b-89737c0213aa",
      "counterParty": {
        "name": "MARIA DA SILVA",
        "document": "12345678900",
        "bankName": "MARIA DA SILVA",
        "bankIspb": "36741675",
        "bankCode": "36741675",
        "branch": "0001",
        "account": "200037834",
        "accountType": "PIX",
        "pixKey": "db5c2a29-243e-42a2-862b-89737c0213aa"
      },
      "transactionType": "C",
      "identifier": "order-12345",
      "reversal": true,
      "originalEndToEnd": "E22896431202602200833NdtppklLCj2",
      "feeServiceType": "PIX",
      "balance": 150.75,
      "source": "live",
      "ispb": "50871921",
      "payer": {
        "name": "MARIA DA SILVA",
        "document": "123***01",
        "bankCode": "001",
        "bankName": "BANCO DO BRASIL",
        "branch": "0001",
        "account": "12345678",
        "pixKey": "db5c2a29-243e-42a2-862b-89737c0213aa"
      },
      "payee": {
        "name": "MARIA DA SILVA",
        "document": "123***01",
        "bankCode": "001",
        "bankName": "BANCO DO BRASIL",
        "branch": "0001",
        "account": "12345678",
        "pixKey": "db5c2a29-243e-42a2-862b-89737c0213aa"
      },
      "initiation": "MANUAL"
    }
  ],
  "tenantId": "tn_7f3a9c",
  "source": "live",
  "startDate": "2026-02-20",
  "endDate": "2026-02-20",
  "page": 1,
  "size": 50,
  "totalElements": 150,
  "totalPages": 150,
  "hasNext": true,
  "fetchedAt": "2026-02-20T08:33:39Z"
}
```

**SDK Code**

```python Accounts_getAccountStatement_example
import requests

url = "https://client.api.corpx.com/v1/accounts/accountId/statement"

querystring = {"page":"0"}

headers = {
    "X-Content-SHA256": "X-Content-SHA256",
    "X-Request-Signature": "X-Request-Signature",
    "X-Request-Timestamp": "X-Request-Timestamp",
    "X-Tenant-Id": "X-Tenant-Id",
    "Authorization": "Bearer <token>"
}

response = requests.get(url, headers=headers, params=querystring)

print(response.json())
```

```javascript Accounts_getAccountStatement_example
const url = 'https://client.api.corpx.com/v1/accounts/accountId/statement?page=0';
const options = {
  method: 'GET',
  headers: {
    'X-Content-SHA256': 'X-Content-SHA256',
    'X-Request-Signature': 'X-Request-Signature',
    'X-Request-Timestamp': 'X-Request-Timestamp',
    'X-Tenant-Id': 'X-Tenant-Id',
    Authorization: 'Bearer <token>'
  }
};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```

```go Accounts_getAccountStatement_example
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://client.api.corpx.com/v1/accounts/accountId/statement?page=0"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-Content-SHA256", "X-Content-SHA256")
	req.Header.Add("X-Request-Signature", "X-Request-Signature")
	req.Header.Add("X-Request-Timestamp", "X-Request-Timestamp")
	req.Header.Add("X-Tenant-Id", "X-Tenant-Id")
	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}
```

```ruby Accounts_getAccountStatement_example
require 'uri'
require 'net/http'

url = URI("https://client.api.corpx.com/v1/accounts/accountId/statement?page=0")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-Content-SHA256"] = 'X-Content-SHA256'
request["X-Request-Signature"] = 'X-Request-Signature'
request["X-Request-Timestamp"] = 'X-Request-Timestamp'
request["X-Tenant-Id"] = 'X-Tenant-Id'
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body
```

```java Accounts_getAccountStatement_example
import com.mashape.unirest.http.HttpResponse;
import com.mashape.unirest.http.Unirest;

HttpResponse<String> response = Unirest.get("https://client.api.corpx.com/v1/accounts/accountId/statement?page=0")
  .header("X-Content-SHA256", "X-Content-SHA256")
  .header("X-Request-Signature", "X-Request-Signature")
  .header("X-Request-Timestamp", "X-Request-Timestamp")
  .header("X-Tenant-Id", "X-Tenant-Id")
  .header("Authorization", "Bearer <token>")
  .asString();
```

```php Accounts_getAccountStatement_example
<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://client.api.corpx.com/v1/accounts/accountId/statement?page=0', [
  'headers' => [
    'Authorization' => 'Bearer <token>',
    'X-Content-SHA256' => 'X-Content-SHA256',
    'X-Request-Signature' => 'X-Request-Signature',
    'X-Request-Timestamp' => 'X-Request-Timestamp',
    'X-Tenant-Id' => 'X-Tenant-Id',
  ],
]);

echo $response->getBody();
```

```csharp Accounts_getAccountStatement_example
using RestSharp;

var client = new RestClient("https://client.api.corpx.com/v1/accounts/accountId/statement?page=0");
var request = new RestRequest(Method.GET);
request.AddHeader("X-Content-SHA256", "X-Content-SHA256");
request.AddHeader("X-Request-Signature", "X-Request-Signature");
request.AddHeader("X-Request-Timestamp", "X-Request-Timestamp");
request.AddHeader("X-Tenant-Id", "X-Tenant-Id");
request.AddHeader("Authorization", "Bearer <token>");
IRestResponse response = client.Execute(request);
```

```swift Accounts_getAccountStatement_example
import Foundation

let headers = [
  "X-Content-SHA256": "X-Content-SHA256",
  "X-Request-Signature": "X-Request-Signature",
  "X-Request-Timestamp": "X-Request-Timestamp",
  "X-Tenant-Id": "X-Tenant-Id",
  "Authorization": "Bearer <token>"
]

let request = NSMutableURLRequest(url: NSURL(string: "https://client.api.corpx.com/v1/accounts/accountId/statement?page=0")! as URL,
                                        cachePolicy: .useProtocolCachePolicy,
                                    timeoutInterval: 10.0)
request.httpMethod = "GET"
request.allHTTPHeaderFields = headers

let session = URLSession.shared
let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in
  if (error != nil) {
    print(error as Any)
  } else {
    let httpResponse = response as? HTTPURLResponse
    print(httpResponse)
  }
})

dataTask.resume()
```