# List all Facilities.

Endpoint: GET /v2/facilities
Security: BearerAuth

## Header parameters:

  - `organization-id` (string)

## Query parameters:

  - `offset` (number)
    The starting index for pagination, specifying how many records to skip.

  - `limit` (number)
    The maximum number of records to retrieve in a single request.

## Response 200 fields (application/json):

  - `data` (array, required)
    Array of facility objects

  - `data.name` (string, required)
    Legal name of the facility

  - `data.dba` (string, required)
    Doing Business As (DBA) name or trade name of the facility

  - `data.type` (string, required)
    Type of facility
    Example: "Ambulatory Surgery Centers"

  - `data.tin` (string, required)
    Tax Identification Number (TIN) for the facility

  - `data.medicareNumber` (string)

  - `data.medicaidNumber` (string)

  - `data.address` (string, required)
    Street address of the facility (Line 1)

  - `data.city` (string, required)
    City where the facility is located
    Example: "Saint George"

  - `data.zipcode` (string, required)
    ZIP code of the facility location
    Example: "90210"

  - `data.contactName` (string, required)
    Name of the primary contact person for the facility

  - `data.contactPhone` (string, required)
    Primary contact phone number for the facility
    Example: "8000001234"

  - `data.contactEmail` (string, required)
    Primary contact email address for the facility (email format)

  - `data.contactFax` (string, required)
    Contact fax number for the facility (optional)
    Example: "8000001234"

  - `data.state` (string, required)
    State where the facility is located (2-letter state code)
    Enum: "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"

  - `data.fileType` (string)
    File processing status for the facility record
    Enum: "Clean", "Non_Clean", "Pending"

  - `data.npi` (string)
    National Provider Identifier (NPI) - 10-digit identifier

  - `data.externalId` (string)
    External identifier for the facility from external systems
    Example: "V2222L00000"

  - `data.skipOnSiteReview` (boolean, required)

  - `data.stateLicenses` (array, required)

  - `data.stateLicenses.id` (string)

  - `data.stateLicenses.action` (string)
    Enum: "updated", "created", "deleted"

  - `data.stateLicenses.isUpdated` (boolean)

  - `data.stateLicenses.licenseType` (string, required)
    Type of license
    Enum: "State License", "Business Permit", "Occupational License", "Medical gas permit"

  - `data.stateLicenses.source` (string, required)
    Source of license verification (licensing authority)
    Example: "Utah Department of Health and Human Services"

  - `data.stateLicenses.licenseNumber` (string, required)
    License number issued by the licensing authority
    Example: "F23-100000"

  - `data.stateLicenses.status` (string, required)
    Status of the license (e.g., "Active", "Expired")
    Enum: "Active", "Inactive", "Expired", "Retired", "Revoked", "Lapsed", "Probation", "Surrendered", "Suspended"

  - `data.stateLicenses.issueDate` (string)
    Date when the state license was issued

  - `data.stateLicenses.expirationDate` (string, required)
    Date when the state license expires

  - `data.facilitySupportingDocuments` (array, required)

  - `data.facilitySupportingDocuments.name` (string, required)

  - `data.facilitySupportingDocuments.lastModified` (string, required)

  - `data.facilitySupportingDocuments.type` (string, required)

  - `data.accreditations` (array, required)

  - `data.accreditations.accreditationBody` (string, required)

  - `data.accreditations.applicable` (string, required)

  - `data.accreditations.status` (string, required)
    Accreditation status
    Enum: "Accredited", "Not Accredited"

  - `data.accreditations.effectiveDate` (string, required)

  - `data.accreditations.expirationDate` (string)

  - `data.siteVisits` (array, required)

  - `data.siteVisits.applicable` (string, required)
    Whether on-site review is applicable
    Enum: "Yes", "No", "N/A"

  - `data.siteVisits.source` (string, required)

  - `data.siteVisits.grade` (string)

  - `data.certifications` (array, required)

  - `data.certifications.types` (string)

  - `data.certifications.certificateType` (string)
    Type of certification
    Enum: "State Survey", "CLIA", "CMS", "CDS", "DEA", "N/A"

  - `data.certifications.number` (string)

  - `data.certifications.issueDate` (string)

  - `data.npdb` (array, required)

  - `data.npdb.applicable` (string, required)
    Whether NPDB check is applicable
    Enum: "Yes", "No", "N/A"

  - `data.npdb.typeOfAction` (string, required)
    Type of NPDB action
    Enum: "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"

  - `data.npdb.reportResults` (string)
    NPDB report results
    Enum: "Adverse Action Report", "Medical Malpractice Payment Report", "No Report Found"

  - `data.npdb.reportDate` (string, required)

  - `data.npdb.processDate` (string, required)

  - `data.sanctions` (array, required)

  - `data.sanctions.sanctionType` (string, required)

  - `data.sanctions.reportResults` (string, required)

  - `data.perfIndicator` (array, required)

  - `data.perfIndicator.applicable` (string, required)
    Whether performance indicator is applicable
    Enum: "Yes", "No", "N/A"

  - `data.perfIndicator.complaints` (string, required)

  - `data.perfIndicator.clinical` (string, required)

  - `data.perfIndicator.benefits` (string, required)

  - `data.perfIndicator.claims` (string, required)

  - `data.perfIndicator.accessIssues` (string, required)

  - `data.liabilityInsurances` (array, required)

  - `data.liabilityInsurances.policyNumber` (string, required)
    Insurance policy number

  - `data.liabilityInsurances.source` (string, required)
    Insurance carrier/company name

  - `data.liabilityInsurances.insuranceType` (string, required)
    Type of insurance
    Enum: "General Liability", "Professional Liability"

  - `data.liabilityInsurances.expirationDate` (string, required)
    Date when the insurance policy expires

  - `data.lastCredentialingDate` (string, required)
    Date the facility was last credentialed

  - `data.nextCredentialingDate` (string, required)
    Date when the facility is due for re-credentialing

  - `data.facilitySpecialties` (array)

  - `data.facilitySpecialties.specialtyNuccTaxonomyCode` (string)

  - `data.facilitySpecialties.code` (string)

  - `data.facilitySpecialties.isPrimary` (boolean)

  - `data.facilitySpecialties.specialtyBoardName` (string)

  - `data.facilitySpecialties.subSpecialties` (array)

  - `data.facilityPrimarySpecialty` (object)

  - `data.facilityHsdSpecialty` (object)

  - `data.appVerifications` (array)

  - `data.appVerifications.explanation` (string)

  - `data.appVerifications.verificationType` (string)

  - `data.medicareStarRatings` (array, required)

  - `data.medicareStarRatings.starRating` (string)

  - `data.linesOfBusiness` (array)

  - `data.organizationId` (string, required)

  - `data.contractEntity` (string, required)

  - `data.credentialingStartDate` (string, required)
    Date the facility was received for credentialing

  - `data.attestationDate` (string, required)
    Date when facility attestation was completed

  - `data.psvCompleteDate` (string, required)

  - `data.credentialingDecisionDate` (string, required)

  - `data.medicalDirectorId` (string, required)

  - `data.medicalDirectorName` (string, required)

  - `data.createdAt` (string, required)
    Example: "YYYY-MM-DD"

  - `data.createdBy` (string, required)

  - `data.createdByName` (string, required)

  - `data.updatedAt` (string, required)
    Example: "YYYY-MM-DD"

  - `data.updatedBy` (string, required)

  - `data.updatedByName` (string, required)

  - `data.surveyResponse` (array, required)

  - `data.providers` (array, required)

  - `data.providers.npi` (string, required)

  - `data.providers.type` (string, required)
    Provider type/credential
    Enum: "AA", "ABA", "ACU", "ADC", "APN", "AT", "ATR", "AUD", "BCaBA", "BCBA", "BSW", "BT", "CBHT", "CMHC", "CNS", "CP", "CPsyD", "CphT", "CRNA", "CSP", "CSW", "CTRS", "DC", "DDS", "DMD", "DO", "DPM", "DT", "EMT", "GC", "HOS", "IBCLC", "LBHC", "LCSW", "LMHC", "LN", "LP", "LPC", "LPN", "LPT", "LactCon", "MA", "MD", "MFT", "MT", "MW", "ND", "NEU", "NMW", "NP", "OA", "OD", "OPT", "OT", "OTA", "PA", "PC", "PDH", "PHA", "PHD", "PSW", "PT", "PTA", "PTNL", "RDH", "RDN", "RN", "RNFA", "RPSGT", "RT", "Rph", "SA", "SW"

  - `data.providers.verified_by` (string, required)

  - `data.providers.verified_date` (string, required)
    Example: "YYYY-MM-DD"

  - `data.practiceLicense` (array, required)

  - `data.practiceLicense.state` (string, required)
    US state or territory where practice license is issued
    Enum: "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"

  - `data.practiceLicense.type` (string, required)
    Type of practice license
    Enum: "State License", "Business Permit", "Occupational License", "Medical gas permit"

  - `data.practiceLicense.status` (string, required)
    Current status of the practice license
    Enum: "Active", "Inactive", "Expired", "Retired", "Revoked", "Lapsed", "Probation", "Surrendered", "Suspended"

  - `data.practiceLicense.license` (string, required)

  - `data.practiceLicense.source` (string, required)
    Source of practice license verification

  - `data.practiceLicense.verified_by` (string, required)
    Name of the person who verified this practice license information

  - `data.practiceLicense.verified_date` (string, required)
    Date when this practice license information was verified
    Example: "YYYY-MM-DD"

  - `data.businessLicense` (array, required)

  - `data.businessLicense.name` (string, required)
    Business name as registered

  - `data.businessLicense.entity` (string, required)
    Business entity type

  - `data.businessLicense.city` (string, required)

  - `data.businessLicense.incorporationDate` (string, required)
    Date when the business was incorporated

  - `data.businessLicense.verified_by` (string, required)
    Name of the person who verified this business license information
    Example: "John Doe"

  - `data.businessLicense.verified_date` (string, required)
    Date when this business license information was verified
    Example: "YYYY-MM-DD"

  - `data.onsiteReviews` (array, required)

  - `data.licensureActions` (array, required)

  - `data.deas` (array, required)

  - `data.deas.state` (string, required)
    State where DEA license is issued
    Enum: "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"

  - `data.deas.deaNumber` (string, required)

  - `data.deas.providerType` (string, required)

  - `data.deas.status` (string, required)
    Status of the DEA license
    Enum: "Active", "Inactive"

  - `data.credentialingStatus` (string, required)
    Current credentialing status of the facility
    Enum: "Not sent to credentialing", "Not Started", "In Progress", "Data missing", "Outreach in progress", "PSV complete by CertifyOS", "Credentialing restarted", "PSV ready", "Cred approved", "Hold for Cred Comm", "Cred denied", "Facility Terminated", "Recredentialing in progress", "Tabled", "Withdrawn/Cancelled"

  - `data.timelines` (array, required)

  - `data.timelines.enteredAt` (string, required)

  - `data.timelines.title` (string, required)

  - `count` (number, required)
    Total number of facilities
    Example: 528

  - `ids` (array,null)
    Array of specific facility IDs (when filtering)


## Response 401 fields

## Response 403 fields