HHhhaexchange
Internal

Get provider details

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).

get/v1/internal/provider

Request

  • Base URL
    https://api.hhaexchange.com (the document declares no server; this is the origin it was published from)
  • URL
    https://api.hhaexchange.com/v1/internal/provider
  • Auth
    OAuth 2
    Client credentials
    Token URL: https://api.hhaexchange.com/v1/fhir/auth/token scopes: read

Query parameters

ClientIdstring required

Client ID (mandatory)

XApiKeystring required

API key (mandatory)

ProviderTaxIdstring nullable

Federal tax number (numeric). One of ProviderTaxId, VendorId, or GlobalProviderId required.

VendorIdinteger nullable

HHA VendorID / agency id. One of ProviderTaxId, VendorId, or GlobalProviderId required.

GlobalProviderIdstring uuid nullable

dbo.Vendors.GlobalProviderId (UUID). One of ProviderTaxId, VendorId, or GlobalProviderId required.

AppVersionIdinteger[] nullable

One or more app version IDs (optional; default [35]) for URL lookup.

Response

Successful Response

Messagestring
ClientIdstring
XApiKeystring
BaseUrlstring nullable
ProviderVersionnumber nullable
ProviderMinorVersionnumber nullable
ProviderIdinteger nullable
ProviderTaxIdstring nullable
GlobalProviderIdstring uuid nullable
UserIdinteger
UserNamestring
Environmentstring
Validationobject

Changes

No recorded changes to this operation across all 3 revisions of this API.