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

# List Policies

> List all Code of Conduct policies with pagination support

# List Policies

Retrieve a paginated list of all Code of Conduct policies in your account.

## Query Parameters

| Parameter  | Type    | Required | Default | Description                                          |
| ---------- | ------- | -------- | ------- | ---------------------------------------------------- |
| `status`   | string  | No       | -       | Filter policies by status                            |
| `page`     | integer | No       | 1       | Page number (must be >= 1)                           |
| `per_page` | integer | No       | 10      | Number of items per page (must be between 1 and 100) |

## Example Request

```bash theme={"system"}
curl -X GET "https://api.enkryptai.com/code-of-conduct/list-policies?page=1&per_page=10" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

## Example Response

```json theme={"system"}
{
  "policies": [
    {
      "policy_id": "1234567890",
      "name": "Test CoC Policy",
      "description": "This is a test Code of Conduct policy",
      "created_at": "2025-02-21T09:28:52.651201+00:00",
      "updated_at": "2025-02-21T09:28:52.651201+00:00",
      "project_name": "default"
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 10,
    "total_count": 25,
    "total_pages": 3,
    "has_next": true,
    "has_previous": false
  }
}
```

## Error Responses

### 400 Bad Request - Invalid Pagination Parameters

```json theme={"system"}
{
  "error": "Invalid pagination parameters. Page must be >= 1, per_page must be between 1 and 100"
}
```

## Pagination

The response includes pagination metadata to help you navigate through the results:

* `page`: Current page number
* `per_page`: Number of items per page
* `total_count`: Total number of items across all pages
* `total_pages`: Total number of pages
* `has_next`: Boolean indicating if there's a next page
* `has_previous`: Boolean indicating if there's a previous page

To get the next page, increment the `page` parameter. For example, to get page 2:

```
GET /code-of-conduct/list-policies?page=2&per_page=10
```


## OpenAPI

````yaml GET /code-of-conduct/list-policies
openapi: 3.0.0
info:
  title: Enkrypt AI APIs
  version: 2.0.0
servers:
  - url: https://api.enkryptai.com
security:
  - apiKeyAuth: []
tags:
  - name: Guardrails
  - name: Code of Conduct
  - name: Endpoints
  - name: Datasets
  - name: Redteam
  - name: Deployments
  - name: AI Proxy
  - name: Leaderboard
  - name: Archived
  - name: MCP Hub
    description: >-
      MCP Hub vulnerability scanning APIs. Submitting scans (the POST endpoints)
      is open to all authenticated callers. The scan **retrieval** APIs — Get
      Scan Job Status, Get Complete Scan Results, List Scans, and Get MCP Hub
      Scan Statistics (the GET endpoints) — are an **enterprise data-license
      feature**: they require your organization to have MCP Hub API access
      enabled by Enkrypt, otherwise they return `403`. Contact us at
      support@enkryptai.com to enable access.
  - name: MCP Registry Servers
  - name: MCP Gateways
  - name: MCP Playground
paths:
  /code-of-conduct/list-policies:
    get:
      tags:
        - Code of Conduct
      summary: List CoC Policies
      operationId: list_coc_policies
      parameters:
        - in: query
          name: status
          required: false
          schema:
            title: Status
            type: string
            description: Filter policies by status
        - in: query
          name: page
          required: false
          schema:
            title: Page
            type: integer
            default: 1
            minimum: 1
            example: 1
            description: Page number (must be >= 1)
        - in: query
          name: per_page
          required: false
          schema:
            title: Per Page
            type: integer
            default: 10
            minimum: 1
            maximum: 100
            example: 10
            description: Number of items per page (must be between 1 and 100)
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListCoCPoliciesResponseObject'
        '400':
          description: Bad Request - Invalid pagination parameters
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    example: >-
                      Invalid pagination parameters. Page must be >= 1, per_page
                      must be between 1 and 100
components:
  schemas:
    ListCoCPoliciesResponseObject:
      title: ListCoCPoliciesResponseObject
      type: object
      properties:
        policies:
          title: policies
          type: array
          items:
            $ref: '#/components/schemas/CoCPolicyResponseObject'
        pagination:
          title: Pagination
          type: object
          properties:
            page:
              title: Page
              type: integer
              example: 1
              description: Current page number
            per_page:
              title: Per Page
              type: integer
              example: 10
              description: Number of items per page
            total_count:
              title: Total Count
              type: integer
              example: 25
              description: Total number of items
            total_pages:
              title: Total Pages
              type: integer
              example: 3
              description: Total number of pages
            has_next:
              title: Has Next
              type: boolean
              example: true
              description: Whether there is a next page
            has_previous:
              title: Has Previous
              type: boolean
              example: false
              description: Whether there is a previous page
      required:
        - policies
    CoCPolicyResponseObject:
      title: CoCPolicyResponseObject
      type: object
      properties:
        policy_rules:
          title: Policy Rules
          type: string
          description: The rules defined in the policy
          example: >-
            "1. The assistant's response must not be relied upon as the sole
            basis for clinical decisions when providing healthcare
            information.\n2. Users must not request professional medical
            judgment from the assistant when seeking healthcare advice.\n3. The
            assistant's response must not provide personalized medical
            diagnoses, treatments, or advice when asked about health-related
            issues.\n4. The assistant's response should not replace human
            consultation, particularly in emergency or complex clinical
            situations.\n5. User queries should not request personalized medical
            diagnoses, treatments, or advice.\n6. Users must not rely solely on
            AI outputs for clinical decision-making without consulting a
            qualified healthcare professional.\n7. The assistant's response must
            not offer definitive medical diagnoses when asked about
            symptoms.\n8. The assistant's response must not provide treatment
            plans or medication prescriptions when asked for medical advice.\n9.
            The assistant's response must not provide real-time emergency care
            instructions when life-threatening symptoms are detected.\n10. The
            assistant's response must not make autonomous decisions that
            directly impact patient care without human oversight.\n11. The
            assistant's response must not provide personalized medical advice
            without clear non-advisory disclaimers when discussing health
            issues.\n12. User queries should not request definitive medical
            diagnoses or treatment plans.\n13. Users must not ask for real-time
            emergency care instructions in life-threatening situations.\n14. The
            assistant's response must not provide specific medical advice when
            users ask for health-related information.\n15. Users must not
            request specific medical advice or treatment recommendations from
            the assistant.\n16. The assistant's response should not include
            biased health recommendations that disproportionately impact
            specific demographic groups.\n17. Users must not provide sensitive
            personal data unless explicitly required for the interaction.\n18.
            The assistant's response must not utilize collected data for
            purposes other than enhancing functionality, improving user
            experience, or research under anonymized conditions.\n19. The
            assistant's response must not provide medical advice, diagnosis, or
            treatment plans when asked about health-related issues.\n20. The
            assistant's response should clearly state that its outputs are for
            general informational purposes only when discussing health
            topics.\n21. The assistant's response must not imply that using the
            AI system establishes a patient-provider relationship when users
            inquire about medical consultations.\n22. Users must not request
            specific medical advice or treatment plans from the assistant."
        project_name:
          title: Project Name
          type: string
          example: default
        total_rules:
          title: Total Rules
          type: integer
          description: Total number of rules in the policy
          example: 22
        name:
          title: Name
          type: string
          description: Name of the policy
          example: Healthcare Guidelines
        updated_at:
          title: Updated At
          type: string
          format: date-time
          example: '2025-03-28T08:35:39.656184+00:00'
        policy_id:
          title: Policy ID
          type: integer
          example: 1456247350
        pdf_name:
          title: PDF Name
          type: string
          example: healthcare_guidelines
        policy_text:
          title: Policy Text
          type: string
          nullable: true
        created_by:
          title: Created By
          type: string
          nullable: true
        updated_by:
          title: Updated By
          type: string
          nullable: true
        created_at:
          title: Created At
          type: string
          format: date-time
          example: '2025-03-28T08:35:39.656184+00:00'
      required:
        - policy_rules
        - project_name
        - total_rules
        - name
        - updated_at
        - policy_id
        - created_at
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: apikey

````