---
title: "Get provider details"
method: GET
path: "/v1/internal/provider"
tags: ["Internal"]
---

# Get provider details

`GET /v1/internal/provider`

Returns base URL, provider and user details, environment, validation, and GlobalProviderId. Client ID and API key are required. **At least one** of ProviderTaxId, VendorId, or GlobalProviderId is required; you may send more than one if every value resolves to the same agency in HHA (otherwise the request is rejected). Environment and HHA session use ClientMappings.Env for the resolved agency. AppVersionId is optional; when omitted, BaseUrl, ProviderVersion, and ProviderMinorVersion are null; ProviderId is the resolved VendorID (same as Validation.VendorID).

## Query parameters

- `ClientId` string, required — Client ID (mandatory)
- `XApiKey` string, required — API key (mandatory)
- `ProviderTaxId` string, nullable — Federal tax number (numeric). One of ProviderTaxId, VendorId, or GlobalProviderId required.
- `VendorId` integer, nullable — HHA VendorID / agency id. One of ProviderTaxId, VendorId, or GlobalProviderId required.
- `GlobalProviderId` string, uuid, nullable — dbo.Vendors.GlobalProviderId (UUID). One of ProviderTaxId, VendorId, or GlobalProviderId required.
- `AppVersionId` integer[], nullable — One or more app version IDs (optional; default [35]) for URL lookup.

## Response `200`

Successful Response

- ProviderDetailsResponse — Response for GET /internal/provider: base URL, provider and user details, environment, validation.
  - `Message` string
  - `ClientId` string
  - `XApiKey` string
  - `BaseUrl` string, nullable
  - `ProviderVersion` number, nullable
  - `ProviderMinorVersion` number, nullable
  - `ProviderId` integer, nullable
  - `ProviderTaxId` string, nullable
  - `GlobalProviderId` string, uuid, nullable
  - `UserId` integer
  - `UserName` string
  - `Environment` string
  - `Validation` object

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/hhaexchange/apis/fastapi.md) · [All operations](https://skmtc.net/hhaexchange/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hhaexchange/fastapi/revisions/17ca04f67931/schema)