---
title: "Get Multi Paginated"
method: GET
path: "/coverages/v1//get-multi-paginated"
tags: ["v1"]
---

# Get Multi Paginated

`GET /coverages/v1//get-multi-paginated`

## Request

- Base URL: `https://pre-api.joincandidhealth.com`
- URL: `https://pre-api.joincandidhealth.com/coverages/v1//get-multi-paginated`
- Auth: HTTP bearer

Returns a page of Coverages based on the search criteria.

## Query parameters

- `patient_id` string
- `payer_plan_group_id` string
- `page_token` string: A token that can be used to retrieve the next or previous page of results
- `limit` integer

## Response `200`

Response with status 200

- PreEncounterCoveragesV1CoveragesPage
  - `next_page_token` string: A token that can be used to retrieve the next or previous page of results
  - `prev_page_token` string: A token that can be used to retrieve the next or previous page of results
  - `total` integer, required
  - `items` PreEncounterCoveragesV1Coverage[], required
    - `organization_id` string, required: The unique identifier for an Organization in the database
    - `deactivated` boolean, required: True if the object is deactivated. Deactivated objects are not returned in search results but are returned in all other endpoints including scan.
    - `version` integer, required: The version of the object. Any update to any property of an object object will create a new version.
    - `updated_at` string, date-time, required
    - `updating_user_id` string, required: The unique identifier for a User in the database
    - `status` 'ACTIVE' | 'CANCELLED' | 'DRAFT' | 'ENTERED_IN_ERROR', required: enum to represent the statuses defined at https://build.fhir.org/valueset-fm-status.html
    - `subscriber` PreEncounterCoveragesV1Subscriber, required
      - `name` PreEncounterCommonHumanName, required
        - `family` string, required
        - `given` string[], required
        - `use` 'USUAL' | 'OFFICIAL' | 'TEMP' | 'NICKNAME' | 'ANONYMOUS' | 'OLD' | 'MAIDEN', required
        - `period` PreEncounterCommonPeriod
          - `start` string, date
          - `end` string, date
        - `suffix` string
      - `date_of_birth` string, date
      - `biological_sex` 'FEMALE' | 'MALE' | 'UNKNOWN' | 'REFUSED', required
      - `address` PreEncounterCommonAddress
        - `use` 'HOME' | 'WORK' | 'TEMP' | 'OLD' | 'BILLING', required
        - `line` string[], required
        - `city` string, required
        - `state` string, required
        - `administrative_area` string: The top-level administrative subdivision of the country for addresses outside the US — for example a Canadian province, a UK county, or a Japanese prefecture. Only permitted on international addresses: `country` must be present and non-US, and `state` must be "FC" (the X12 foreign-country sentinel). For US addresses use `state` instead.
        - `postal_code` string, required
        - `country` string, required
        - `county` string
        - `period` PreEncounterCommonPeriod
          - `start` string, date
          - `end` string, date
      - `employer_name` string
    - `relationship` 'SELF' | 'SPOUSE' | 'CHILD' | 'COMMON_LAW_SPOUSE' | 'OTHER', required
    - `patient` string, required: The unique identifier for a Patient
    - `insurance_plan` PreEncounterCoveragesV1InsurancePlan, required
      - `member_id` string, required
      - `payer_id` string, required: The unique identifier for a Payer in the database
      - `payer_name` string, required
      - `additional_payer_information` PreEncounterCommonAdditionalPayerInformation
        - `availity_eligibility_id` string
        - `availity_payer_id` string
        - `availity_payer_name` string
        - `availity_remittance_payer_id` string
      - `group_number` string
      - `name` string
      - `plan_type` '09' | '11' | '12' | '13' | '14' | '15' | '16' | '17' | 'AM' | 'BL' | 'CH' | 'CI' | 'DS' | 'FI' | 'HM' | 'LM' | 'MA' | 'MB' | 'MC' | 'OF' | 'TV' | 'VA' | 'WC' | 'ZZ'
      - `type` '01' | '12' | '13' | '14' | '15' | '16' | '17' | '18' | '19' | '41' | '42' | '43' | '47' | 'AP' | 'C1' | 'CO' | 'CP' | 'D' | 'DB' | 'E' | 'EP' | 'FF' | 'GP' | 'HA' | 'HB' | 'HD' | 'HG' | 'HM' | 'HN' | 'HP' | 'HS' | 'IN' | 'IP' | 'LC' | 'LD' | 'LI' | 'LT' | 'M' | 'MA' | 'MB' | 'MC' | 'MD' | 'ME' | 'MF' | 'MH' | 'MI' | 'MJ' | 'MK' | 'ML' | 'MM' | 'MN' | 'MO' | 'MP' | 'MR' | 'MT' | 'MV' | 'OA' | 'OT' | 'PE' | 'PL' | 'PP' | 'PR' | 'PS' | 'QM' | 'RP' | 'SP' | 'TF' | 'U' | 'WC' | 'WU': Code identifying the type of insurance policy within a specific insurance program (X12 008020 Element 1336)
      - `period` PreEncounterCommonPeriod
        - `start` string, date
        - `end` string, date
      - `insurance_card_image_locator` string
      - `address` PreEncounterCommonAddress
        - `use` 'HOME' | 'WORK' | 'TEMP' | 'OLD' | 'BILLING', required
        - `line` string[], required
        - `city` string, required
        - `state` string, required
        - `administrative_area` string: The top-level administrative subdivision of the country for addresses outside the US — for example a Canadian province, a UK county, or a Japanese prefecture. Only permitted on international addresses: `country` must be present and non-US, and `state` must be "FC" (the X12 foreign-country sentinel). For US addresses use `state` instead.
        - `postal_code` string, required
        - `country` string, required
        - `county` string
        - `period` PreEncounterCommonPeriod
          - `start` string, date
          - `end` string, date
      - `payer_plan_group_id` string, uuid: The unique identifier for a PayerPlanGroup in the database
      - `carve_outs` PreEncounterCoveragesV1CoverageCarveOut[]
        - `carve_out` 'BEHAVIORAL' | 'MEDICAL' | 'THERAPY' | 'OTHER' | 'ABA' | 'FWC' | 'OT' | 'SLP' | 'PT' | 'EEG' | 'CES', required
        - `member_id` string, required
        - `payer_id` string, required: The unique identifier for a Payer in the database
        - `payer_name` string, required
        - `group_number` string
        - `plan_type` '09' | '11' | '12' | '13' | '14' | '15' | '16' | '17' | 'AM' | 'BL' | 'CH' | 'CI' | 'DS' | 'FI' | 'HM' | 'LM' | 'MA' | 'MB' | 'MC' | 'OF' | 'TV' | 'VA' | 'WC' | 'ZZ'
        - `type` '01' | '12' | '13' | '14' | '15' | '16' | '17' | '18' | '19' | '41' | '42' | '43' | '47' | 'AP' | 'C1' | 'CO' | 'CP' | 'D' | 'DB' | 'E' | 'EP' | 'FF' | 'GP' | 'HA' | 'HB' | 'HD' | 'HG' | 'HM' | 'HN' | 'HP' | 'HS' | 'IN' | 'IP' | 'LC' | 'LD' | 'LI' | 'LT' | 'M' | 'MA' | 'MB' | 'MC' | 'MD' | 'ME' | 'MF' | 'MH' | 'MI' | 'MJ' | 'MK' | 'ML' | 'MM' | 'MN' | 'MO' | 'MP' | 'MR' | 'MT' | 'MV' | 'OA' | 'OT' | 'PE' | 'PL' | 'PP' | 'PR' | 'PS' | 'QM' | 'RP' | 'SP' | 'TF' | 'U' | 'WC' | 'WU': Code identifying the type of insurance policy within a specific insurance program (X12 008020 Element 1336)
        - `payer_plan_group_id` string, uuid: The unique identifier for a PayerPlanGroup in the database
    - `verified` boolean, required: A boolean indicating if the coverage has been verified by a user.
    - `eligibility_checks` PreEncounterEligibilityChecksV1EligibilityCheckMetadata[]: A list of eligibility check metadata that have been initiated on this coverage.
      - `check_id` string, required
      - `service_code` '1' | '2' | '3' | '4' | '5' | '6' | '7' | '8' | '9' | '10' | '11' | '12' | '13' | '14' | '15' | '16' | '17' | '18' | '19' | '20' | '21' | '22' | '23' | '24' | '25' | '26' | '27' | '28' | '30' | '32' | '33' | '34' | '35' | '36' | '37' | '38' | '39' | '40' | '41' | '42' | '43' | '44' | '45' | '46' | '47' | '48' | '49' | '50' | '51' | '52' | '53' | '54' | '55' | '56' | '57' | '58' | '59' | '60' | '61' | '62' | '63' | '64' | '65' | '66' | '67' | '68' | '69' | '70' | '71' | '72' | '73' | '74' | '75' | '76' | '77' | '78' | '79' | '80' | '81' | '82' | '83' | '84' | '85' | '86' | '87' | '88' | '89' | '90' | '91' | '92' | '93' | '94' | '95' | '96' | '97' | '98' | '99' | 'A0' | 'A1' | 'A2' | 'A3' | 'A4' | 'A5' | 'A6' | 'A7' | 'A8' | 'A9' | 'AA' | 'AB' | 'AC' | 'AD' | 'AE' | 'AF' | 'AG' | 'AH' | 'AI' | 'AJ' | 'AK' | 'AL' | 'AM' | 'AN' | 'AO' | 'AQ' | 'AR' | 'B1' | 'B2' | 'B3' | 'BA' | 'BB' | 'BC' | 'BD' | 'BE' | 'BF' | 'BG' | 'BH' | 'BI' | 'BJ' | 'BK' | 'BL' | 'BM' | 'BN' | 'BP' | 'BQ' | 'BR' | 'BS' | 'BT' | 'BU' | 'BV' | 'BW' | 'BX' | 'BY' | 'BZ' | 'C1' | 'CA' | 'CB' | 'CC' | 'CD' | 'CE' | 'CF' | 'CG' | 'CH' | 'CI' | 'CJ' | 'CK' | 'CL' | 'CM' | 'CN' | 'CO' | 'CP' | 'CQ' | 'DG' | 'DM' | 'DS' | 'GF' | 'GN' | 'GY' | 'IC' | 'MH' | 'NI' | 'ON' | 'PT' | 'PU' | 'RN' | 'RT' | 'TC' | 'TN' | 'UC', required: Code identifying the type of service or benefit within a specific insurance policy (X12 008010 Element 1365)
      - `status` 'COMPLETED' | 'FAILED' | 'PENDING', required: enum to represent the status of an eligibility checks
      - `initiated_by` string, required: The unique identifier for a User in the database
      - `initiated_at` string, date-time, required
    - `latest_eligibility_check` PreEncounterCoveragesV1LatestEligibilityCheck: A type to represent the latest eligibility check status of a coverage.
      - `check_id` string, required
      - `status` 'ACTIVE' | 'INACTIVE' | 'UNKNOWN', required: enum to represent the status of a patient's coverage
      - `initiated_at` string, date-time, required
      - `errors` PreEncounterEligibilityChecksV1EligibilityCheckErrorDetails[]
        - `field?` string
        - `description?` string
        - `location?` string
        - `possibleResolutions?` string
        - `code?` string
        - `followupAction?` string
      - `request_corrections` PreEncounterEligibilityChecksV1RequestCorrection[]: Fields where the payer's 271 response disagreed with what we sent on the request, surfaced from the check so consumers can detect that the eligibility response contradicted the coverage on file. Empty when the payer echoed everything we sent.
        - `property` string, required
        - `request_value` string, required
        - `corrected_value` string, required
      - `trading_partner` string: The payer's own identifier as returned on the Stedi eligibility response (271) `tradingPartnerServiceId`, surfaced from the latest check's plan metadata so it is readable off the coverage. Can differ from the ID we submitted.
    - `benefits` PreEncounterCoveragesV1CoverageBenefits
      - `plan_coverage` PreEncounterCoveragesV1PlanCoverage
        - `in_network` PreEncounterCoveragesV1PlanCoverageDetails
          - `deductible` PreEncounterCoveragesV1CoverageValue
            - `family` number, double
            - `individual` number, double
            - `employeeAndSpouse` number, double
            - `employeeAndChildren` number, double
          - `deductible_contract` PreEncounterCoveragesV1CoverageValue
            - `family` number, double
            - `individual` number, double
            - `employeeAndSpouse` number, double
            - `employeeAndChildren` number, double
          - `deductible_remaining` PreEncounterCoveragesV1CoverageValue
            - `family` number, double
            - `individual` number, double
            - `employeeAndSpouse` number, double
            - `employeeAndChildren` number, double
          - `deductible_year_to_date` PreEncounterCoveragesV1CoverageValue
            - `family` number, double
            - `individual` number, double
            - `employeeAndSpouse` number, double
            - `employeeAndChildren` number, double
          - `oop_max` PreEncounterCoveragesV1CoverageValue
            - `family` number, double
            - `individual` number, double
            - `employeeAndSpouse` number, double
            - `employeeAndChildren` number, double
          - `oop_max_contract` PreEncounterCoveragesV1CoverageValue
            - `family` number, double
            - `individual` number, double
            - `employeeAndSpouse` number, double
            - `employeeAndChildren` number, double
          - `oop_max_remaining` PreEncounterCoveragesV1CoverageValue
            - `family` number, double
            - `individual` number, double
            - `employeeAndSpouse` number, double
            - `employeeAndChildren` number, double
          - `oop_max_year_to_date` PreEncounterCoveragesV1CoverageValue
            - `family` number, double
            - `individual` number, double
            - `employeeAndSpouse` number, double
            - `employeeAndChildren` number, double
          - `additional_notes` string
        - `in_network_flat` PreEncounterCoveragesV1CoverageDetails[]
          - `type` 'DEDUCTIBLE' | 'DEDUCTIBLE_CONTRACT' | 'DEDUCTIBLE_REMAINING' | 'DEDUCTIBLE_YEAR_TO_DATE' | 'OOP_MAX' | 'OOP_MAX_CONTRACT' | 'OOP_MAX_REMAINING' | 'OOP_MAX_YEAR_TO_DATE' | 'COPAY' | 'COINSURANCE' | 'NON_COVERED' | 'LIMITATION', required
          - `coverageLevel` 'EMPLOYEE_AND_CHILDREN' | 'EMPLOYEE_ONLY' | 'EMPLOYEE_AND_SPOUSE' | 'FAMILY' | 'INDIVIDUAL', required
          - `unit` 'PERCENT' | 'CURRENCY' | 'COUNT', required
          - `value` number, double, required
          - `additional_notes` string
        - `out_of_network` PreEncounterCoveragesV1PlanCoverageDetails
          - `deductible` PreEncounterCoveragesV1CoverageValue
            - `family` number, double
            - `individual` number, double
            - `employeeAndSpouse` number, double
            - `employeeAndChildren` number, double
          - `deductible_contract` PreEncounterCoveragesV1CoverageValue
            - `family` number, double
            - `individual` number, double
            - `employeeAndSpouse` number, double
            - `employeeAndChildren` number, double
          - `deductible_remaining` PreEncounterCoveragesV1CoverageValue
            - `family` number, double
            - `individual` number, double
            - `employeeAndSpouse` number, double
            - `employeeAndChildren` number, double
          - `deductible_year_to_date` PreEncounterCoveragesV1CoverageValue
            - `family` number, double
            - `individual` number, double
            - `employeeAndSpouse` number, double
            - `employeeAndChildren` number, double
          - `oop_max` PreEncounterCoveragesV1CoverageValue
            - `family` number, double
            - `individual` number, double
            - `employeeAndSpouse` number, double
            - `employeeAndChildren` number, double
          - `oop_max_contract` PreEncounterCoveragesV1CoverageValue
            - `family` number, double
            - `individual` number, double
            - `employeeAndSpouse` number, double
            - `employeeAndChildren` number, double
          - `oop_max_remaining` PreEncounterCoveragesV1CoverageValue
            - `family` number, double
            - `individual` number, double
            - `employeeAndSpouse` number, double
            - `employeeAndChildren` number, double
          - `oop_max_year_to_date` PreEncounterCoveragesV1CoverageValue
            - `family` number, double
            - `individual` number, double
            - `employeeAndSpouse` number, double
            - `employeeAndChildren` number, double
          - `additional_notes` string
        - `out_of_network_flat` PreEncounterCoveragesV1CoverageDetails[]
          - `type` 'DEDUCTIBLE' | 'DEDUCTIBLE_CONTRACT' | 'DEDUCTIBLE_REMAINING' | 'DEDUCTIBLE_YEAR_TO_DATE' | 'OOP_MAX' | 'OOP_MAX_CONTRACT' | 'OOP_MAX_REMAINING' | 'OOP_MAX_YEAR_TO_DATE' | 'COPAY' | 'COINSURANCE' | 'NON_COVERED' | 'LIMITATION', required
          - `coverageLevel` 'EMPLOYEE_AND_CHILDREN' | 'EMPLOYEE_ONLY' | 'EMPLOYEE_AND_SPOUSE' | 'FAMILY' | 'INDIVIDUAL', required
          - `unit` 'PERCENT' | 'CURRENCY' | 'COUNT', required
          - `value` number, double, required
          - `additional_notes` string
      - `service_specific_coverage` PreEncounterCoveragesV1ServiceCoverage[]
        - `service_code` '1' | '2' | '3' | '4' | '5' | '6' | '7' | '8' | '9' | '10' | '11' | '12' | '13' | '14' | '15' | '16' | '17' | '18' | '19' | '20' | '21' | '22' | '23' | '24' | '25' | '26' | '27' | '28' | '30' | '32' | '33' | '34' | '35' | '36' | '37' | '38' | '39' | '40' | '41' | '42' | '43' | '44' | '45' | '46' | '47' | '48' | '49' | '50' | '51' | '52' | '53' | '54' | '55' | '56' | '57' | '58' | '59' | '60' | '61' | '62' | '63' | '64' | '65' | '66' | '67' | '68' | '69' | '70' | '71' | '72' | '73' | '74' | '75' | '76' | '77' | '78' | '79' | '80' | '81' | '82' | '83' | '84' | '85' | '86' | '87' | '88' | '89' | '90' | '91' | '92' | '93' | '94' | '95' | '96' | '97' | '98' | '99' | 'A0' | 'A1' | 'A2' | 'A3' | 'A4' | 'A5' | 'A6' | 'A7' | 'A8' | 'A9' | 'AA' | 'AB' | 'AC' | 'AD' | 'AE' | 'AF' | 'AG' | 'AH' | 'AI' | 'AJ' | 'AK' | 'AL' | 'AM' | 'AN' | 'AO' | 'AQ' | 'AR' | 'B1' | 'B2' | 'B3' | 'BA' | 'BB' | 'BC' | 'BD' | 'BE' | 'BF' | 'BG' | 'BH' | 'BI' | 'BJ' | 'BK' | 'BL' | 'BM' | 'BN' | 'BP' | 'BQ' | 'BR' | 'BS' | 'BT' | 'BU' | 'BV' | 'BW' | 'BX' | 'BY' | 'BZ' | 'C1' | 'CA' | 'CB' | 'CC' | 'CD' | 'CE' | 'CF' | 'CG' | 'CH' | 'CI' | 'CJ' | 'CK' | 'CL' | 'CM' | 'CN' | 'CO' | 'CP' | 'CQ' | 'DG' | 'DM' | 'DS' | 'GF' | 'GN' | 'GY' | 'IC' | 'MH' | 'NI' | 'ON' | 'PT' | 'PU' | 'RN' | 'RT' | 'TC' | 'TN' | 'UC', required: Code identifying the type of service or benefit within a specific insurance policy (X12 008010 Element 1365)
        - `in_network` PreEncounterCoveragesV1ServiceCoverageDetails
          - `copay` PreEncounterCoveragesV1CoverageValue
            - `family` number, double
            - `individual` number, double
            - `employeeAndSpouse` number, double
            - `employeeAndChildren` number, double
          - `coinsurance` PreEncounterCoveragesV1CoverageValue
            - `family` number, double
            - `individual` number, double
            - `employeeAndSpouse` number, double
            - `employeeAndChildren` number, double
          - `visits` PreEncounterCoveragesV1CoverageValue
            - `family` number, double
            - `individual` number, double
            - `employeeAndSpouse` number, double
            - `employeeAndChildren` number, double
          - `visits_remaining` PreEncounterCoveragesV1CoverageValue
            - `family` number, double
            - `individual` number, double
            - `employeeAndSpouse` number, double
            - `employeeAndChildren` number, double
          - `additional_notes` string
        - `in_network_flat` PreEncounterCoveragesV1CoverageDetails[]
          - `type` 'DEDUCTIBLE' | 'DEDUCTIBLE_CONTRACT' | 'DEDUCTIBLE_REMAINING' | 'DEDUCTIBLE_YEAR_TO_DATE' | 'OOP_MAX' | 'OOP_MAX_CONTRACT' | 'OOP_MAX_REMAINING' | 'OOP_MAX_YEAR_TO_DATE' | 'COPAY' | 'COINSURANCE' | 'NON_COVERED' | 'LIMITATION', required
          - `coverageLevel` 'EMPLOYEE_AND_CHILDREN' | 'EMPLOYEE_ONLY' | 'EMPLOYEE_AND_SPOUSE' | 'FAMILY' | 'INDIVIDUAL', required
          - `unit` 'PERCENT' | 'CURRENCY' | 'COUNT', required
          - `value` number, double, required
          - `additional_notes` string
        - `out_of_network` PreEncounterCoveragesV1ServiceCoverageDetails
          - `copay` PreEncounterCoveragesV1CoverageValue
            - `family` number, double
            - `individual` number, double
            - `employeeAndSpouse` number, double
            - `employeeAndChildren` number, double
          - `coinsurance` PreEncounterCoveragesV1CoverageValue
            - `family` number, double
            - `individual` number, double
            - `employeeAndSpouse` number, double
            - `employeeAndChildren` number, double
          - `visits` PreEncounterCoveragesV1CoverageValue
            - `family` number, double
            - `individual` number, double
            - `employeeAndSpouse` number, double
            - `employeeAndChildren` number, double
          - `visits_remaining` PreEncounterCoveragesV1CoverageValue
            - `family` number, double
            - `individual` number, double
            - `employeeAndSpouse` number, double
            - `employeeAndChildren` number, double
          - `additional_notes` string
        - `out_of_network_flat` PreEncounterCoveragesV1CoverageDetails[]
          - `type` 'DEDUCTIBLE' | 'DEDUCTIBLE_CONTRACT' | 'DEDUCTIBLE_REMAINING' | 'DEDUCTIBLE_YEAR_TO_DATE' | 'OOP_MAX' | 'OOP_MAX_CONTRACT' | 'OOP_MAX_REMAINING' | 'OOP_MAX_YEAR_TO_DATE' | 'COPAY' | 'COINSURANCE' | 'NON_COVERED' | 'LIMITATION', required
          - `coverageLevel` 'EMPLOYEE_AND_CHILDREN' | 'EMPLOYEE_ONLY' | 'EMPLOYEE_AND_SPOUSE' | 'FAMILY' | 'INDIVIDUAL', required
          - `unit` 'PERCENT' | 'CURRENCY' | 'COUNT', required
          - `value` number, double, required
          - `additional_notes` string
      - `benefits_related_entities` PreEncounterCoveragesV1BenefitsRelatedEntity[]
        - `entityIdentifier` string
        - `entityType` string
        - `entityName` string
        - `contactInformation` PreEncounterCoveragesV1RelatedEntityContact[]
          - `mode` string
          - `value` string
        - `serviceTypeCodes` PreEncounterCoveragesV1ServiceTypeCode[]
      - `non_covered_details` PreEncounterCoveragesV1NonCoveredDetail[]
        - `type` 'DEDUCTIBLE' | 'DEDUCTIBLE_CONTRACT' | 'DEDUCTIBLE_REMAINING' | 'DEDUCTIBLE_YEAR_TO_DATE' | 'OOP_MAX' | 'OOP_MAX_CONTRACT' | 'OOP_MAX_REMAINING' | 'OOP_MAX_YEAR_TO_DATE' | 'COPAY' | 'COINSURANCE' | 'NON_COVERED' | 'LIMITATION', required
        - `coverageLevel` 'EMPLOYEE_AND_CHILDREN' | 'EMPLOYEE_ONLY' | 'EMPLOYEE_AND_SPOUSE' | 'FAMILY' | 'INDIVIDUAL', required
        - `unit` 'PERCENT' | 'CURRENCY' | 'COUNT', required
        - `value` number, double, required
        - `additional_notes` string
        - `service_type_codes` PreEncounterCoveragesV1ServiceTypeCode[]
      - `notes` string
      - `autoUpdatedEligibilityCheckId` string
    - `orcon` boolean: ORCON (Originator Controlled) - When set to true, the Candid system will hide this coverage from downstream integrations. Updates made in the Candid UI will unset this flag. Defaults to false.
    - `auto_update_enabled` boolean: Default to true. When set to true, the Candid system will automatically update this coverage with the latest eligibility check benefits information. Auto update behavior is also set at the eligibilityConfig org level configuration.
    - `previous_appointment_copays` object: A map of UniversalServiceIdentifier (MD_Visit, Treatment, Tests, Activity) to copay values in cents. This is used to track copay values for each service type to handle OOP max resets correctly.
    - `id` string, uuid, required: The unique identifier for a Coverage in the database

## Other responses

- `400`: Error response with status 400

## Changes

- **2026-10-29** `d8b0a61873e2`: 7 warning
  - added the new `ABA` enum value to the `items/items/insurance_plan/carve_outs/items/carve_out` response property for the response status `200`
  - added the new `CES` enum value to the `items/items/insurance_plan/carve_outs/items/carve_out` response property for the response status `200`
  - added the new `EEG` enum value to the `items/items/insurance_plan/carve_outs/items/carve_out` response property for the response status `200`
  - added the new `FWC` enum value to the `items/items/insurance_plan/carve_outs/items/carve_out` response property for the response status `200`
  - …3 more
- **2026-09-19** `72fc5ca65ba5`: 3 info
  - added the optional property `items/items/insurance_plan/address/administrative_area` to the response with the `200` status
  - added the optional property `items/items/latest_eligibility_check/trading_partner` to the response with the `200` status
  - added the optional property `items/items/subscriber/address/administrative_area` to the response with the `200` status
- **2026-09-17** `24b2d80d577a`: 2 breaking, 1 warning, 8 info
  - the response's body type changed from no type to `object` for status `200`
  - the `content` response's property type changed from no type to `object` for status `400`
  - deleted the `header` request parameter `Authorization`
  - the endpoint scheme security `OAuthScheme` was added to the API
  - …7 more
- …earlier changes not shown

[Operation history](https://skmtc.dev/joincandidhealth/apis/api-reference/changes/coverages/v1/get-multi-paginated/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)
