> ## Documentation Index
> Fetch the complete documentation index at: https://cantonfoundation-reference-history-contracts.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# State active contracts page
JSON Ledger API
State active contracts page
OpenAPI
Since 3.5
Returns a page of the snapshot of the active contracts and incomplete (un)assignments at a ledger offset. Once all pages are fetched by repeated calls to `GetActiveContractsPage`, the client SHOULD begin retrieving updates from the update service, starting at the `GetActiveContractsPageResponse`.`active_at_offset` specified in this request. Clients SHOULD NOT assume that the set of active contracts they receive reflects the state at the ledger end.
## Protocol Details
- Operation ID
- postV2StateActive-contracts-page
- Authentication
- Bearer token
- Published
- 3.5
## Inputs
### Request body
application/json
OpenAPI type: `integer (int64)`.
The offset at which the snapshot of the active contracts will be computed. Must be no greater than the current ledger end offset. Must be greater than or equal to the last pruning offset. Optional, if defined, it must be a valid absolute offset (positive integer) or ledger begin offset (zero). If zero, the empty set will be returned. If not defined, the current ledger end will be used and it will be populated in the response. Optional
OpenAPI type: `EventFormat`.
A format for events which defines both which events should be included and what data should be computed and included for them. Note that some of the filtering behavior depends on the `TransactionShape`, which is expected to be specified alongside usages of `EventFormat`.
OpenAPI type: `integer (int32)`.
The result page will contain at most max\_page\_size entries of the respective active contract snapshot. The server might reject max\_page\_size breaching the server-specified limit. Optional, if not defined, the default will be determined by the server. Optional
To get the next page of the active contracts snapshot, the `page_token` should be set to the `next_page_token` of the last `GetActiveContractsPageResponse`. The page token only works if subsequent requests: - are executed on the same participant, - use the same active\_at\_offset and event\_format, - and the participant's store was not pruned to after the active\_at\_offset. If not specified, the first page of the active contracts snapshot will be returned. Optional: can be empty
## Outputs
### 200
application/json
The collection of active contracts for this page response. Required: must be non-empty
The active\_at\_offset which was specified in the request, or the calculated active\_at\_offset from the actual ledger end from at the evaluation of the request. Required
If not present this is the last page. If present, this token must be used to get the next page. Optional: can be empty
### 400
text/plain
*
### default
application/json
*
*
*
*
*
*
*
*
*
*
## History
```bash Request theme={null}
curl --request POST \
--url 'http://localhost:7575/v2/state/active-contracts-page' \
--header 'Authorization: Bearer $TOKEN' \
--header 'Content-Type: application/json' \
--data '{"activeAtOffset":0,"eventFormat":{"filtersByParty":{},"filtersForAnyParty":{},"verbose":false},"maxPageSize":0,"pageToken":"string"}'
```
```json 200 response theme={null}
{
"activeContracts": [
{}
],
"activeAtOffset": 0,
"nextPageToken": "string"
}
```
```json default response theme={null}
{
"code": "string",
"cause": "string",
"correlationId": "string",
"traceId": "string",
"context": {},
"resources": [
[
"string"
]
],
"errorCategory": 0,
"grpcCodeValue": 0,
"retryInfo": "string",
"definiteAnswer": false
}
```