---
updatedAt: 2026-04-28T11:35:37.000Z
agentTools:
  projectIndex: https://docs.arcadia.com/llms.txt
---

# List Statement Versions

List all versions of a specific Statement.

This endpoint supports [Sandbox Mode](https://docs.arcadia.com/docs/sandbox-testing).

# OpenAPI definition

```json
{
  "openapi": "3.0.1",
  "info": {
    "description": "Plug API",
    "title": "Plug API",
    "version": "2.0.0"
  },
  "servers": [
    {
      "url": "https://api.arcadia.com"
    }
  ],
  "components": {
    "securitySchemes": {
      "OAuth2": {
        "type": "oauth2",
        "description": "This API uses OAuth2 with the client credentials flow using the ['Create an Access Token'](https://docs.arcadia.com/reference/create-access-token) endpoint. API keys can be retrieved from the [Dashboard](https://dashboard.arcadia.com/).",
        "flows": {
          "clientCredentials": {
            "scopes": {},
            "tokenUrl": "/oauth2/token"
          }
        }
      }
    },
    "parameters": {
      "arcVersionInHeaderParam": {
        "name": "Arcadia-Version",
        "in": "header",
        "example": "2024-02-21",
        "description": "The Arcadia-Version for the request",
        "required": true,
        "schema": {
          "type": "string",
          "default": "2024-02-21"
        }
      }
    },
    "schemas": {
      "PageMetadata": {
        "required": [
          "number",
          "size",
          "totalElements",
          "totalPages"
        ],
        "type": "object",
        "properties": {
          "number": {
            "type": "integer",
            "format": "int64"
          },
          "size": {
            "type": "integer",
            "format": "int64"
          },
          "totalElements": {
            "type": "integer",
            "format": "int64"
          },
          "totalPages": {
            "type": "integer",
            "format": "int64"
          }
        },
        "description": "Specifies which page of results to return; this is 0-indexed"
      },
      "PagedPublicStatementSummaryResource": {
        "type": "object",
        "properties": {
          "page": {
            "$ref": "#/components/schemas/PageMetadata"
          },
          "statements": {
            "type": "array",
            "description": "An array of statement objects.",
            "items": {
              "$ref": "#/components/schemas/PublicStatementSummaryResource"
            }
          }
        },
        "required": [
          "page",
          "statements"
        ]
      },
      "PublicAccountDataProviderResource": {
        "type": "object",
        "description": "This resource represents the provider for an account data entry on a statement. In the statement context, the publisher provider is the provider that posts the bill whereas the pass-through provider is one that is listed on the bill but does not post it.",
        "properties": {
          "classification": {
            "type": "string",
            "description": "The classification of the provider. Useful to identify if this is a publisher or pass-through provider.",
            "enum": [
              "PUBLISHER",
              "PASS_THROUGH"
            ]
          },
          "id": {
            "type": "string",
            "description": "The unique identifier for the provider in the Arcadia platform."
          },
          "name": {
            "type": "string",
            "description": "The name of the provider."
          },
          "publisherProviderAccountId": {
            "type": "string",
            "description": "A Publisher Provider issues the bill and a Pass-Though Provider is only mentioned on the bill. This is account ID of the Publisher Provider."
          }
        },
        "required": [
          "classification",
          "id",
          "name",
          "publisherProviderAccountId"
        ]
      },
      "PublicAccountDataSummaryResource": {
        "type": "object",
        "description": "Data related to individual accounts, including billing information, usage history, etc.",
        "properties": {
          "accountId": {
            "type": "string",
            "description": "An unique identifier for an account."
          },
          "accountNumber": {
            "type": "string",
            "description": "An account identifier provided by the commodity provider (often times the bill publisher)."
          },
          "amountDue": {
            "type": "number",
            "description": "The monetary amount that is required to be paid.",
            "nullable": true
          },
          "dueDate": {
            "type": "string",
            "format": "date",
            "description": "The due date for payment associated with the account.",
            "nullable": true
          },
          "meterData": {
            "type": "array",
            "description": "meterData: Data related to individual meters, including meter readings, usage history, etc.",
            "items": {
              "$ref": "#/components/schemas/PublicMeterDataSummaryResource"
            }
          },
          "normalizedAccountNumber": {
            "type": "string",
            "description": "The normalized version of the account number (removing things like hyphens, underscores, and leading zeros)."
          },
          "outstandingBalance": {
            "type": "number",
            "description": "The remaining balance yet to be paid for the account.",
            "nullable": true
          },
          "provider": {
            "$ref": "#/components/schemas/PublicAccountDataProviderResource"
          },
          "totalCharges": {
            "type": "number",
            "description": "The total charges applied for a specific billing period.",
            "nullable": true
          }
        },
        "required": [
          "accountId",
          "accountNumber",
          "amountDue",
          "dueDate",
          "meterData",
          "normalizedAccountNumber",
          "outstandingBalance",
          "provider",
          "totalCharges"
        ]
      },
      "PublicBusinessUnitResource": {
        "type": "object",
        "description": "A business unit assignment.",
        "properties": {
          "id": {
            "type": "string",
            "description": "Business unit identifier.",
            "readOnly": true
          },
          "name": {
            "type": "string",
            "description": "Display name when visible to the caller.",
            "nullable": true
          }
        },
        "required": [
          "id",
          "name"
        ]
      },
      "PublicMeterDataSummaryResource": {
        "type": "object",
        "description": "meterData: Data related to individual meters, including meter readings, usage history, etc.",
        "properties": {
          "amountDue": {
            "type": "number",
            "description": "The monetary amount that is required to be paid.",
            "nullable": true
          },
          "currencyCode": {
            "type": "string",
            "description": "The ISO 4217 currency code for charges. This list will grow as additional currencies are supported over time.",
            "enum": [
              "USD",
              "AUD",
              "CAD",
              "EUR",
              "GBP",
              "ZAR",
              "RON",
              "BRL",
              "DKK",
              "CHF",
              "MXN",
              "NZD",
              "NOK",
              "SEK",
              "CZK",
              "COP",
              "PLN",
              "ARS",
              "GTQ",
              "SGD",
              "TRY",
              "INR",
              "JPY",
              "HKD",
              "HUF",
              "AED",
              "MAD",
              "PHP",
              "IDR",
              "UYU",
              "CLP",
              "PEN",
              "MYR",
              "OMR",
              "BHD",
              "SAR",
              "GHS",
              "THB",
              "VND",
              "LKR",
              "KRW",
              "BAM",
              "BGN",
              "RSD",
              "TWD",
              "KES",
              "NGN",
              "ILS",
              "CNY",
              "CRC",
              "EUS"
            ],
            "nullable": true
          },
          "meterId": {
            "type": "string",
            "description": "A unique identifier for a meter."
          },
          "meterNumber": {
            "type": "string",
            "description": "A number assigned to the meter by the commodity provider. ",
            "nullable": true
          },
          "meterReadDate": {
            "type": "string",
            "format": "date",
            "description": "The date on which the meter reading was taken.",
            "nullable": true
          },
          "normalizedMeterNumber": {
            "type": "string",
            "description": "The normalized version of the meter number (removing things like hyphens, underscores, and leading zeros).",
            "nullable": true
          },
          "normalizedPointOfDeliveryNumber": {
            "type": "string",
            "description": "The normalized version of the Point of Delivery number (removing things like hyphens, underscores, and leading zeros).",
            "nullable": true
          },
          "outstandingBalance": {
            "type": "number",
            "description": "The remaining balance yet to be paid for the account.",
            "nullable": true
          },
          "periodEndDate": {
            "type": "string",
            "format": "date",
            "description": "The end date of the measuring period.",
            "nullable": true
          },
          "periodStartDate": {
            "type": "string",
            "format": "date",
            "description": "The start date of the measuring period.",
            "nullable": true
          },
          "pointOfDeliveryNumber": {
            "type": "string",
            "description": "The point of delivery number in deregulated markets is an independent identifier for meter location and used by all utility companies.",
            "nullable": true
          },
          "previousReadDate": {
            "type": "string",
            "format": "date",
            "description": "The date of the previous meter reading.",
            "nullable": true
          },
          "serviceType": {
            "type": "string",
            "description": "The type of service supported, such as electricity, water, or gas."
          },
          "serviceTypeClassification": {
            "type": "string",
            "description": "The classification for the service type depending on the comprehensiveness of data that can be returned.",
            "enum": [
              "CORE",
              "SUPPLEMENTAL"
            ]
          },
          "totalCharges": {
            "type": "number",
            "description": "The total charges applied for a specific billing period.",
            "nullable": true
          },
          "totalUsage": {
            "type": "number",
            "description": "Total calculated usage of energy or water for the account within a specific period.",
            "nullable": true
          },
          "totalUsageUnit": {
            "type": "string",
            "description": "Unit of measurement for the total calculated usage (e.g., kWh, gallons).",
            "nullable": true
          }
        },
        "required": [
          "amountDue",
          "currencyCode",
          "meterId",
          "meterNumber",
          "meterReadDate",
          "normalizedMeterNumber",
          "normalizedPointOfDeliveryNumber",
          "outstandingBalance",
          "periodEndDate",
          "periodStartDate",
          "pointOfDeliveryNumber",
          "previousReadDate",
          "serviceType",
          "serviceTypeClassification",
          "totalCharges",
          "totalUsage",
          "totalUsageUnit"
        ]
      },
      "PublicProviderResource": {
        "type": "object",
        "description": "The entity providing service and issuing bills (informally known as a utility).",
        "nullable": true,
        "properties": {
          "country": {
            "type": "string",
            "description": "The country associated with the billing address.",
            "nullable": true
          },
          "id": {
            "type": "string",
            "description": "A unique identifier for the entity."
          },
          "intervalServiceTypes": {
            "type": "array",
            "description": "List of interval service types supported by this provider (e.g., ['electric', 'gas'])",
            "items": {
              "type": "string",
              "description": "List of interval service types supported by this provider (e.g., ['electric', 'gas'])",
              "enum": [
                "ELECTRIC",
                "GAS"
              ]
            },
            "uniqueItems": true
          },
          "isIntervalDataSupported": {
            "type": "boolean",
            "description": "Indicates whether the provider supports interval data",
            "nullable": true
          },
          "isIntervalFileUploadSupported": {
            "type": "boolean",
            "description": "Indicates whether the provider supports interval file upload",
            "nullable": true
          },
          "isRealTimeCredentialValidationSupported": {
            "type": "boolean",
            "description": "Indicates whether the provider supports credential validation"
          },
          "name": {
            "type": "string",
            "description": "The name of the utility service provider.",
            "nullable": true
          }
        },
        "required": [
          "country",
          "id",
          "intervalServiceTypes",
          "isIntervalDataSupported",
          "isIntervalFileUploadSupported",
          "isRealTimeCredentialValidationSupported",
          "name"
        ]
      },
      "PublicStatementSummaryResource": {
        "type": "object",
        "description": "An array of statement objects.",
        "properties": {
          "accountData": {
            "type": "array",
            "description": "Data related to individual accounts, including billing information, usage history, etc.",
            "items": {
              "$ref": "#/components/schemas/PublicAccountDataSummaryResource"
            }
          },
          "amountDue": {
            "type": "number",
            "description": "The monetary amount that is required to be paid.",
            "nullable": true
          },
          "businessUnitsIntersection": {
            "type": "array",
            "description": "Intersection of Business Units across Accounts on this Statement Version.",
            "items": {
              "$ref": "#/components/schemas/PublicBusinessUnitResource"
            }
          },
          "businessUnitsUnion": {
            "type": "array",
            "description": "Union of Business Units from Accounts on this Statement Version.",
            "items": {
              "$ref": "#/components/schemas/PublicBusinessUnitResource"
            }
          },
          "correlationIds": {
            "type": "array",
            "description": "A list of correlationIds cascaded from all directly associated Credentials and Files.",
            "items": {
              "type": "string"
            }
          },
          "createdAt": {
            "type": "string",
            "format": "date-time",
            "description": "A timestamp indicating when the entity was created.",
            "nullable": true
          },
          "currencyCode": {
            "type": "string",
            "description": "The ISO 4217 currency code for charges. This list will grow as additional currencies are supported over time.",
            "enum": [
              "USD",
              "AUD",
              "CAD",
              "EUR",
              "GBP",
              "ZAR",
              "RON",
              "BRL",
              "DKK",
              "CHF",
              "MXN",
              "NZD",
              "NOK",
              "SEK",
              "CZK",
              "COP",
              "PLN",
              "ARS",
              "GTQ",
              "SGD",
              "TRY",
              "INR",
              "JPY",
              "HKD",
              "HUF",
              "AED",
              "MAD",
              "PHP",
              "IDR",
              "UYU",
              "CLP",
              "PEN",
              "MYR",
              "OMR",
              "BHD",
              "SAR",
              "GHS",
              "THB",
              "VND",
              "LKR",
              "KRW",
              "BAM",
              "BGN",
              "RSD",
              "TWD",
              "KES",
              "NGN",
              "ILS",
              "CNY",
              "CRC",
              "EUS"
            ],
            "nullable": true
          },
          "dataIngestionMethod": {
            "type": "string",
            "description": "Identifies the data ingestion method that created this Statement.",
            "enum": [
              "BILL_UPLOAD",
              "UTILITY_WEBSITE_ACCESS"
            ],
            "nullable": true
          },
          "discoveredAt": {
            "type": "string",
            "format": "date-time",
            "description": "Timestamp indicating when the statement data was discovered and added to the system.",
            "nullable": true
          },
          "discoveredStatementId": {
            "type": "string",
            "description": "The unique identifier for the discovered statement in the Arcadia platform.",
            "nullable": true
          },
          "dueDate": {
            "type": "string",
            "format": "date",
            "description": "The due date for payment associated with the account.",
            "nullable": true
          },
          "id": {
            "type": "string",
            "description": "A unique identifier for the entity."
          },
          "invoiceNumber": {
            "type": "string",
            "description": "The unique identifier or number assigned to a specific invoice.",
            "nullable": true
          },
          "isLatestVersion": {
            "type": "boolean",
            "description": "Indicates whether the Statement is the most recent versionId of the Statement."
          },
          "lastModifiedAt": {
            "type": "string",
            "format": "date-time",
            "description": "The timestamp indicating when this resource was last modified.",
            "nullable": true
          },
          "normalizedSummaryAccountNumber": {
            "type": "string",
            "description": "The normalized version of the Summary account number (removing things like hyphens, underscores, and leading zeros).",
            "nullable": true
          },
          "outstandingBalance": {
            "type": "number",
            "description": "The remaining balance yet to be paid for the account.",
            "nullable": true
          },
          "periodEndDate": {
            "type": "string",
            "format": "date",
            "description": "The end date of the measuring period.",
            "nullable": true
          },
          "periodStartDate": {
            "type": "string",
            "format": "date",
            "description": "The start date of the measuring period.",
            "nullable": true
          },
          "provider": {
            "$ref": "#/components/schemas/PublicProviderResource"
          },
          "statementDate": {
            "type": "string",
            "format": "date",
            "description": "The date of the statement.",
            "nullable": true
          },
          "summaryAccountNumber": {
            "type": "string",
            "description": "The number or identifier assigned to the summary account by the provider.",
            "nullable": true
          },
          "totalCharges": {
            "type": "number",
            "description": "The total charges applied for a specific billing period.",
            "nullable": true
          },
          "type": {
            "type": "string",
            "description": "Describes the source document.",
            "enum": [
              "BILL",
              "NOTICE",
              "ADJUSTMENT",
              "PREPAID"
            ]
          },
          "versionId": {
            "type": "string",
            "description": "A unique identifier for the version of the statement entity at a given moment in time."
          }
        },
        "required": [
          "accountData",
          "amountDue",
          "businessUnitsIntersection",
          "businessUnitsUnion",
          "correlationIds",
          "createdAt",
          "currencyCode",
          "dataIngestionMethod",
          "discoveredAt",
          "discoveredStatementId",
          "dueDate",
          "id",
          "invoiceNumber",
          "isLatestVersion",
          "lastModifiedAt",
          "normalizedSummaryAccountNumber",
          "outstandingBalance",
          "periodEndDate",
          "periodStartDate",
          "provider",
          "statementDate",
          "summaryAccountNumber",
          "totalCharges",
          "type",
          "versionId"
        ]
      }
    }
  },
  "security": [
    {
      "OAuth2": []
    }
  ],
  "paths": {
    "/plug/statements/{statementId}/versions": {
      "get": {
        "description": "List all versions of a specific Statement.\n\nThis endpoint supports [Sandbox Mode](https://docs.arcadia.com/docs/sandbox-testing).",
        "operationId": "list-statement-versions",
        "parameters": [
          {
            "in": "path",
            "name": "statementId",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Zero-based page index (0..N)",
            "in": "query",
            "name": "page",
            "schema": {
              "type": "integer",
              "default": 0
            }
          },
          {
            "description": "The size of the page to be returned",
            "in": "query",
            "name": "size",
            "schema": {
              "type": "integer",
              "default": 20
            }
          },
          {
            "description": "Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.",
            "in": "query",
            "name": "sort",
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          },
          {
            "$ref": "#/components/parameters/arcVersionInHeaderParam"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PagedPublicStatementSummaryResource"
                }
              }
            },
            "description": "OK"
          }
        },
        "summary": "List Statement Versions",
        "tags": [
          "Statements"
        ],
        "servers": [
          {
            "url": "https://api.arcadia.com"
          },
          {
            "url": "https://sandbox.api.arcadia.com"
          }
        ]
      }
    }
  }
}
```