Skip to main content
Fetches the full record for a single provider by its unique identifier.

​
Request

curl http://your-node:8042/v1/providers/acme-labs

​
Path parameters

​
provider_id
string
required
The unique identifier of the provider to retrieve (e.g. "acme-labs").

​
Response

Returns a ProviderRecord on success.
​
schema_version
integer
Protocol schema version. Currently 1.
​
provider_id
string
Unique identifier for the provider.
​
provider_did
string
The DID controlling this provider.
​
display_name
string
Optional human-readable display name. Omitted if not set.
​
status
string
Provider lifecycle status. Either "active" or "revoked".
​
registered_at
string
ISO 8601 timestamp of when the provider was first registered.
​
revoked_at
string
ISO 8601 timestamp of revocation. Omitted if the provider is still active.
​
revoke_reason
string
Human-readable reason for revocation. Omitted if the provider is still active.

​
Status codes

CodeMeaning
200 OKProvider found. Returns the full ProviderRecord.
404 Not FoundNo provider with the given provider_id exists on this node.

​
Example response

{
  "schema_version": 1,
  "provider_id": "acme-labs",
  "provider_did": "did:key:z6MkhaXgBZDvotD1X9gRrYkM5Xq9jYQqK6d8r8bQdE1mV2Xa",
  "display_name": "Acme Labs",
  "status": "active",
  "registered_at": "2025-01-15T10:00:00Z"
}