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

# Query policies

> Retrieve a list of policies based on specified filters.



## OpenAPI

````yaml https://app.stainless.com/api/spec/documented/samplehc/openapi.documented.yml get /api/v2/policies/
openapi: 3.0.3
info:
  title: Sample Healthcare API
  description: API for Sample Healthcare
  version: 1.0.0
servers: []
security: []
paths:
  /api/v2/policies/:
    get:
      tags:
        - Policies
      summary: Query policies
      description: Retrieve a list of policies based on specified filters.
      parameters:
        - schema:
            type: string
          in: query
          name: icd10CmCodes
          required: false
          description: Comma-separated ICD-10-CM codes to filter by
        - schema:
            type: string
          in: query
          name: hcpcsCodes
          required: false
          description: Comma-separated HCPCS codes to filter by
        - schema:
            type: string
          in: query
          name: policyTopic
          required: false
          description: Keywords describing the policy content
        - schema:
            type: string
          in: query
          name: policyTopicForKeywordExtraction
          required: false
          description: String for keyword extraction (beta)
        - schema:
            type: string
          in: query
          name: planId
          required: false
          description: ID of the plan to which the policy belongs
        - schema:
            type: string
          in: query
          name: companyId
          required: false
          description: ID of the company to which the policy belongs
        - schema:
            type: string
          in: query
          name: policyType
          required: false
          description: Type of policy (MEDICAL_POLICY, PAYMENT_POLICY, etc.)
        - schema:
            type: string
          in: query
          name: activeAt
          required: false
          description: Filter policies active at this date (YYYY-MM-DD)
        - schema:
            type: string
          in: query
          name: updatedAtMin
          required: false
          description: Filter policies updated on or after this date (YYYY-MM-DD)
        - schema:
            type: string
          in: query
          name: updatedAtMax
          required: false
          description: Filter policies updated on or before this date (YYYY-MM-DD)
        - schema:
            type: number
          in: query
          name: limit
          required: false
          description: Maximum number of results to return
        - schema:
            type: number
          in: query
          name: skip
          required: false
          description: Number of results to skip
      responses:
        '200':
          description: Successfully retrieved policies
          content:
            application/json:
              schema:
                type: object
                properties:
                  policies:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          description: Unique identifier for the policy
                        name:
                          type: string
                          description: Policy name
                        plan_policy_id:
                          type: string
                          description: Plan-specific policy identifier
                        plan:
                          type: object
                          properties:
                            name:
                              type: string
                              description: Plan name
                            state:
                              type: string
                              description: State where the plan is available
                          required:
                            - name
                            - state
                          additionalProperties: false
                        type:
                          type: string
                          description: >-
                            Type of policy (MEDICAL_POLICY, PAYMENT_POLICY,
                            etc.)
                        file_url:
                          type: string
                          description: URL to the policy document
                        date_effective:
                          type: string
                          description: Effective date of the policy
                        date_expiration:
                          type: string
                          nullable: true
                          description: Expiration date of the policy
                        is_active:
                          type: boolean
                          description: Whether the policy is currently active
                        parent_policy_id:
                          type: string
                          description: Parent policy identifier
                        hcpcs_codes:
                          type: array
                          items:
                            type: string
                          description: Associated HCPCS codes
                        icd10_cm_codes:
                          type: array
                          items:
                            type: string
                          description: Associated ICD-10-CM codes
                        rank:
                          type: number
                          nullable: true
                          description: Policy ranking
                        updated_at:
                          type: string
                          description: Last updated date
                      required:
                        - id
                        - name
                        - plan_policy_id
                        - plan
                        - type
                        - file_url
                        - date_effective
                        - date_expiration
                        - is_active
                        - parent_policy_id
                        - hcpcs_codes
                        - icd10_cm_codes
                        - rank
                        - updated_at
                      additionalProperties: false
                  count:
                    type: number
                    description: Total number of policies available
                required:
                  - policies
                  - count
                additionalProperties: false
        '400':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    description: The error message.
                  message:
                    type: string
                    description: The message.
                  statusCode:
                    type: number
                    description: The status code.
                  details:
                    type: object
                    additionalProperties: {}
                    description: The details of the error
                additionalProperties: true
        '500':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    description: The error message.
                  message:
                    type: string
                    description: The message.
                  statusCode:
                    type: number
                    description: The status code.
                  details:
                    type: object
                    additionalProperties: {}
                    description: The details of the error
                additionalProperties: true

````