API Reference
Signers
Ed25519 public keys registered on the ledger and assigned to circles — used to verify the cryptographic proof attached to every write request.
List signers
Authorization
BearerAuth LedgerHeader AuthorizationBearer <token>
Access token obtained from POST /oauth/token
In: header
x-ledger<token>
Handle of the target ledger (e.g. demo-co)
In: header
Query Parameters
limit?integer
Maximum records to return
Default
25Range
value <= 100offset?integer
Records to skip
Default
0Response Body
application/json
curl -X GET "https://demo-co.ldg-stg.one/api/v2/signers"{
"data": [
{
"handle": "svc-bridge-rojo",
"schema": "service",
"public": "MCowBQYDK2VdAyEAabc123...",
"custom": {}
}
],
"meta": {
"total": 4,
"limit": 25,
"offset": 0
}
}Register signer
Authorization
BearerAuth LedgerHeader AuthorizationBearer <token>
Access token obtained from POST /oauth/token
In: header
x-ledger<token>
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/signers" \ -H "Content-Type: application/json" \ -d '{ "data": { "handle": "svc-bridge-rojo", "schema": "service", "public": "MCowBQYDK2VdAyEAabc123...", "custom": { "description": "Bridge signer for bancorojo.com.co/minka" } } }'{
"data": {
"handle": "svc-bridge-rojo",
"schema": "service",
"public": "MCowBQYDK2VdAyEAabc123...",
"custom": {}
}
}Get signer
Authorization
BearerAuth LedgerHeader AuthorizationBearer <token>
Access token obtained from POST /oauth/token
In: header
x-ledger<token>
Handle of the target ledger (e.g. demo-co)
In: header
Path Parameters
handle*string
Record handle
Response Body
application/json
application/json
curl -X GET "https://demo-co.ldg-stg.one/api/v2/signers/pay-20260608-001"{
"data": {
"handle": "svc-bridge-rojo",
"schema": "service",
"public": "MCowBQYDK2VdAyEAabc123..."
}
}{
"error": {
"code": "not-found",
"message": "Wallet not found"
}
}