List All the Registered Providers — GET /v1/providers

Retrieve all registered providers on this ServiceNet node. Returns an items array of ProviderRecord objects including status and DID.

Returns every provider record stored on this node, including active and revoked entries.

Request

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

No path parameters, query parameters, or request body required.

Response

Returns a JSON object with a single items array. Each element is a ProviderRecord.

items · ProviderRecord[] · required

Array of all registered provider records.

Show ProviderRecord fields

schema_version · integer

Protocol schema version. Currently 1.

provider_id · string

Unique human-readable identifier for the provider (e.g. "acme-labs").

provider_did · string

Decentralized Identifier (DID) controlling this provider (e.g. "did:key:z6Mk…").

display_name · string

Optional human-readable display name for the provider.

status · string

Provider lifecycle status. One of "active" or "revoked".

registered_at · string

ISO 8601 timestamp of when the provider was registered.

revoked_at · string

ISO 8601 timestamp of when the provider was revoked. Omitted if not revoked.

revoke_reason · string

Human-readable reason for revocation. Omitted if not revoked.

Status codes

Code	Meaning
200 OK	Request succeeded. Returns { "items": [...] }. The array is empty if no providers are registered.

Example response

{
  "items": [
    {
      "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"
    },
    {
      "schema_version": 1,
      "provider_id": "old-provider",
      "provider_did": "did:key:z6MkpTHR8VNsBxYAAWHut2GeaddA1bbm8CLcfJ4pKzvmWwLp",
      "status": "revoked",
      "registered_at": "2024-11-01T09:00:00Z",
      "revoked_at": "2025-03-10T14:22:00Z",
      "revoke_reason": "Provider decommissioned"
    }
  ]
}