List Statement Request

Lists statements for your legal entity, most recent first. Supports filtering by creation date and cursor-based pagination.

List statements

Lists the statements for your legal entity, most recent first. Use the date filters to narrow the results and the page_token cursor to page through them.

curl 'https://developer-api-staging.pavebank.dev/v1/statement-async?page_size=20' \
  --header 'Authorization: Bearer <YOUR_BEARER_TOKEN>'

The response returns a page of statements along with a next_page_token:

{
  "data": [
    {
      "id": "statement_export_1jt9vwzof57z427158knbxsf2s",
      "legal_entity_id": "legal_entity_<YOUR_LEGAL_ENTITY_ID>",
      "requested_by": "user_<YOUR_USER_ID>",
      "export_type": "CSV",
      "status": "completed",
      "created_at": "2026-02-01T09:00:00Z",
      "updated_at": "2026-02-01T09:00:42Z",
      "document_id": "document_1jt9w1abc57z427158knbxsf2s",
      "progress": {
        "total": 1200,
        "processed": 1200
      }
    }
  ],
  "next_page_token": "",
  "total_count": 1
}

The list response does not include download_url or file_name. Call Get Statement Request for a specific statement to obtain a fresh download link.

A next_page_token is returned only when the page is full, meaning it contains as many records as page_size. It is empty when there are no more pages, as in the example above. To fetch the next page, pass the token back as the page_token query parameter.

Authorization

AuthorizationRequiredBearer <token>

Enter your token in the format: Bearer {token}

In: header

Query Parameters

created_fromstring

Only return exports created at or after this timestamp.

Format: date-time

created_tostring

Only return exports created at or before this timestamp.

Format: date-time

page_tokenstring

The pagination cursor returned by a previous response as next_page_token.

page_sizeinteger

Maximum number of records to return per page. Defaults to 50, capped at 100.

Format: int64

Response Body

Success response

dataRequiredarray<object>

next_page_tokenRequiredstring

total_countinteger

Total number of records returned in the response.

Format: int64

curl -X GET "https://developer-api-staging.pavebank.dev/v1/statement-async?created_from=2019-08-24T14%3A15%3A22Z&created_to=2019-08-24T14%3A15%3A22Z&page_token=string&page_size=0" \
  -H "Authorization: Bearer <token>"

{
  "data": [
    {
      "id": "string",
      "legal_entity_id": "string",
      "requested_by": "string",
      "export_type": "CSV",
      "status": "processing",
      "created_at": "2019-08-24T14:15:22Z",
      "updated_at": "2019-08-24T14:15:22Z",
      "document_id": "string",
      "download_url": "string",
      "file_name": "string",
      "progress": {
        "total": 0,
        "processed": 0
      }
    }
  ],
  "next_page_token": "string",
  "total_count": 0
}