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

# List policies

> List policies that you've requested



## OpenAPI

````yaml /medical-api-reference/openapi.json get /policies
openapi: 3.0.1
info:
  title: OpenAPI For SME Medical Insurance
  description: API's that you need to use to request insurance(s) for your clients
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://production.yasmina.ai/api/v1/medical
  - url: https://sandbox.yasmina.ai/api/v1/medical
security:
  - bearerAuth: []
paths:
  /policies:
    get:
      tags:
        - Policies
      summary: List policies
      description: List policies that you've requested
      parameters:
        - name: company_id
          in: query
          schema:
            type: number
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/Policy'
        '401':
          $ref: '#/components/responses/Unauthorized'
components:
  schemas:
    Policy:
      type: object
      properties:
        id:
          type: integer
        meta_data:
          $ref: '#/components/schemas/Insured'
        start_date:
          type: string
        provider_policy_id:
          type: integer
        provider_policy:
          type: string
        order_status:
          type: integer
        approval_status:
          type: integer
        end_date:
          type: string
        is_claimed:
          type: boolean
        created_at:
          type: string
        updated_at:
          type: string
        client_id:
          type: string
        canceled_at:
          type: string
          nullable: true
        invoice:
          type: string
        cancellation_document:
          type: string
    Insured:
      type: object
      properties:
        name:
          type: string
        nationality_iso:
          type: string
        category:
          type: string
          description: group
          enum:
            - basic
            - economy
            - standard
            - classic
            - advance
            - premier
            - executive
            - elite
        nationality_id:
          type: string
          description: For Saudi's
        iqama_id:
          type: string
          description: For Non-Saudi's
        number_of_dependents:
          type: number
        date_of_birth:
          type: string
      required:
        - name
        - nationality_iso
        - category
        - date_of_birth
        - number_of_dependents
  responses:
    Unauthorized:
      description: Unauthorized
      content:
        application/json:
          schema:
            type: object
            properties:
              code:
                type: string
                example: '40101'
              message:
                type: string
                example: Unauthenticated
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````