> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.taigabilling.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.taigabilling.com/_mcp/server.

# Create facility credentialing span

POST https://api.taigabilling.com/api/provider-credentialing-span/v2/facility
Content-Type: application/json

Reference: https://docs.taigabilling.com/api-reference/credentialing-v-2/credentialing-v-2-create-facility

## Authentication

- `Authorization` header (bearer token, required) — Send your Taiga API key as a Bearer token. Create and manage keys in the Taiga developer portal.

## Servers

- `https://api.taigabilling.com` (Production, default)
- `https://api-staging.taigabilling.com` (Staging)

## Request

### Body (application/json)

This endpoint expects an object.

- `service_facility_id` (string, required) — The ID of the service facility covered by the credentialing span.
- `contracting_provider_id` (string, required) — The ID of the billing provider for which the rendering provider is covered by the credentialing span.
- `payer_uuid` (string, required) — The ID of the payer covered by the credentialing span.
- `start_date` (date, optional, nullable) — Start date of the credentialing span.
- `end_date` (date, optional, nullable) — End date of the credentialing span.
- `submitted_date` (date, optional, nullable) — Date that the credential paperwork was submitted.
- `payer_loaded_date` (date, optional, nullable) — Date that the payer loaded the credentialing span into their system.

## Response

### 200

- `contracting_provider` (organization-providersv3OrganizationProviderV2, required) — The practice location at which the rendering provider is covered by the credentialing span.
- `credentialing_status` (enum, required) — Status of the credentialing span.
  - Allowed values: `work_in_progress`, `pending`, `effective`, `expired`
- `facility_credentialing_span_id` (string, required)
- `is_enabled` (boolean, required) — Is the credentialing span enabled?
- `payer` (payersv3Payer, required) — The payer doing the credentialing.
- `service_facility` (organization-service-facilitiesv2OrganizationServiceFacility, required) — The service facility covered by the credentialing span.
- `end_date` (date, optional, nullable) — End date of the credentialing span.
- `payer_loaded_date` (date, optional, nullable) — Date that the payer loaded the credentialing span into their system.
- `start_date` (date, optional, nullable) — Start date of the credentialing span.
- `submitted_date` (date, optional, nullable) — Date that the credential paperwork was submitted.

## Errors

### 403 Forbidden Error

- `Credentialing_v2_createFacilityRequestForbiddenError`
  - CredentialingV2CreateFacilityRequestForbiddenError0

### 422 Unprocessable Entity Error

- `Credentialing_v2_createFacilityRequestUnprocessableEntityError`
  - CredentialingV2CreateFacilityRequestUnprocessableEntityError0

## Types

### organization-providersv3OrganizationProviderV2

- `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.
- `provider_type` (enum, required) — Whether the provider is an individual (NPPES Type 1) or organization (NPPES Type 2) provider.
  - Allowed values: `INDIVIDUAL`, `ORGANIZATION`
- `license_type` (enum, required) — The type of license that the provider holds.
  - Allowed values: `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`
- `organization_provider_id` (string, required) — Auto-generated ID set on creation.
- `qualifications` (list of Identifier, required) — Qualification given to a provider (PTAN, Medicaid Provider Id etc.).
- `first_name` (string, optional, nullable) — The first name of the provider, if the provider is an individual.
- `last_name` (string, optional, nullable) — The last name of the provider, if the provider is an individual.
- `organization_name` (string, optional, nullable) — The name of the provider, if the provider is an organization.
- `tax_id` (string, optional, nullable) — 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, optional, nullable) — A code designating classification and specialization.
- `addresses` (list of organization-providersv2OrganizationProviderAddress, optional, nullable) — The addresses associated with this provider.
- `employment_start_date` (date, optional, nullable) — The employment start date for the provider.
- `employment_termination_date` (date, optional, nullable) — The employment termination date for the provider.

### payersv3Payer

- `payer_uuid` (string, required) — Auto-generated ID set on creation.
- `payer_id` (string, required) — The primary national payer ID of the payer.
- `payer_name` (string, required) — The primary display name of the payer.
- `availity_payer_name` (string, optional, nullable) — The name of the payer as it appears in Availity.
- `availity_claims_payer_id` (string, optional, nullable) — The ID of the payer as it appears in Availity.
- `availity_eligibility_id` (string, optional, nullable) — The eligibility ID of the payer as it appears in Availity.
- `availity_remittance_payer_id` (string, optional, nullable) — The remittance ID of the payer as it appears in Availity.
- `street_address` (StreetAddressLongZip, optional, nullable)

### organization-service-facilitiesv2OrganizationServiceFacility

- `organization_service_facility_id` (string, required)
- `name` (string, required) — The name of the service facility.
- `aliases` (list of string, required) — A list of alternate names for the service facility.
- `telecoms` (list of string, required) — A list of contact methods for the service facility.
- `address` (StreetAddressLongZip, required) — The address of the service facility.
- `description` (string, optional, nullable) — A description of the service facility.
- `external_id` (string, optional, nullable) — An ID for this service facility used in an external system (e.g. your EMR). Service facilities can be queried by this field.
- `npi` (string, optional, nullable) — An NPI specific to the service facility if applicable, i.e. if it has one and is not under the billing provider's NPI. Box 32 section (a) of the CMS-1500 claim form.
- `place_of_service_code` (enum, optional, nullable) — The Place of Service (POS) code for this service facility.
  - Allowed values: `01`, `02`, `03`, `04`, `05`, `06`, `07`, `08`, `09`, `10`, `11`, `12`, `13`, `14`, `15`, `16`, `17`, `18`, `19`, `20`, `21`, `22`, `23`, `24`, `25`, `26`, `31`, `32`, `33`, `34`, `41`, `42`, `49`, `50`, `51`, `52`, `53`, `54`, `55`, `56`, `57`, `58`, `60`, `61`, `62`, `65`, `71`, `72`, `81`, `99`
- `clia_number` (string, optional, nullable) — The associated CLIA number with this service facility. Can be used to populate CLIA numbers on encounters.
- `mammography_certification_number` (string, optional, nullable) — The associated mammography certification number for this service facility. This is a 6 digit code assigned by the FDA.
- `status` (enum, optional, nullable) — The status of the service facility.
  - Allowed values: `active`, `inactive`, `suspended`
- `operational_status` (enum, optional, nullable) — The operational status of the service facility.
  - Allowed values: `C`, `H`, `I`, `K`, `O`, `U`
- `mode` (enum, optional, nullable) — The mode of the service facility.
  - Allowed values: `instance`, `kind`
- `type` (enum, optional, nullable) — The type of the service facility.
  - Allowed values: `DX`, `CVDX`, `CATH`, `ECHO`, `GIDX`, `ENDOS`, `RADDX`, `RADO`, `RNEU`, `HOSP`, `CHR`, `GACH`, `MHSP`, `PSYCHF`, `RH`, `RHAT`, `RHII`, `RHMAD`, `RHPI`, `RHPIH`, `RHPIMS`, `RHPIVS`, `RHYAD`, `HU`, `BMTU`, `CCU`, `CHEST`, `EPIL`, `ER`, `ETU`, `HD`, `HLAB`, `INLAB`, `OUTLAB`, `HRAD`, `HUSCS`, `ICU`, `PEDICU`, `PEDNICU`, `INPHARM`, `MBL`, `NCCS`, `NS`, `OUTPHARM`, `PEDU`, `PHU`, `RHU`, `SLEEP`, `NCCF`, `SNF`, `OF`, `ALL`, `AMPUT`, `BMTC`, `BREAST`, `CANC`, `CAPC`, `CARD`, `PEDCARD`, `COAG`, `CRS`, `DERM`, `ENDO`, `PEDE`, `ENT`, `FMC`, `GI`, `PEDGI`, `GIM`, `GYN`, `HEM`, `PEDHEM`, `HTN`, `IEC`, `INFD`, `PEDID`, `INV`, `LYMPH`, `MGEN`, `NEPH`, `PEDNEPH`, `NEUR`, `OB`, `OMS`, `ONCL`, `PEDHO`, `OPH`, `OPTC`, `ORTHO`, `HAND`, `PAINCL`, `PC`, `PEDC`, `PEDRHEUM`, `POD`, `PREV`, `PROCTO`, `PROFF`, `PROS`, `PSI`, `PSY`, `RHEUM`, `SPMED`, `SU`, `PLS`, `URO`, `TR`, `TRAVEL`, `WND`, `RTF`, `PRC`, `SURF`, `DADDR`, `MOBL`, `AMB`, `PHARM`, `ACC`, `COMM`, `CSC`, `PTRES`, `SCHOOL`, `UPC`, `WORK`
- `physical_type` (enum, optional, nullable) — The physical type of the service facility.
  - Allowed values: `si`, `bu`, `wi`, `wa`, `lvl`, `co`, `ro`, `bd`, `ve`, `ho`, `ca`, `rd`, `area`, `jdn`

### CredentialingV2CreateFacilityRequestForbiddenError0

- `errorName` (enum, optional)
  - Allowed values: `HttpRequestValidationsError`
- `content` (UnauthorizedErrorMessage, optional)

### CredentialingV2CreateFacilityRequestUnprocessableEntityError0

- `errorName` (enum, optional)
  - Allowed values: `HttpRequestValidationsError`
- `content` (list of RequestValidationError, optional)

### Identifier

- `identifier_code` (enum, required)
  - Allowed values: `MCR`, `MCD`
- `identifier_id` (string, required)
- `identifier_value` (IdentifierValue, required)
- `period` (DateRangeOptionalEnd, optional, nullable)

### organization-providersv2OrganizationProviderAddress

- `address` (StreetAddressLongZip, required) — The address of the provider
- `address_type` (enum, required) — The address type of the provider
  - Allowed values: `DEFAULT`

### StreetAddressLongZip

- `address1` (string, required)
- `city` (string, required)
- `state` (enum, required)
  - Allowed values: `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`
- `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
- `address2` (string, optional, nullable)

### UnauthorizedErrorMessage

- `message` (string, optional, nullable)

### RequestValidationError

- `fieldName` (string, required)
- `humanReadableMessage` (string, optional, nullable)

### IdentifierValue

- IdentifierValue0
- IdentifierValue1

### DateRangeOptionalEnd

- `start_date` (string, required) — ISO 8601 date; formatted YYYY-MM-DD (i.e. 2012-02-01)
- `end_date` (string, optional, nullable) — ISO 8601 date; formatted YYYY-MM-DD (i.e. 2012-02-01)

### IdentifierValue0

- `provider_number` (string, required)
- `state` (enum, required)
  - Allowed values: `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`
- `type` (enum, required)
  - Allowed values: `medicare_provider_identifier`
- `organization_service_facility_id` (string, optional, nullable) — When set, this identifier applies only to the given service facility.

### IdentifierValue1

- `provider_number` (string, required)
- `state` (enum, required)
  - Allowed values: `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`
- `type` (enum, required)
  - Allowed values: `medicaid_provider_identifier`
- `organization_service_facility_id` (string, optional, nullable) — When set, this identifier applies only to the given service facility.

## Examples

**Request**

```json
{
  "service_facility_id": "string",
  "contracting_provider_id": "string",
  "payer_uuid": "string"
}
```

**Response**

```json
{
  "contracting_provider": {
    "npi": "1234567890",
    "is_rendering": true,
    "is_billing": true,
    "provider_type": "INDIVIDUAL",
    "license_type": "MD",
    "organization_provider_id": "string",
    "qualifications": [
      {
        "identifier_code": "MCR",
        "identifier_id": "string",
        "identifier_value": {
          "organization_service_facility_id": "string",
          "provider_number": "string",
          "state": "AA",
          "type": "medicare_provider_identifier"
        },
        "period": {
          "start_date": "string",
          "end_date": "string"
        }
      }
    ],
    "first_name": "string",
    "last_name": "string",
    "organization_name": "string",
    "tax_id": "string",
    "taxonomy_code": "string",
    "addresses": [
      {
        "address": {
          "address1": "string",
          "city": "string",
          "state": "AA",
          "zip_code": "string",
          "zip_plus_four_code": "1234",
          "address2": "string"
        },
        "address_type": "DEFAULT"
      }
    ],
    "employment_start_date": "2023-01-15",
    "employment_termination_date": "2023-01-15"
  },
  "credentialing_status": "work_in_progress",
  "facility_credentialing_span_id": "string",
  "is_enabled": true,
  "payer": {
    "payer_uuid": "string",
    "payer_id": "12345",
    "payer_name": "Payer Name",
    "availity_payer_name": "string",
    "availity_claims_payer_id": "string",
    "availity_eligibility_id": "string",
    "availity_remittance_payer_id": "string",
    "street_address": {
      "address1": "string",
      "city": "string",
      "state": "AA",
      "zip_code": "string",
      "zip_plus_four_code": "1234",
      "address2": "string"
    }
  },
  "service_facility": {
    "organization_service_facility_id": "string",
    "name": "Test Service Facility",
    "aliases": [
      "Test Service Facility Alias"
    ],
    "telecoms": [
      "555-555-5555"
    ],
    "address": {
      "address1": "string",
      "city": "string",
      "state": "AA",
      "zip_code": "string",
      "zip_plus_four_code": "1234",
      "address2": "string"
    },
    "description": "string",
    "external_id": "string",
    "npi": "string",
    "place_of_service_code": "01",
    "clia_number": "string",
    "mammography_certification_number": "string",
    "status": "active",
    "operational_status": "C",
    "mode": "instance",
    "type": "DX",
    "physical_type": "si"
  },
  "end_date": "2023-01-15",
  "payer_loaded_date": "2023-01-15",
  "start_date": "2023-01-15",
  "submitted_date": "2023-01-15"
}
```

**SDK Code**

```python
import requests

url = "https://api.taigabilling.com/api/provider-credentialing-span/v2/facility"

payload = {
    "service_facility_id": "string",
    "contracting_provider_id": "string",
    "payer_uuid": "string"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.json())
```