APIPartnersGet the partner profile
Get the partner profile
Your partner profile, nodes and webhook.
- Auth Partner key
- Rate-limited Yes
- Guide Partner access
GET
Your partner id, the nodes you answer for, and your webhook URL and events (every event when none were chosen).
partnerKeyheader
AuthorizationBearer <token>Partner key delivered by a one-time link. Works on /v1/partner/* only.
Partner profile.
application/json- response
partnerId*stringname*stringnodes*array<string>webhook*asOf*stringMatch
^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}\.[0-9]{3}Z$Format
date-timeschemaVersion*stringWire schema version, "1.1" today.
Value in
"1.0""1.1"chainTip*|nullcurl -X GET 'https://cosign.exchain.network/v1/partner'Example Response
{ "partnerId": "acme-platform", "name": "Acme Agents", "nodes": [ "acme-node-1", "acme-node-2" ], "webhook": { "url": "https://admin.acme.example/api/exchain/webhooks", "events": [ "decision.landed", "decision.released", "decision.alarm", "wallet.state_changed", "signing.state_changed", "quorum.state_changed", "webhook.test" ] }, "asOf": "2026-11-05T14:22:07.318Z", "schemaVersion": "1.1", "chainTip": null}Errors
| Status | Code | Meaning |
|---|---|---|
401 | unauthorized | A partner key is required: the bearer is missing, unknown, reset or revoked. |
429 | rate_limited | Over the limit; retry after Retry-After seconds (also in retryAfterSec). |
Every code and what to do about it: Errors and codes.