---
title: "List Services"
method: GET
path: "/api/services"
tags: ["services"]
---

# List Services

`GET /api/services`

## Query parameters

- `filter.serviceTypeId` string
- `filter.patientId` string
- `filter.status` TypeServicesServicesListV1FilterStatus[]
- `filter.providerId` TypeServicesServicesListV1FilterProviderId[]
- `order.createdAt` 'asc' | 'desc'
- `order.dateOfService` 'asc' | 'desc'
- `page` integer
- `limit` integer

## Headers

- `X-API-Key` string, required

## Response `200`

Response with status 200

- TypeServicesServicesListV1Response
  - `items` TypeServicesServicesListV1ResponseItem[], required — List results
    - `id` string, required
    - `organizationId` string, required
    - `status` 'PENDING' | 'BILLING' | 'SETTLING' | 'COMPLETE' | 'TRIAGE' | 'CANCELED' | 'DENIED', required
    - `createdAt` string, date-time, required
    - `serviceType` TypeServicesServicesListV1ResponseItemServiceType, required
      - `id` string, required
      - `name` string, required
      - `placeOfService` 'TELEHEALTH_HOME' | 'TELEHEALTH_NOT_HOME' | 'OFFICE', required
      - `providerType` 'MD' | 'NP' | 'DO' | 'ND' | 'AP' | 'OT' | 'LCSW' | 'LMFT' | 'LPC' | 'PSYCH' | 'RN' | 'CN' | 'CWC' | 'CM' | 'PA' | 'RDN' | 'PT', required
      - `providerTypes` TypeServicesServicesListV1ResponseItemServiceTypeFieldProviderType[], required — All supported ProviderTypes
      - `cost` integer, required
      - `noteFields` TypeServicesServicesListV1ResponseItemServiceTypeFieldNoteField[], required
      - `conditionalPatientResponsibility` boolean, required
      - `selfPayCost` integer
    - `dateOfService` string, date-time, required
    - `externalId` string
    - `patientId` string, required
    - `location` TypeServicesServicesListV1ResponseItemLocation, required
      - `line1` string
      - `line2` string
      - `city` string
      - `state` 'AL' | 'AK' | 'AZ' | 'AR' | 'CA' | 'CO' | 'CT' | 'DE' | 'DC' | 'FL' | 'GA' | 'HI' | 'ID' | 'IL' | 'IN' | 'IA' | 'KS' | 'KY' | 'LA' | 'ME' | 'MD' | 'MA' | 'MI' | 'MN' | 'MS' | 'MO' | 'MT' | 'NE' | 'NV' | 'NH' | 'NJ' | 'NM' | 'NY' | 'NC' | 'ND' | 'OH' | 'OK' | 'OR' | 'PA' | 'RI' | 'SC' | 'SD' | 'TN' | 'TX' | 'UT' | 'VT' | 'VA' | 'WA' | 'WV' | 'WI' | 'WY', required
      - `postalCode` string
      - `country` 'US'
    - `noteId` string
    - `serviceEligibility` TypeServicesServicesListV1ResponseItemServiceEligibility, required
      - `id` string, required
      - `organizationId` string, required
      - `validatedAt` string, date-time — Timestamp this was executed
      - `serviceTypeId` string, required
      - `dateOfService` string, date-time, required
      - `status` 'PENDING' | 'UNINSURED' | 'ELIGIBLE' | 'INELIGIBLE' | 'INEFFECTIVE', required
      - `patientResponsibility` TypeServicesServicesListV1ResponseItemServiceEligibilityFieldPatientResponsibility
        - `total` integer, required — The total amount owed by the Patient (sum of contributions and OOP-waived amounts), value is in USD cents ($15 = 1500)
        - `fallback` integer, required — The fallback amount
        - `deductible` integer, required — The deductible contribution
        - `deductibleType` 'INDIVIDUAL' | 'FAMILY'
        - `coinsurance` integer, required — The coinsurance contribution
        - `coinsurancePercent` number, double, required — The coinsurance contribution as a percentage (15% = 0.15)
        - `copayment` integer, required — The copayment contribution
        - `oopFallback` integer, required — Amount of fallback waived due to OOP limits
        - `oopCopayment` integer, required — Amount of copayment waived due to OOP limits
        - `oopCoinsurance` integer, required — Amount of coinsurance waived due to OOP limits
        - `oopDeductible` integer, required — Amount of deductible waived due to OOP limits
      - `providers` TypeServicesServicesListV1ResponseItemServiceEligibilityFieldProvider[], required
        - `id` string, required
        - `name` string, required
        - `externalId` string
        - `type` 'MD' | 'NP' | 'DO' | 'ND' | 'AP' | 'OT' | 'LCSW' | 'LMFT' | 'LPC' | 'PSYCH' | 'RN' | 'CN' | 'CWC' | 'CM' | 'PA' | 'RDN' | 'PT', required
        - `providerEligibilityEnabled` boolean
        - `serviceEligibilityEnabled` boolean
        - `npi` string, required
      - `policyIds` TypeServicesServicesListV1ResponseItemServiceEligibilityFieldPolicyId[], required
      - `state` 'AL' | 'AK' | 'AZ' | 'AR' | 'CA' | 'CO' | 'CT' | 'DE' | 'DC' | 'FL' | 'GA' | 'HI' | 'ID' | 'IL' | 'IN' | 'IA' | 'KS' | 'KY' | 'LA' | 'ME' | 'MD' | 'MA' | 'MI' | 'MN' | 'MS' | 'MO' | 'MT' | 'NE' | 'NV' | 'NH' | 'NJ' | 'NM' | 'NY' | 'NC' | 'ND' | 'OH' | 'OK' | 'OR' | 'PA' | 'RI' | 'SC' | 'SD' | 'TN' | 'TX' | 'UT' | 'VT' | 'VA' | 'WA' | 'WV' | 'WI' | 'WY', required
      - `messages` TypeServicesServicesListV1ResponseItemServiceEligibilityFieldMessage[]
      - `clinicalInfo` TypeServicesServicesListV1ResponseItemServiceEligibilityFieldClinicalInfo
        - `diagnoses` TypeServicesServicesListV1ResponseItemServiceEligibilityFieldClinicalInfoFieldDiagnosis[]
      - `conditionalPatientResponsibilities` TypeServicesServicesListV1ResponseItemServiceEligibilityFieldConditionalPatientResponsibility[]
        - `conditions` TypeServicesServicesListV1ResponseItemServiceEligibilityFieldConditionalPatientResponsibilitiesElementCondition[], required
          - `diagnoses` TypeServicesServicesListV1ResponseItemServiceEligibilityFieldConditionalPatientResponsibilitiesElementConditionsElementDiagnosis[]
        - `limit` TypeServicesServicesListV1ResponseItemServiceEligibilityFieldConditionalPatientResponsibilitiesElementLimit, required
          - `type` 'UNKNOWN' | 'UNLIMITED' | 'LIMITED', required
          - `value` integer
          - `metric` 'VISIT' | 'UNITS'
          - `period` 'ANNUAL' | 'BENEFIT_YEAR' | 'LIFETIME'
          - `units` TypeServicesServicesListV1ResponseItemServiceEligibilityFieldConditionalPatientResponsibilitiesElementLimitFieldUnits
            - `minutes` integer, required — Conversion rate from units to minutes
            - `min` integer, required — Minimum number of units
            - `max` integer, required — Maximum number of units
        - `patientResponsibility` TypeServicesServicesListV1ResponseItemServiceEligibilityFieldConditionalPatientResponsibilitiesElementPatientResponsibility, required
          - `total` integer, required — The total amount owed by the Patient (sum of contributions and OOP-waived amounts), value is in USD cents ($15 = 1500)
          - `fallback` integer, required — The fallback amount
          - `deductible` integer, required — The deductible contribution
          - `deductibleType` 'INDIVIDUAL' | 'FAMILY'
          - `coinsurance` integer, required — The coinsurance contribution
          - `coinsurancePercent` number, double, required — The coinsurance contribution as a percentage (15% = 0.15)
          - `copayment` integer, required — The copayment contribution
          - `oopFallback` integer, required — Amount of fallback waived due to OOP limits
          - `oopCopayment` integer, required — Amount of copayment waived due to OOP limits
          - `oopCoinsurance` integer, required — Amount of coinsurance waived due to OOP limits
          - `oopDeductible` integer, required — Amount of deductible waived due to OOP limits
    - `coverageStatus` 'PENDING' | 'REVALIDATING' | 'VALID' | 'INVALID_COVERAGE' | 'INVALID_PROVIDER', required
    - `provider` TypeServicesServicesListV1ResponseItemProvider, required
      - `id` string, required
      - `name` string, required
      - `externalId` string
      - `type` 'MD' | 'NP' | 'DO' | 'ND' | 'AP' | 'OT' | 'LCSW' | 'LMFT' | 'LPC' | 'PSYCH' | 'RN' | 'CN' | 'CWC' | 'CM' | 'PA' | 'RDN' | 'PT', required
      - `providerEligibilityEnabled` boolean
      - `serviceEligibilityEnabled` boolean
      - `npi` string, required
    - `payments` TypeServicesServicesListV1ResponseItemPayment[], required
      - `id` string, required
      - `createdAt` string, date-time, required
      - `serviceId` string, required
      - `paidAt` string, date-time, required
      - `transactionId` string, required
      - `type` 'PATIENT' | 'ADJUSTMENT', required
      - `amount` integer, required
      - `externalId` string
      - `memo` string
    - `responsibleParty` 'PATIENT' | 'INSURANCE', required
    - `patientResponsibility` TypeServicesServicesListV1ResponseItemPatientResponsibility, required
      - `amount` TypeServicesServicesListV1ResponseItemPatientResponsibilityFieldAmount
        - `total` integer, required — The total amount owed by the Patient (sum of contributions and OOP-waived amounts), value is in USD cents ($15 = 1500)
        - `fallback` integer, required — The fallback amount
        - `deductible` integer, required — The deductible contribution
        - `deductibleType` 'INDIVIDUAL' | 'FAMILY'
        - `coinsurance` integer, required — The coinsurance contribution
        - `coinsurancePercent` number, double, required — The coinsurance contribution as a percentage (15% = 0.15)
        - `copayment` integer, required — The copayment contribution
        - `oopFallback` integer, required — Amount of fallback waived due to OOP limits
        - `oopCopayment` integer, required — Amount of copayment waived due to OOP limits
        - `oopCoinsurance` integer, required — Amount of coinsurance waived due to OOP limits
        - `oopDeductible` integer, required — Amount of deductible waived due to OOP limits
      - `status` 'UNKNOWN' | 'ESTIMATE' | 'FINALIZED'
      - `paid` integer — The amount (USD cents) of patient responsibility that has been paid, equal to the sum of all Payments.
    - `tasks` TypeServicesServicesListV1ResponseItemTask[], required
      - `type` 'PATIENT_CONSENT' | 'PATIENT_INSURANCE' | 'PATIENT_ADDRESS' | 'SERVICE_LOCATION' | 'DATE_OF_SERVICE' | 'DUPLICATE_SERVICE_TYPE' | 'INVALID_INITIAL_SERVICE_TYPE' | 'REPLACE_NOTE' | 'UPDATE_NOTE' | 'TRIAGE' | 'COVERAGE' | 'PRIOR_AUTHORIZATION' | 'BILLING_TIME_LIMIT' | 'PROVIDER_NOT_ENROLLED' | 'NOTE_SIGNING_PROVIDER_MISMATCH' | 'THERAPY_DURATION' | 'MINIMUM_DURATION' | 'MISSING_INITIATING_VISIT' | 'MISSING_ASSESSMENT' | 'MISSING_TIME_SPENT_MINUTES' | 'PATIENT_CONSENT_EXPIRED' | 'INVALID_DATE_RANGE' | 'INSUFFICIENT_MONITORING_DATA' | 'MISMATCHED_ICD10' | 'BILLING_FREQUENCY_LIMIT' | 'PATIENT_RECONSENT' | 'PROVIDER_CHANGED', required
      - `memo` string
    - `claimStatus` 'CREATED' | 'IN_PROGRESS' | 'PAID' | 'DENIED'
    - `priorAuthorizationNumber` string
    - `cancellationReason` 'NO_SHOW'
    - `metadata` TypeServicesServicesListV1ResponseItemMetadata
      - `exampleKey` string
  - `count` integer — Total count (if available)

---

[API](https://skmtc.dev/usebridge/apis/api-reference.md) · [All operations](https://skmtc.dev/usebridge/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/usebridge/api-reference/revisions/811dbc81bcd5/schema)