> ## Documentation Index
> Fetch the complete documentation index at: https://hs-df36fa00.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 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

```bash theme={null}
curl http://your-node:8042/v1/providers/acme-labs
```

### Path parameters

<ParamField path="provider_id" type="string" required>
  The unique identifier of the provider to retrieve (e.g. `"acme-labs"`).
</ParamField>

## Response

Returns a `ProviderRecord` on success.

<ResponseField name="schema_version" type="integer">
  Protocol schema version. Currently `1`.
</ResponseField>

<ResponseField name="provider_id" type="string">
  Unique identifier for the provider.
</ResponseField>

<ResponseField name="provider_did" type="string">
  The DID controlling this provider.
</ResponseField>

<ResponseField name="display_name" type="string">
  Optional human-readable display name. Omitted if not set.
</ResponseField>

<ResponseField name="status" type="string">
  Provider lifecycle status. Either `"active"` or `"revoked"`.
</ResponseField>

<ResponseField name="registered_at" type="string">
  ISO 8601 timestamp of when the provider was first registered.
</ResponseField>

<ResponseField name="revoked_at" type="string">
  ISO 8601 timestamp of revocation. Omitted if the provider is still active.
</ResponseField>

<ResponseField name="revoke_reason" type="string">
  Human-readable reason for revocation. Omitted if the provider is still active.
</ResponseField>

## 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

```json theme={null}
{
  "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"
}
```