--- title: "Get organization provider" method: GET path: "/api/organization-providers/v3/{organization_provider_id}" tags: ["v3"] --- # Get organization provider `GET /api/organization-providers/v3/{organization_provider_id}` ## Request - Base URL: `https://pre-api.joincandidhealth.com` - URL: `https://pre-api.joincandidhealth.com/api/organization-providers/v3/{organization_provider_id}` - Auth: HTTP bearer ## Path parameters - `organization_provider_id` string, uuid, required ## Response `200` Response with status 200 - OrganizationProvidersV3OrganizationProviderV2 - `npi` string, required: The NPI of the provider. This must be all digits [0-9] and exactly 10 characters long. - `is_rendering` boolean, required: Whether the provider can be used to render services. - `is_billing` boolean, required: Whether the provider can be used to bill services. - `first_name` string: The first name of the provider, if the provider is an individual. - `last_name` string: The last name of the provider, if the provider is an individual. - `organization_name` string: The name of the provider, if the provider is an organization. - `provider_type` 'INDIVIDUAL' | 'ORGANIZATION', required - `tax_id` string: If the provider has a contract with insurance, this must be the same tax ID given to the payer on an IRS W-9 form completed during contracting. - `taxonomy_code` string: A code designating classification and specialization. - `license_type` 'MD' | 'NP' | 'PA' | 'LMFT' | 'LCPC' | 'LCSW' | 'PMHNP' | 'FNP' | 'LPCC' | 'DO' | 'RD' | 'SLP' | 'APRN' | 'LPC' | 'PHD' | 'PSYD' | 'LMSW' | 'LMHC' | 'OTHER_MASTERS' | 'BCBA' | 'UNKNOWN' | 'RPH' | 'PHT' | 'LAC' | 'LMT' | 'DC' | 'ND' | 'MA' | 'PT' | 'IBCLC' | 'RN' | 'DPT' | 'LCMHC' | 'CNM' | 'RNFA' | 'ACSW' | 'APC' | 'BCABA' | 'BHA' | 'OD' | 'DPM' | 'DA' | 'DDS' | 'DEH' | 'DMD' | 'PTA' | 'LCADC' | 'LCAT' | 'LCMHCS' | 'LCMHCA' | 'LCSWA' | 'LICSW' | 'LISW' | 'LMFTS' | 'LMFTA' | 'LPCI' | 'LSCSW' | 'MHCA' | 'MHT' | 'RBT' | 'RCSWI' | 'RHMCI' | 'LPN' | 'OTD' | 'OMS' | 'MFTA' | 'APCC' | 'DNP' | 'AGNPBC' | 'ANP' | 'FNPPP' | 'LCSWR' | 'ALC' | 'RMFTI' | 'LAMFT' | 'LPCA' | 'LSWI' | 'CSW' | 'CPC' | 'LGMFT' | 'LLPC' | 'PLPC' | 'PLMFT' | 'LMHCA' | 'CIT' | 'CT' | 'MFT' | 'LSW' | 'PLMHP' | 'PCMSW' | 'LMHP' | 'OTR/L' | 'RPA' | 'COTA' | 'CRNP' | 'SLP-CF' | 'NP-C' | 'PA-C' | 'AMFT' | 'CDN' | 'CGC' | 'CNS' | 'MDPHD' | 'AuD' | 'ATC' | 'LAT' | 'OTA' | 'LSSP' | 'SLPA' | 'EdD' | 'SWT' | 'IMFT' | 'RT', required - `addresses` OrganizationProvidersV2OrganizationProviderAddress[]: The addresses associated with this provider. - `address` CommonsStreetAddressLongZip, required - `address1` string, required - `address2` string - `city` string, required - `state` 'AA' | 'AE' | 'AP' | 'AL' | 'AK' | 'AS' | 'AZ' | 'AR' | 'CA' | 'CO' | 'CT' | 'DC' | 'DE' | 'FL' | 'FM' | 'GA' | 'GU' | 'HI' | 'ID' | 'IL' | 'IN' | 'IA' | 'KS' | 'KY' | 'LA' | 'ME' | 'MD' | 'MA' | 'MH' | 'MI' | 'MN' | 'MP' | 'MS' | 'MO' | 'MT' | 'NE' | 'NV' | 'NH' | 'NJ' | 'NM' | 'NY' | 'NC' | 'ND' | 'OH' | 'OK' | 'OR' | 'PA' | 'PR' | 'PW' | 'RI' | 'SC' | 'SD' | 'TN' | 'TX' | 'UT' | 'VI' | 'VT' | 'VA' | 'WA' | 'WV' | 'WI' | 'WY' | 'FC', required - `zip_code` string, required: 5-digit zip code - `zip_plus_four_code` string, required: 4-digit zip add-on code https://en.wikipedia.org/wiki/ZIP_Code#ZIP+4 - `address_type` 'DEFAULT', required - `employment_start_date` string, date: The employment start date for the provider. - `employment_termination_date` string, date: The employment termination date for the provider. - `organization_provider_id` string, uuid, required - `qualifications` IdentifiersIdentifier[], required: Qualification given to a provider (PTAN, Medicaid Provider Id etc.). - `period` CommonsDateRangeOptionalEnd - `start_date` string, required: ISO 8601 date; formatted YYYY-MM-DD (i.e. 2012-02-01) - `end_date` string: ISO 8601 date; formatted YYYY-MM-DD (i.e. 2012-02-01) - `identifier_code` 'MCR' | 'MCD', required - `identifier_value` union, required - object - `type` 'medicare_provider_identifier', required: Discriminator value: medicare_provider_identifier - `state` 'AA' | 'AE' | 'AP' | 'AL' | 'AK' | 'AS' | 'AZ' | 'AR' | 'CA' | 'CO' | 'CT' | 'DC' | 'DE' | 'FL' | 'FM' | 'GA' | 'GU' | 'HI' | 'ID' | 'IL' | 'IN' | 'IA' | 'KS' | 'KY' | 'LA' | 'ME' | 'MD' | 'MA' | 'MH' | 'MI' | 'MN' | 'MP' | 'MS' | 'MO' | 'MT' | 'NE' | 'NV' | 'NH' | 'NJ' | 'NM' | 'NY' | 'NC' | 'ND' | 'OH' | 'OK' | 'OR' | 'PA' | 'PR' | 'PW' | 'RI' | 'SC' | 'SD' | 'TN' | 'TX' | 'UT' | 'VI' | 'VT' | 'VA' | 'WA' | 'WV' | 'WI' | 'WY' | 'FC', required - `provider_number` string, required - `organization_service_facility_id` string, uuid - object - `type` 'medicaid_provider_identifier', required: Discriminator value: medicaid_provider_identifier - `state` 'AA' | 'AE' | 'AP' | 'AL' | 'AK' | 'AS' | 'AZ' | 'AR' | 'CA' | 'CO' | 'CT' | 'DC' | 'DE' | 'FL' | 'FM' | 'GA' | 'GU' | 'HI' | 'ID' | 'IL' | 'IN' | 'IA' | 'KS' | 'KY' | 'LA' | 'ME' | 'MD' | 'MA' | 'MH' | 'MI' | 'MN' | 'MP' | 'MS' | 'MO' | 'MT' | 'NE' | 'NV' | 'NH' | 'NJ' | 'NM' | 'NY' | 'NC' | 'ND' | 'OH' | 'OK' | 'OR' | 'PA' | 'PR' | 'PW' | 'RI' | 'SC' | 'SD' | 'TN' | 'TX' | 'UT' | 'VI' | 'VT' | 'VA' | 'WA' | 'WV' | 'WI' | 'WY' | 'FC', required - `provider_number` string, required - `organization_service_facility_id` string, uuid - `identifier_id` string, uuid, required ## Other responses - `404`: Error response with status 404 ## Changes - **2026-10-15** `97de8fddb088`: 1 warning - added the new `RT` enum value to the `license_type` response property for the response status `200` - **2026-09-17** `24b2d80d577a`: 1 breaking, 1 warning, 17 info - the response's body type changed from no type to `object` for status `200` - deleted the `header` request parameter `Authorization` - the endpoint scheme security `OAuthScheme` was added to the API - for the `path` request parameter `organization_provider_id`, the type was generalized from no type to `string`, and format from no format to `uuid` - …15 more - **2026-09-12** `3a81ee81d4ed`: 1 info - api operation id `get` removed and replaced with `v3_get_2` [Operation history](https://skmtc.dev/joincandidhealth/apis/api-reference/changes/api/organization-providers/v3/:organization_provider_id/get.md) --- [API](https://skmtc.dev/joincandidhealth/apis/api-reference.md) - [All operations](https://skmtc.dev/joincandidhealth/apis/api-reference/llms.txt) - [OpenAPI document](https://skmtc.dev/joincandidhealth/apis/api-reference/revisions/d8b0a61873e2?raw)