---
title: "Update information for a facility."
method: PATCH
path: "/v2/facilities/{facilityId}"
tags: ["v2/facilities"]
---

# Update information for a facility.

`PATCH /v2/facilities/{facilityId}`

## Path parameters

- `facilityId` string, required

## Headers

- `organization-id` string

## Request body

- UpdateFacilityDto
  - `name` string — Legal name of the facility
  - `dba` string — Doing Business As (DBA) name or trade name of the facility
  - `type` string — Type of facility
  - `tin` string — Tax Identification Number (TIN) for the facility
  - `medicareNumber` string
  - `medicaidNumber` string
  - `address` string — Street address of the facility (Line 1)
  - `city` string — City where the facility is located
  - `zipcode` string — ZIP code of the facility location
  - `contactName` string — Name of the primary contact person for the facility
  - `contactPhone` string — Primary contact phone number for the facility
  - `contactEmail` string — Primary contact email address for the facility (email format)
  - `contactFax` string — Contact fax number for the facility (optional)
  - `state` 'AK' | 'AL' | 'AR' | 'AS' | 'AZ' | 'CA' | 'CO' | 'CT' | 'DC' | 'DE' | 'FL' | 'FM' | 'GA' | 'GU' | 'HI' | 'IA' | 'ID' | 'IL' | 'IN' | 'KS' | 'KY' | 'LA' | 'MA' | 'MD' | 'ME' | 'MH' | 'MI' | 'MN' | 'MO' | 'MP' | 'MS' | 'MT' | 'NC' | 'ND' | 'NE' | 'NH' | 'NJ' | 'NM' | 'NV' | 'NY' | 'OH' | 'OK' | 'OR' | 'PA' | 'PR' | 'PW' | 'RI' | 'SC' | 'SD' | 'TN' | 'TX' | 'UT' | 'UM' | 'VA' | 'VI' | 'VT' | 'WA' | 'WI' | 'WV' | 'WY' — State where the facility is located (2-letter state code)
  - `fileType` 'Clean' | 'Non_Clean' | 'Pending' — File processing status for the facility record
  - `npi` string — National Provider Identifier (NPI) - 10-digit identifier
  - `externalId` string — External identifier for the facility from external systems
  - `skipOnSiteReview` boolean
  - `stateLicenses` FacilityStateLicenseDto[]
    - `id` string
    - `action` 'updated' | 'created' | 'deleted'
    - `isUpdated` boolean
    - `licenseType` 'State License' | 'Business Permit' | 'Occupational License' | 'Medical gas permit', required — Type of license
    - `source` string, required — Source of license verification (licensing authority)
    - `licenseNumber` string, required — License number issued by the licensing authority
    - `status` 'Active' | 'Inactive' | 'Expired' | 'Retired' | 'Revoked' | 'Lapsed' | 'Probation' | 'Surrendered' | 'Suspended', required — Status of the license (e.g., "Active", "Expired")
    - `issueDate` string, date — Date when the state license was issued
    - `expirationDate` string, date, required — Date when the state license expires
  - `facilitySupportingDocuments` FacilitySupportingDocumentDto[]
    - `id` string
    - `action` 'updated' | 'created' | 'deleted'
    - `isUpdated` boolean
    - `name` string, required
    - `lastModified` string, date-time, required
    - `type` string, required
  - `accreditations` AccreditationDto[]
    - `id` string
    - `action` 'updated' | 'created' | 'deleted'
    - `isUpdated` boolean
    - `accreditationBody` string, required
    - `applicable` string, required
    - `status` 'Accredited' | 'Not Accredited', required — Accreditation status
    - `effectiveDate` string, date-time, required
    - `expirationDate` string, date-time
  - `siteVisits` OnSiteReviewDto[]
    - `id` string
    - `action` 'updated' | 'created' | 'deleted'
    - `isUpdated` boolean
    - `applicable` 'Yes' | 'No' | 'N/A', required — Whether on-site review is applicable
    - `source` string, required
    - `grade` string
  - `certifications` CertificationsDto[]
    - `id` string
    - `action` 'updated' | 'created' | 'deleted'
    - `isUpdated` boolean
    - `source` string
    - `types` string
    - `certificateType` 'State Survey' | 'CLIA' | 'CMS' | 'CDS' | 'DEA' | 'N/A' — Type of certification
    - `number` string
    - `issueDate` string, date-time
    - `expirationDate` string, date-time
  - `npdb` NpdbDto[]
    - `id` string
    - `action` 'updated' | 'created' | 'deleted'
    - `isUpdated` boolean
    - `applicable` 'Yes' | 'No' | 'N/A', required — Whether NPDB check is applicable
    - `source` string, required
    - `typeOfAction` 'No Action' | 'Medical Malpractice Payment' | 'Health Plan' | 'State Licensure/Certification' | 'Professional Society' | 'Exclusion/Debarment' | 'DEA/Federal Licensure' | 'Government Administrative' | 'Judgement/Conviction' | 'Clinical Privileges' | 'Peer Review Organization', required — Type of NPDB action
    - `reportResults` 'Adverse Action Report' | 'Medical Malpractice Payment Report' | 'No Report Found' — NPDB report results
    - `reportDate` string, date-time, required
    - `processDate` string, date-time, required
  - `sanctions` SanctionsDto[]
    - `id` string
    - `action` 'updated' | 'created' | 'deleted'
    - `isUpdated` boolean
    - `sanctionType` 'OIG' | 'GSA/SAM/OFAC' | 'OFAC' | 'MOO' | 'OMIG' | 'State Exclusion List' | 'Preclusion List Check', required — Type of sanction applied
    - `source` string, required
    - `reportResults` 'Match Found' | 'No Match Found', required — Result of the sanction check
  - `perfIndicator` FacilityPerformanceIndicatorDto[]
    - `id` string
    - `action` 'updated' | 'created' | 'deleted'
    - `isUpdated` boolean
    - `applicable` 'Yes' | 'No' | 'N/A', required — Whether performance indicator is applicable
    - `complaints` string, required
    - `clinical` string, required
    - `benefits` string, required
    - `claims` string, required
    - `accessIssues` string, required
  - `liabilityInsurances` InsuranceDto[]
    - `id` string
    - `action` 'updated' | 'created' | 'deleted'
    - `isUpdated` boolean
    - `policyNumber` string, required — Insurance policy number
    - `source` string, required — Insurance carrier/company name
    - `insuranceType` 'General Liability' | 'Professional Liability', required — Type of insurance
    - `expirationDate` string, date, required — Date when the insurance policy expires
  - `lastCredentialingDate` string, date-time
  - `nextCredentialingDate` string, date-time
  - `facilitySpecialties` CreateSpecialtiesDto[]
    - `specialtyNuccTaxonomyCode` string
    - `code` string
    - `name` string, required
    - `id` string
    - `isPrimary` boolean
    - `specialtyBoardName` string
    - `source` string
    - `subSpecialties` SubSpecialtiesDto[]
      - `specialtyNuccTaxonomyCode` string, required
      - `name` string, required
  - `facilityPrimarySpecialty` CreateSpecialtiesDto
    - `specialtyNuccTaxonomyCode` string
    - `code` string
    - `name` string, required
    - `id` string
    - `isPrimary` boolean
    - `specialtyBoardName` string
    - `source` string
    - `subSpecialties` SubSpecialtiesDto[]
      - `specialtyNuccTaxonomyCode` string, required
      - `name` string, required
  - `facilityHsdSpecialty` HsdSpecialty
    - `code` '' | '001' | '002' | '003' | '004' | '005' | '006' | '007' | '008' | '010' | '011' | '012' | '013' | '014' | '015' | '016' | '017' | '018' | '019' | '020' | '021' | '022' | '023' | '025' | '026' | '027' | '028' | '029' | '030' | '031' | '033' | '034' | '035' | '036' | '037' | '040' | '041' | '042' | '043' | '044' | '045' | '046' | '047' | '048' | '049' | '050' | '051' | '052' | '057', required
    - `name` '' | 'General Practice' | 'Family Practice' | 'Internal Medicine' | 'Geriatrics' | 'Primary Care - Physician Assistants' | 'Primary Care - Nurse Practitioners' | 'Allergy and Immunology' | 'Cardiology' | 'Chiropractor' | 'Dermatology' | 'Endocrinology' | 'ENT/Otolaryngology' | 'Gastroenterology' | 'General Surgery' | 'Gynecology, OB/GYN' | 'Infectious Diseases' | 'Nephrology' | 'Neurology' | 'Neurosurgery' | 'Oncology - Medical, Surgical' | 'Oncology - Radiation/Radiation Oncology' | 'Ophthalmology' | 'Orthopedic Surgery' | 'Physiatry, Rehabilitative Medicine' | 'Plastic Surgery' | 'Podiatry' | 'Psychiatry' | 'Pulmonology' | 'Rheumatology' | 'Urology' | 'Vascular Surgery' | 'Cardiothoracic Surgery' | 'Clinical Psychology' | 'Clinical Social Work' | 'Acute Inpatient Hospitals' | 'Cardiac Surgery Program' | 'Cardiac Catheterization Services' | 'Critical Care Services – Intensive Care Units (ICU)' | 'Outpatient Dialysis' | 'Surgical Services (Outpatient or ASC)' | 'Skilled Nursing Facilities' | 'Diagnostic Radiology' | 'Mammography' | 'Physical Therapy' | 'Occupational Therapy' | 'Speech Therapy' | 'Inpatient Psychiatric Facility Services' | 'Outpatient Infusion/Chemotherapy', required
  - `appVerifications` AppVerificationDto[]
    - `id` string
    - `action` 'updated' | 'created' | 'deleted'
    - `isUpdated` boolean
    - `explanation` string
    - `source` string
    - `verificationType` string
  - `medicareStarRatings` MedicareStarRatingDto[]
    - `id` string
    - `action` 'updated' | 'created' | 'deleted'
    - `isUpdated` boolean
    - `starRating` string
    - `reportDate` string, date-time
    - `source` string
  - `linesOfBusiness` string[]
  - `credentialingStatus` string
  - `credentialingStartDate` string, date-time
  - `psvCompleteDate` string, date-time
  - `credentialingDecisionDate` string, date-time
  - `attestationDate` string, date-time
  - `medicalDirectorId` string

## Response `204`

Updated.

## Other responses

- `400` — Bad request.
- `401` — Unauthorized if authorization token is not provided or invalid.
- `403` — Forbidden if user access is not right.
- `404` — Resource not found.

---

[API](https://skmtc.net/certifyos/apis/certifyos-api.md) · [All operations](https://skmtc.net/certifyos/apis/certifyos-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/certifyos/certifyos-api/versions/df08dd00da43/schema)
