Get a Provider by ID — GET /v1/providers/:provider_id

Retrieve a single provider record by provider_id. Returns the full ProviderRecord including DID, status, and registration timestamp.

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

Code	Meaning
200 OK	Provider found. Returns the full ProviderRecord.
404 Not Found	No 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"
}