> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usecobalt.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Fee Schedule Items

> Returns a page of per-code pricing for a single fee schedule.

A fee schedule contains the full CPT/HCPCS catalog (thousands of codes), so its
items are paginated. Get the `feeScheduleId` from
[Get Fee Schedules](/api-reference/fee-schedules/get), then page through the
codes here. You can narrow results with `search` (code or description) and
`validity`.

### Example Request

```bash theme={null}
curl -X GET "https://api.usecobalt.com/v1/fee-schedules/abc123def4567890abcdef1234567890/items?page=1&page_size=100&search=99213&validity=valid" \
-H 'Content-Type: application/json' \
-H 'client_id: ci_live_198908HJDKJSH98789OHKJL' \
-H 'client_secret: cs_live_9827hofdsklOYYHJLJh' \
-H 'access_token: 493JKLHIU98789hLKH9HHJH'
```

### Example Response

```json theme={null}
{
    "success": true,
    "items": [
        {
            "item_id": "279840",
            "code": "49082",
            "name": "ABD PARACENTESIS",
            "fee": 287.0,
            "allowed_fee": 191.28,
            "cost": 0.0,
            "patient_portion": 0.0,
            "bill_to_patient": false,
            "modifiers": [],
            "pos": null,
            "tos": null,
            "ndc": {
                "code": null,
                "units": null,
                "uom": null,
                "unit_price": null
            },
            "exclude_cpt": false,
            "validity": "valid"
        }
    ],
    "pagination": {
        "page": 1,
        "page_size": 100,
        "total_records": 2624,
        "total_pages": 27
    }
}
```

### Query Parameters

* **page**: Page number (default `1`).
* **page\_size**: Items per page (default `100`, max `500`).
* **search**: Filter by code or description (case-insensitive).
* **validity**: Filter to `valid` or `invalid` codes.

### Response Parameters

* **item\_id**: EMR item identifier, stable per code within the schedule.
* **code**: CPT/HCPCS code.
* **name**: Code description.
* **fee**: Billed/charge amount. **allowed\_fee**: Contracted allowed amount. These differ per schedule for the same code.
* **cost** / **patient\_portion**: Cost and patient-portion amounts.
* **bill\_to\_patient** / **exclude\_cpt**: Billing flags.
* **modifiers**: Procedure modifiers (only non-empty slots are returned).
* **pos** / **tos**: Place of service / type of service.
* **ndc**: National Drug Code details (`code`, `units`, `uom`, `unit_price`).
* **validity**: `valid` or `invalid`. Invalid codes are retained so historical claims can still be cross-referenced.
* **pagination**: `page`, `page_size`, `total_records`, `total_pages`.


## OpenAPI

````yaml GET /fee-schedules/{feeScheduleId}/items
openapi: 3.0.0
info:
  title: Cobalt API
  version: 1.0.1
  description: API for interacting with Cobalt's EHR integration services
servers:
  - url: https://api.usecobalt.com/v1
security:
  - ClientCredentials: []
    ClientSecret: []
    AccessToken: []
paths:
  /fee-schedules/{feeScheduleId}/items:
    get:
      tags:
        - Fee Schedules
      summary: List fee schedule items
      description: >-
        Returns a page of per-code pricing for a single fee schedule. A schedule
        is the full CPT/HCPCS catalog (thousands of codes), so items are
        paginated.
      operationId: getFeeScheduleItems
      parameters:
        - name: feeScheduleId
          in: path
          required: true
          description: Cobalt fee schedule ID from the list endpoint.
          schema:
            type: string
        - name: page
          in: query
          required: false
          description: Page number (default 1).
          schema:
            type: integer
            default: 1
        - name: page_size
          in: query
          required: false
          description: Items per page (default 100, max 500).
          schema:
            type: integer
            default: 100
            maximum: 500
        - name: search
          in: query
          required: false
          description: Filter by code or description (case-insensitive).
          schema:
            type: string
        - name: validity
          in: query
          required: false
          description: Filter by code validity.
          schema:
            type: string
            enum:
              - valid
              - invalid
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                  items:
                    type: array
                    items:
                      type: object
                      properties:
                        item_id:
                          type: string
                          description: >-
                            EMR item identifier (stable per code in this
                            schedule)
                        code:
                          type: string
                          description: CPT/HCPCS code
                        name:
                          type: string
                          description: Code description
                        fee:
                          type: number
                          description: Billed/charge amount
                        allowed_fee:
                          type: number
                          description: Contracted allowed amount
                        cost:
                          type: number
                          description: Cost amount
                        patient_portion:
                          type: number
                          description: Patient portion amount
                        bill_to_patient:
                          type: boolean
                          description: Whether the code bills to the patient
                        modifiers:
                          type: array
                          items:
                            type: string
                          description: Procedure modifiers (non-empty slots only)
                        pos:
                          type: string
                          description: Place of service
                        tos:
                          type: string
                          description: Type of service
                        ndc:
                          type: object
                          properties:
                            code:
                              type: string
                            units:
                              type: string
                            uom:
                              type: string
                            unit_price:
                              type: string
                        exclude_cpt:
                          type: boolean
                          description: Whether the code is excluded from CPT billing
                        validity:
                          type: string
                          enum:
                            - valid
                            - invalid
                          description: Whether the code is currently valid
                  pagination:
                    type: object
                    properties:
                      page:
                        type: integer
                      page_size:
                        type: integer
                      total_records:
                        type: integer
                      total_pages:
                        type: integer
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                  message:
                    type: string
        '404':
          description: Fee schedule not found
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                  message:
                    type: string
components:
  securitySchemes:
    ClientCredentials:
      type: apiKey
      in: header
      name: client_id
    ClientSecret:
      type: apiKey
      in: header
      name: client_secret
    AccessToken:
      type: apiKey
      in: header
      name: access_token

````