curl --request POST \
--url 'https://scan.sv-1.global.canton.network.sync.global/api/scan/v0/events' \
--header 'Content-Type: application/json' \
--data '{
"after": {
"after_migration_id": 123,
"after_record_time": "<string>"
},
"page_size": 123,
"daml_value_encoding": "compact_json"
}'
import json
import requests
url = "https://scan.sv-1.global.canton.network.sync.global/api/scan/v0/events"
headers = {'Content-Type': 'application/json'}
payload = json.loads(r'''{
"after": {
"after_migration_id": 123,
"after_record_time": "<string>"
},
"page_size": 123,
"daml_value_encoding": "compact_json"
}''')
response = requests.request(
"POST", url, headers=headers, json=payload
)
print(response.text)
const response = await fetch('https://scan.sv-1.global.canton.network.sync.global/api/scan/v0/events', {
method: 'POST',
headers: {
"Content-Type": "application/json"
},
body: JSON.stringify({
"after": {
"after_migration_id": 123,
"after_record_time": "<string>"
},
"page_size": 123,
"daml_value_encoding": "compact_json"
}),
});
console.log(await response.text());
<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => 'https://scan.sv-1.global.canton.network.sync.global/api/scan/v0/events',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_POSTFIELDS => <<<'JSON'
{
"after": {
"after_migration_id": 123,
"after_record_time": "<string>"
},
"page_size": 123,
"daml_value_encoding": "compact_json"
}
JSON,
CURLOPT_HTTPHEADER => [
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
echo $response;
package main
import (
"bytes"
"fmt"
"io"
"net/http"
)
func main() {
req, _ := http.NewRequest("POST", "https://scan.sv-1.global.canton.network.sync.global/api/scan/v0/events", bytes.NewBufferString(`{
"after": {
"after_migration_id": 123,
"after_record_time": "<string>"
},
"page_size": 123,
"daml_value_encoding": "compact_json"
}`))
req.Header.Set("Content-Type", "application/json")
response, _ := http.DefaultClient.Do(req)
defer response.Body.Close()
body, _ := io.ReadAll(response.Body)
fmt.Println(string(body))
}
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
var request = HttpRequest.newBuilder()
.uri(URI.create("https://scan.sv-1.global.canton.network.sync.global/api/scan/v0/events"))
.header("Content-Type", "application/json")
.method("POST", HttpRequest.BodyPublishers.ofString("""
{
"after": {
"after_migration_id": 123,
"after_record_time": "<string>"
},
"page_size": 123,
"daml_value_encoding": "compact_json"
}
"""))
.build();
var response = HttpClient.newHttpClient().send(
request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
require 'net/http'
require 'uri'
uri = URI('https://scan.sv-1.global.canton.network.sync.global/api/scan/v0/events')
request = Net::HTTP::Post.new(uri)
request['Content-Type'] = 'application/json'
request.body = <<~JSON
{
"after": {
"after_migration_id": 123,
"after_record_time": "<string>"
},
"page_size": 123,
"daml_value_encoding": "compact_json"
}
JSON
response = Net::HTTP.start(uri.hostname, uri.port) do |http|
http.request(request)
end
puts response.body
{
"events": [
{
"update": {
"update_id": "<string>",
"migration_id": 123,
"workflow_id": "<string>",
"record_time": "<string>",
"synchronizer_id": "<string>",
"effective_at": "<string>",
"root_event_ids": [
"<string>"
],
"events_by_id": {},
"external_transaction_hash": "<string>"
},
"verdict": {
"update_id": "<string>",
"migration_id": 123,
"domain_id": "<string>",
"record_time": "<string>",
"finalization_time": "<string>",
"submitting_parties": [
"<string>"
],
"submitting_participant_uid": "<string>",
"verdict_result": "VERDICT_RESULT_UNSPECIFIED",
"mediator_group": 123,
"transaction_views": {
"views": [
{
"view_id": 123,
"informees": [
"<string>"
],
"confirming_parties": [
"<object>"
],
"sub_views": [
123
],
"view_hash": "<string>"
}
],
"root_views": [
123
]
}
},
"traffic_summary": {
"total_traffic_cost": 123,
"envelope_traffic_summaries": [
{
"traffic_cost": 123,
"view_ids": [
123
]
}
]
},
"app_activity_records": {
"round_number": 123,
"records": [
{
"party": "<string>",
"weight": 123
}
]
}
}
]
}
{
"error": "<string>"
}
{
"error": "<string>"
}
POST /v0/events
Returns the event history in ascending order, paged, from ledger begin or optionally starting after a record time. An event bears some combination of a transaction, a contract reassignment, and a verdict. Events are ordered lexicographically by (migration id, record time). For a given migration id, each event has a unique record time.
POST
/
api
/
scan
/
v0
/
events
curl --request POST \
--url 'https://scan.sv-1.global.canton.network.sync.global/api/scan/v0/events' \
--header 'Content-Type: application/json' \
--data '{
"after": {
"after_migration_id": 123,
"after_record_time": "<string>"
},
"page_size": 123,
"daml_value_encoding": "compact_json"
}'
import json
import requests
url = "https://scan.sv-1.global.canton.network.sync.global/api/scan/v0/events"
headers = {'Content-Type': 'application/json'}
payload = json.loads(r'''{
"after": {
"after_migration_id": 123,
"after_record_time": "<string>"
},
"page_size": 123,
"daml_value_encoding": "compact_json"
}''')
response = requests.request(
"POST", url, headers=headers, json=payload
)
print(response.text)
const response = await fetch('https://scan.sv-1.global.canton.network.sync.global/api/scan/v0/events', {
method: 'POST',
headers: {
"Content-Type": "application/json"
},
body: JSON.stringify({
"after": {
"after_migration_id": 123,
"after_record_time": "<string>"
},
"page_size": 123,
"daml_value_encoding": "compact_json"
}),
});
console.log(await response.text());
<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => 'https://scan.sv-1.global.canton.network.sync.global/api/scan/v0/events',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_POSTFIELDS => <<<'JSON'
{
"after": {
"after_migration_id": 123,
"after_record_time": "<string>"
},
"page_size": 123,
"daml_value_encoding": "compact_json"
}
JSON,
CURLOPT_HTTPHEADER => [
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
echo $response;
package main
import (
"bytes"
"fmt"
"io"
"net/http"
)
func main() {
req, _ := http.NewRequest("POST", "https://scan.sv-1.global.canton.network.sync.global/api/scan/v0/events", bytes.NewBufferString(`{
"after": {
"after_migration_id": 123,
"after_record_time": "<string>"
},
"page_size": 123,
"daml_value_encoding": "compact_json"
}`))
req.Header.Set("Content-Type", "application/json")
response, _ := http.DefaultClient.Do(req)
defer response.Body.Close()
body, _ := io.ReadAll(response.Body)
fmt.Println(string(body))
}
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
var request = HttpRequest.newBuilder()
.uri(URI.create("https://scan.sv-1.global.canton.network.sync.global/api/scan/v0/events"))
.header("Content-Type", "application/json")
.method("POST", HttpRequest.BodyPublishers.ofString("""
{
"after": {
"after_migration_id": 123,
"after_record_time": "<string>"
},
"page_size": 123,
"daml_value_encoding": "compact_json"
}
"""))
.build();
var response = HttpClient.newHttpClient().send(
request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
require 'net/http'
require 'uri'
uri = URI('https://scan.sv-1.global.canton.network.sync.global/api/scan/v0/events')
request = Net::HTTP::Post.new(uri)
request['Content-Type'] = 'application/json'
request.body = <<~JSON
{
"after": {
"after_migration_id": 123,
"after_record_time": "<string>"
},
"page_size": 123,
"daml_value_encoding": "compact_json"
}
JSON
response = Net::HTTP.start(uri.hostname, uri.port) do |http|
http.request(request)
end
puts response.body
{
"events": [
{
"update": {
"update_id": "<string>",
"migration_id": 123,
"workflow_id": "<string>",
"record_time": "<string>",
"synchronizer_id": "<string>",
"effective_at": "<string>",
"root_event_ids": [
"<string>"
],
"events_by_id": {},
"external_transaction_hash": "<string>"
},
"verdict": {
"update_id": "<string>",
"migration_id": 123,
"domain_id": "<string>",
"record_time": "<string>",
"finalization_time": "<string>",
"submitting_parties": [
"<string>"
],
"submitting_participant_uid": "<string>",
"verdict_result": "VERDICT_RESULT_UNSPECIFIED",
"mediator_group": 123,
"transaction_views": {
"views": [
{
"view_id": 123,
"informees": [
"<string>"
],
"confirming_parties": [
"<object>"
],
"sub_views": [
123
],
"view_hash": "<string>"
}
],
"root_views": [
123
]
}
},
"traffic_summary": {
"total_traffic_cost": 123,
"envelope_traffic_summaries": [
{
"traffic_cost": 123,
"view_ids": [
123
]
}
]
},
"app_activity_records": {
"round_number": 123,
"records": [
{
"party": "<string>",
"weight": 123
}
]
}
}
]
}
{
"error": "<string>"
}
{
"error": "<string>"
}
Returns the event history in ascending order, paged, from ledger begin or optionally starting after a record time. An event bears some combination of a transaction, a contract reassignment, and a verdict. Events are ordered lexicographically by (migration id, record time). For a given migration id, each event has a unique record time.
curl --request POST \
--url 'https://scan.sv-1.global.canton.network.sync.global/api/scan/v0/events' \
--header 'Content-Type: application/json' \
--data '{
"after": {
"after_migration_id": 123,
"after_record_time": "<string>"
},
"page_size": 123,
"daml_value_encoding": "compact_json"
}'
import json
import requests
url = "https://scan.sv-1.global.canton.network.sync.global/api/scan/v0/events"
headers = {'Content-Type': 'application/json'}
payload = json.loads(r'''{
"after": {
"after_migration_id": 123,
"after_record_time": "<string>"
},
"page_size": 123,
"daml_value_encoding": "compact_json"
}''')
response = requests.request(
"POST", url, headers=headers, json=payload
)
print(response.text)
const response = await fetch('https://scan.sv-1.global.canton.network.sync.global/api/scan/v0/events', {
method: 'POST',
headers: {
"Content-Type": "application/json"
},
body: JSON.stringify({
"after": {
"after_migration_id": 123,
"after_record_time": "<string>"
},
"page_size": 123,
"daml_value_encoding": "compact_json"
}),
});
console.log(await response.text());
<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => 'https://scan.sv-1.global.canton.network.sync.global/api/scan/v0/events',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_POSTFIELDS => <<<'JSON'
{
"after": {
"after_migration_id": 123,
"after_record_time": "<string>"
},
"page_size": 123,
"daml_value_encoding": "compact_json"
}
JSON,
CURLOPT_HTTPHEADER => [
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
echo $response;
package main
import (
"bytes"
"fmt"
"io"
"net/http"
)
func main() {
req, _ := http.NewRequest("POST", "https://scan.sv-1.global.canton.network.sync.global/api/scan/v0/events", bytes.NewBufferString(`{
"after": {
"after_migration_id": 123,
"after_record_time": "<string>"
},
"page_size": 123,
"daml_value_encoding": "compact_json"
}`))
req.Header.Set("Content-Type", "application/json")
response, _ := http.DefaultClient.Do(req)
defer response.Body.Close()
body, _ := io.ReadAll(response.Body)
fmt.Println(string(body))
}
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
var request = HttpRequest.newBuilder()
.uri(URI.create("https://scan.sv-1.global.canton.network.sync.global/api/scan/v0/events"))
.header("Content-Type", "application/json")
.method("POST", HttpRequest.BodyPublishers.ofString("""
{
"after": {
"after_migration_id": 123,
"after_record_time": "<string>"
},
"page_size": 123,
"daml_value_encoding": "compact_json"
}
"""))
.build();
var response = HttpClient.newHttpClient().send(
request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
require 'net/http'
require 'uri'
uri = URI('https://scan.sv-1.global.canton.network.sync.global/api/scan/v0/events')
request = Net::HTTP::Post.new(uri)
request['Content-Type'] = 'application/json'
request.body = <<~JSON
{
"after": {
"after_migration_id": 123,
"after_record_time": "<string>"
},
"page_size": 123,
"daml_value_encoding": "compact_json"
}
JSON
response = Net::HTTP.start(uri.hostname, uri.port) do |http|
http.request(request)
end
puts response.body
{
"events": [
{
"update": {
"update_id": "<string>",
"migration_id": 123,
"workflow_id": "<string>",
"record_time": "<string>",
"synchronizer_id": "<string>",
"effective_at": "<string>",
"root_event_ids": [
"<string>"
],
"events_by_id": {},
"external_transaction_hash": "<string>"
},
"verdict": {
"update_id": "<string>",
"migration_id": 123,
"domain_id": "<string>",
"record_time": "<string>",
"finalization_time": "<string>",
"submitting_parties": [
"<string>"
],
"submitting_participant_uid": "<string>",
"verdict_result": "VERDICT_RESULT_UNSPECIFIED",
"mediator_group": 123,
"transaction_views": {
"views": [
{
"view_id": 123,
"informees": [
"<string>"
],
"confirming_parties": [
"<object>"
],
"sub_views": [
123
],
"view_hash": "<string>"
}
],
"root_views": [
123
]
}
},
"traffic_summary": {
"total_traffic_cost": 123,
"envelope_traffic_summaries": [
{
"traffic_cost": 123,
"view_ids": [
123
]
}
]
},
"app_activity_records": {
"round_number": 123,
"records": [
{
"party": "<string>",
"weight": 123
}
]
}
}
]
}
{
"error": "<string>"
}
{
"error": "<string>"
}
Body
application/json
object
OpenAPI type:
UpdateHistoryRequestAfter.The events returned will either have a higher migration id or the same migration id and a record_time greater than the migration id and record time specified.Show child attributes
Show child attributes
number
required
OpenAPI type:
integer (int64).The migration id from which to start returning transactions. This is inclusive.string
required
The record time to start returning transactions from. This only affects transactions with the same migration id as after_migration_id. Higher migration ids are always considered to be later.
number
required
OpenAPI type:
integer (int32).The maximum number of events returned for this request.Minimum: 1; Maximum: 1000.object
OpenAPI type:
DamlValueEncoding.How daml values should be encoded in the response. “compact_json” is a compact, human-readable JSON encoding. It is the same encoding as the one used in the HTTP JSON API or the JavaScript codegen. “protobuf_json” is a verbose JSON encoding that is more difficult to parse, but contains type information, i.e., the values can be parsed losslessly without having access to the Daml source code. Optional and defaults to “compact_json”.Allowed values: compact_json, protobuf_json.Responses
200
okapplication/json
EventHistoryItem[]
required
Show child attributes
Show child attributes
UpdateHistoryItemV2
An individual item in the update history. May be a transaction or a contract reassignment.
Show child attributes
Show child attributes
UpdateHistoryTransactionV2
Show child attributes
Show child attributes
string
required
The id of the update.
integer (int64)
required
The migration id of the synchronizer.
string
required
This transaction’s Daml workflow ID; a workflow ID can be associated with multiple transactions. If empty, no workflow ID was set.
string
required
The time at which the transaction was sequenced, with microsecond resolution, using ISO-8601 representation.
string
required
The id of the synchronizer through which this transaction was sequenced.
string
required
Ledger effective time, using ISO-8601 representation. This is the time returned by
getTime for all Daml executed as part of this transaction, both by the submitting participant and all confirming participants.string[]
required
Roots of the transaction tree. These are guaranteed to occur as keys of the
events_by_id object.object
required
Changes to the ledger that were caused by this transaction, keyed by ID and sorted lexicographically by ID for display consistency. Values are nodes of the transaction tree. Within a transaction, IDs may be referenced by
root_event_ids or child_event_ids in ExercisedEvent herein, which are sorted in the order as they occurred in the transaction.string
For an externally signed transaction, contains the external transaction hash signed by the external party. Can be used to correlate an external submission with a committed transaction. This field is conditionally omitted from JSON when null (see OmitNullString).
UpdateHistoryReassignment
A contract reassignment between synchronizer. May be an assignment or unassignment.
Show child attributes
Show child attributes
string
required
The id of the update.
string
required
The absolute offset. Note that this field may not be the same across nodes, and therefore should not be compared between SVs.
string
required
The time at which the transaction was sequenced.
oneOf
required
The reassignment event. May be an assignment or unassignment.
Show child attributes
Show child attributes
UpdateHistoryAssignment
Show child attributes
Show child attributes
string
required
The party ID who submitted this reassignment
string
required
The id of the synchronizer from which the contract was reassigned
string
required
The id of the synchronizer to which the contract was reassigned
integer (int64)
required
The migration id of the target synchronizer
string
required
The id of the corresponding unassign event; this assignment will usually, but not always, occur after the so-identified unassignment event.
CreatedEvent
required
The corresponding contract create event
Show child attributes
Show child attributes
string
required
string
required
The ID of this particular event. Equal to the key of this element of the containing
events_by_id if this is part of a TreeEvent.string
required
The ID of the created contract.
string
required
The template of the created contract.
string
required
The package name of the created contract.
object
required
The arguments that have been used to create the contract, in the form of JSON representation of a Daml record.
string (date-time)
required
Ledger effective time of the transaction that created the contract.
string[]
required
Signatories to the contract, in the form of party IDs.
string[]
required
Observers to the contract, in the form of party IDs.
integer (int64)
required
Each corresponding assigned and unassigned event has the same reassignment_counter. This strictly increases with each unassign command for the same contract. Creation of the contract corresponds to reassignment_counter 0.
UpdateHistoryUnassignment
Show child attributes
Show child attributes
string
required
The party who submitted this reassignment
string
required
The id of the synchronizer from which the contract was reassigned
integer (int64)
required
The migration id of the synchronizer from which the contract was reassigned
string
required
The id of the synchronizer to which the contract was reassigned
string
required
The id of the unassign event, to later be correlated to an assign event
integer (int64)
required
Each corresponding assigned and unassigned event has the same reassignment_counter. This strictly increases with each unassign command for the same contract. Creation of the contract corresponds to reassignment_counter 0.
string
required
The id of the unassigned contract
EventHistoryVerdict
Show child attributes
Show child attributes
string
required
The ID of the transaction update associated with this verdict.
integer (int64)
required
The migration id of the domain through which this event was sequenced.
string
required
The id of the domain through which this event was sequenced.
string
required
The record_time of the transaction the verdict corresponds to.
string
required
The finalization_time of the transaction the verdict corresponds to. Note that this time might be different between different scans/mediators.
string[]
required
Parties on whose behalf the transaction was submitted.
string
required
UID of the submitting participant.
VerdictResult
required
Result of the verdict.Allowed values:
VERDICT_RESULT_UNSPECIFIED, VERDICT_RESULT_ACCEPTED, VERDICT_RESULT_REJECTED.integer (int32)
required
The mediator group which finalized this verdict.
TransactionViews
required
Show child attributes
Show child attributes
TransactionView[]
required
Show child attributes
Show child attributes
integer (int32)[]
required
EventHistoryTrafficSummary
Traffic summary data from the sequencer for the confirmation request corresponding to an event.
Show child attributes
Show child attributes
integer (int64)
required
Total traffic cost of the confirmation request paid by the validator node that submitted it.
EventHistoryAppActivityRecords
App activity record computed from verdicts and traffic summaries as per CIP-104.
400
bad requestapplication/json
string
required
500
internal server errorapplication/json
string
required
History
Updated
0.6.10The POST /v0/events operation changed in this snapshot.
Updated
0.6.0The POST /v0/events operation changed in this snapshot.
Updated
0.5.17The POST /v0/events operation changed in this snapshot.
Updated
0.5.15The POST /v0/events operation changed in this snapshot.
Added
0.5.10