---
title: "Register a vet with VetHubRx (action \"A\") and store the verification URL."
method: POST
path: "/erx/provider-registrations"
tags: ["Erx"]
---

# Register a vet with VetHubRx (action "A") and store the verification URL.

`POST /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/post.ts> (a function with typed inputs; its response is checked against the schema)

## Request body

- RegisterErxProviderRequestDto: Register a vet with the e-prescribing vendor. Practice address/phone are supplied explicitly (the DynamoDB clinic profile stores address as one free-text string, and the vendor's provider directory validates structured fields) — the UI prefills them from the clinic profile for the admin to confirm.
  - `userId` string
  - `address1` string
  - `city` string
  - `state` string
  - `postalCode` string
  - `phone` string

## Response `200`

OK

- ErxProviderDto: One provider row in the eRx roster: eligibility + registration + verification state.
  - `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/post.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)