---
title: "The provider roster: every eligible vet with registration + verification state, plus whether the integration is configured/enabled. Polls the vendor for registrations that aren't in a terminal state (design: poll on surface load)."
method: GET
path: "/erx/provider-registrations"
tags: ["Erx"]
---

# The provider roster: every eligible vet with registration + verification state, plus whether the integration is configured/enabled. Polls the vendor for registrations that aren't in a terminal state (design: poll on surface load).

`GET /erx/provider-registrations`

## Request

- Base URL: `https://api.clinicos.vet/backend/business`
- URL: `https://api.clinicos.vet/backend/business/erx/provider-registrations`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/clinicos/apis/pawthosx-business-api-v1/docs/erx/provider-registrations/get.ts> (a function with typed inputs; its response is checked against the schema)

## Response `200`

OK

- ErxProviderRosterDto: The eRx provider roster plus the integration state the settings UI needs.
  - `configured` boolean: Platform credentials present (env config) — false on envs without the key.
  - `enabled` boolean: The per-clinic ErxSettings.VetHubRxEnabled gate.
  - `providers` ErxProviderDto[]
    - `userId` string
    - `displayName` string
    - `email` string
    - `licenseNumber` string, nullable
    - `licenseState` string, nullable
    - `missingRequirements` string[]: What blocks registration, e.g. "license". Empty when registrable.
    - `registered` boolean
    - `verificationStatus` string, nullable: not_started | pending | verified | failed | unknown. Null when not registered.
    - `verificationUrl` string, nullable
    - `registeredAt` string, date-time, nullable
    - `verifiedAt` string, date-time, nullable
    - `lastPolledAt` string, date-time, nullable
    - `lastError` string, nullable

## Changes

- **2026-08-26** `a57456aa87b0`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/clinicos/apis/pawthosx-business-api-v1/changes/erx/provider-registrations/get.md)

---

[API](https://skmtc.dev/clinicos/apis/pawthosx-business-api-v1.md) - [All operations](https://skmtc.dev/clinicos/apis/pawthosx-business-api-v1/llms.txt) - [OpenAPI document](https://skmtc.dev/clinicos/apis/pawthosx-business-api-v1/revisions/099cf36186e0?raw)