Skip to main content

GET /auth/pubkeys

List session keys registered to a merchant address. Useful when rotating keys: read the registry, register the new key, then deregister the old one.

Request

GET /auth/pubkeys?owner=0xMerchant…
QueryRequiredNotes
owneryesThe merchant address whose registered keys you want.

Strict-auth deployments require the session-signed headers; soft-auth treats them as optional but still validates them when present.

Response

200 OK

{
"ownerAddress": "0xMerchant…",
"pubkeys": [
{
"publicKey": "0x04abc…",
"registeredAt": 1730393820,
"expiresAt": 1738169820,
"lastSeenNonce": 1730450123456
}
]
}

lastSeenNonce is the highest nonce the server has accepted for that key — your next signed call must use a strictly greater value.