Circles
Named signer groups (`owner`, `admin`, `operations`, `security`, `support`, `services`) used in access-control policies to grant permissions to sets of Ed25519 keys.
List circles
Authorization
BearerAuth LedgerHeader Access token obtained from POST /oauth/token
In: header
Handle of the target ledger (e.g. demo-co)
In: header
Query Parameters
Maximum records to return
25value <= 100Records to skip
0Response Body
application/json
curl -X GET "https://demo-co.ldg-stg.one/api/v2/circles"{
"data": [
{
"handle": "owner"
},
{
"handle": "admin"
},
{
"handle": "operations"
},
{
"handle": "security"
},
{
"handle": "support"
},
{
"handle": "services"
}
],
"meta": {
"total": 6,
"limit": 25,
"offset": 0
}
}Create circle
Authorization
BearerAuth LedgerHeader Access token obtained from POST /oauth/token
In: header
Handle of the target ledger (e.g. demo-co)
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
curl -X POST "https://demo-co.ldg-stg.one/api/v2/circles" \ -H "Content-Type: application/json" \ -d '{ "data": { "handle": "services" } }'{
"data": {
"handle": "services"
}
}Get circle
Authorization
BearerAuth LedgerHeader Access token obtained from POST /oauth/token
In: header
Handle of the target ledger (e.g. demo-co)
In: header
Path Parameters
Record handle
Response Body
application/json
application/json
curl -X GET "https://demo-co.ldg-stg.one/api/v2/circles/pay-20260608-001"{
"data": {
"handle": "services"
}
}{
"error": {
"code": "not-found",
"message": "Wallet not found"
}
}Assign signer to circle
Authorization
BearerAuth LedgerHeader Access token obtained from POST /oauth/token
In: header
Handle of the target ledger (e.g. demo-co)
In: header
Path Parameters
Record handle
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
curl -X POST "https://demo-co.ldg-stg.one/api/v2/circles/pay-20260608-001/signers" \ -H "Content-Type: application/json" \ -d '{ "data": { "handle": "svc-bridge-rojo" } }'{
"error": {
"code": "not-found",
"message": "Wallet not found"
}
}