Skip to main content
POST
/
v0
/
state
/
acs
/v0/state/acs
curl --request POST \
  --url https://example.com/api/scan/v0/state/acs \
  --header 'Content-Type: application/json' \
  --data '
{
  "migration_id": 123,
  "record_time": "2023-11-07T05:31:56Z",
  "page_size": 123,
  "record_time_match": "exact",
  "after": 123,
  "party_ids": [
    "<string>"
  ],
  "templates": [
    "<string>"
  ]
}
'
{
  "record_time": "2023-11-07T05:31:56Z",
  "migration_id": 123,
  "created_events": [
    {
      "event_type": "<string>",
      "event_id": "<string>",
      "contract_id": "<string>",
      "template_id": "<string>",
      "package_name": "<string>",
      "create_arguments": {},
      "created_at": "2023-11-07T05:31:56Z",
      "signatories": [
        "<string>"
      ],
      "observers": [
        "<string>"
      ]
    }
  ],
  "next_page_token": 123
}

Documentation Index

Fetch the complete documentation index at: https://docs.canton.network/llms.txt

Use this file to discover all available pages before exploring further.

Body

application/json
​
migration_id
integer<int64>
required

The migration id for which to return the ACS.

​
record_time
string<date-time>
required

The timestamp at which the contract set was active. This needs to be an exact timestamp, i.e., needs to correspond to a timestamp reported by /v0/state/acs/snapshot-timestamp if record_time_match is set to exact (which is the default). If record_time_match is set to at_or_before, this can be any timestamp, and the most recent snapshot at or before the given record_time will be returned.

​
page_size
integer<int32>
required

The maximum number of created events returned for this request.

​
record_time_match
enum<string>
default:exact

How to match the record_time. "exact" requires the record_time to match exactly. "at_or_before" finds the most recent snapshot at or before the given record_time.

Available options:
exact,
at_or_before
​
after
integer<int64>

Pagination token for the next page of results. For this to be valid, this must be the next_page_token from a prior request with identical parameters aside from after and page_size; the response may be invalid otherwise.

​
party_ids
string[]

Filters the ACS by contracts in which these party IDs are stakeholders.

​
templates
string[]

Filters the ACS by contracts with these template IDs, specified as "PACKAGE_NAME:MODULE_NAME:ENTITY_NAME".

Response

ok

​
record_time
string<date-time>
required

The same record_time as in the request.

​
migration_id
integer<int64>
required

The same migration_id as in the request.

​
created_events
object[]
required

Up to page_size contracts in the ACS. create_arguments are always encoded as compact_json.

​
next_page_token
integer<int64>

When requesting the next page of results, pass this as after to the AcsRequest or HoldingsStateRequest. Will be absent when there are no more pages.