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

# List insurance claims

> This endpoint retrieves insurance claims for a specific location.

Claims do not carry modification timestamps, so this endpoint does **not** support `q[fetch_modified_since]`. Use cursor pagination (`after`) to walk the full set, and `q[claim_date_gteq]` / `q[claim_date_lteq]` to narrow by service date.

#### Parameters

- location_id (required): The ID of the location for which patients are to be retrieved.
- after: A parameter to specify the cursor for pagination.
- items: A parameter to specify the number of items to be returned.

```json
{
    "q": {
        "claim_date_gteq": "2026-08-01T00:00:00.000Z",
        "status_eq": 2
    }
}
```



## OpenAPI

````yaml https://app.teamcaredental.com/openapi-vendors.json get /locations/{location_id}/insurance_claims
openapi: 3.1.0
info:
  title: TeamCare Vendor API
  version: 1.0.0
  description: Vendor APIs for integrating dental office data. HIPAA-compliant and opt-in.
servers:
  - url: https://app.teamcaredental.com/api/v1/vendors
security:
  - bearerAuth: []
paths:
  /locations/{location_id}/insurance_claims:
    get:
      tags:
        - Insurance Claims
      summary: List insurance claims
      description: >-
        This endpoint retrieves insurance claims for a specific location.


        Claims do not carry modification timestamps, so this endpoint does
        **not** support `q[fetch_modified_since]`. Use cursor pagination
        (`after`) to walk the full set, and `q[claim_date_gteq]` /
        `q[claim_date_lteq]` to narrow by service date.


        #### Parameters


        - location_id (required): The ID of the location for which patients are
        to be retrieved.

        - after: A parameter to specify the cursor for pagination.

        - items: A parameter to specify the number of items to be returned.


        ```json

        {
            "q": {
                "claim_date_gteq": "2026-08-01T00:00:00.000Z",
                "status_eq": 2
            }
        }

        ```
      operationId: locations_resources_insurance_claims_list
      parameters:
        - name: location_id
          in: path
          required: true
          description: >-
            The ID of the location for which insurance claims are to be
            retrieved.
          schema:
            type: string
            example: '58'
        - name: after
          in: query
          required: false
          description: A parameter to specify the cursor for pagination.
          schema:
            type: integer
            example: 241094833
        - name: items
          in: query
          required: false
          description: A parameter to specify the number of items to be returned.
          schema:
            type: integer
            example: 500
        - name: q
          in: query
          required: false
          style: deepObject
          explode: true
          schema:
            type: object
            properties:
              claim_date_gteq:
                type: string
                format: date-time
                example: '2026-08-01T00:00:00.000Z'
              claim_date_lteq:
                type: string
                format: date-time
                example: '2026-08-31T23:59:59.999Z'
              status_eq:
                type: integer
                description: 0 = created, 1 = sent, 2 = received
                example: 2
              patient_id_eq:
                type: integer
                example: 48219
          example:
            claim_date_gteq: '2026-08-01T00:00:00.000Z'
            status_eq: 2
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                        type:
                          type: string
                        attributes:
                          type: object
                          properties:
                            deleted:
                              type: boolean
                            patient_id:
                              type: number
                            provider_id:
                              type: number
                            insurance_carrier_id:
                              type: number
                            insurance_carrier_name:
                              type:
                                - string
                                - 'null'
                              description: >-
                                Carrier name, joined from the claim's insurance
                                carrier. Null if the claim has no carrier or the
                                carrier has been deleted.
                            claim_type:
                              type: string
                              enum:
                                - preauthorization
                                - claim
                            insurance_type:
                              type: string
                              enum:
                                - primary
                                - secondary
                                - medical
                                - other
                            status:
                              type: string
                              enum:
                                - created
                                - sent
                                - received
                            claim_date:
                              type: string
                              format: date-time
                            total_amount:
                              type: number
                            sent_at:
                              type: string
                              format: date-time
                            estimated_insurance_payment:
                              type: number
                            received_at:
                              type: string
                              format: date-time
                            actual_insurance_payment:
                              type: number
                  pagy:
                    type: object
                    properties:
                      has_more:
                        type: boolean
                      items:
                        type: integer
              example:
                data:
                  - id: '91422'
                    type: insurance_claim
                    attributes:
                      deleted: false
                      patient_id: 48219
                      provider_id: 312
                      insurance_carrier_id: 1044
                      insurance_carrier_name: Delta Dental
                      claim_type: claim
                      insurance_type: primary
                      status: received
                      claim_date: '2026-08-14T00:00:00.000Z'
                      total_amount: 1240
                      sent_at: '2026-08-15T00:00:00.000Z'
                      estimated_insurance_payment: 812
                      received_at: '2026-08-29T00:00:00.000Z'
                      actual_insurance_payment: 790.5
                pagy:
                  has_more: true
                  items: 1
        '401':
          description: Missing, invalid or expired token.
          content:
            application/json:
              schema:
                type: object
                properties:
                  errors:
                    type: string
              example:
                errors: not authorized
        '403':
          description: The credential may not access this resource.
          content:
            application/json:
              schema:
                type: object
                properties:
                  errors:
                    type: string
              example:
                errors: access Denied
        '404':
          description: Resource not found.
          content:
            application/json:
              schema:
                type: object
                properties:
                  errors:
                    type: string
              example:
                errors: resource not found
        '422':
          description: The request could not be processed.
          content:
            application/json:
              schema:
                type: object
                properties:
                  errors:
                    type: string
              example:
                errors: ...
        '429':
          description: >-
            Concurrency limit exceeded. The request was not executed; retry is
            safe.
          headers:
            Retry-After:
              description: Seconds to wait before retrying.
              schema:
                type: integer
          content:
            application/json:
              schema:
                type: object
                properties:
                  errors:
                    type: string
                  sync_type:
                    type: string
                    enum:
                      - initial
                      - incremental
                  max_concurrent_locations:
                    type: integer
                  active_location_ids:
                    type: array
                    items:
                      type: integer
                  retry_after_seconds:
                    type: integer
              example:
                errors: >-
                  Too many locations syncing concurrently. At most 5 locations
                  may have initial sync requests in flight at a time.
                sync_type: initial
                max_concurrent_locations: 5
                active_location_ids:
                  - 101
                  - 102
                  - 103
                  - 104
                  - 105
                retry_after_seconds: 1
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: JWT returned by POST /auth/token. Valid for six hours.

````