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

# List policies



## OpenAPI

````yaml GET /v1/organization/policies
openapi: 3.1.0
info:
  title: Antara API
  version: 1.0.0
  description: OpenAI- and Anthropic-compatible inference plus organization management.
servers:
  - url: https://api.antarah.dev
security: []
paths:
  /v1/organization/policies:
    get:
      summary: List policies (summaries)
      parameters:
        - schema:
            type: string
            minLength: 1
            maxLength: 200
          required: false
          name: after
          in: query
        - schema:
            type: integer
            minimum: 1
            maximum: 100
            default: 20
          required: false
          name: limit
          in: query
        - schema:
            type: string
            enum:
              - draft
              - monitoring
              - enforcing
              - paused
          required: false
          name: state
          in: query
        - schema:
            type: string
            minLength: 1
            maxLength: 200
          required: false
          name: q
          in: query
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PolicyList'
        default:
          description: RFC 9457 problem details
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
      security:
        - adminKey: []
        - session: []
components:
  schemas:
    PolicyList:
      type: object
      properties:
        object:
          type: string
          enum:
            - list
        data:
          type: array
          items:
            $ref: '#/components/schemas/PolicySummary'
        has_more:
          type: boolean
        first_id:
          type:
            - string
            - 'null'
        last_id:
          type:
            - string
            - 'null'
      required:
        - object
        - data
        - has_more
        - first_id
        - last_id
    Problem:
      type: object
      properties:
        type:
          type: string
        title:
          type: string
        status:
          type: integer
        detail:
          type:
            - string
            - 'null'
        instance:
          type: string
        code:
          type: string
        request_id:
          type: string
        param:
          type:
            - string
            - 'null'
        errors:
          type: array
          items:
            type: object
            properties:
              pointer:
                type: string
              detail:
                type: string
            required:
              - pointer
              - detail
      required:
        - type
        - title
        - status
        - detail
        - instance
        - code
        - request_id
        - param
    PolicySummary:
      type: object
      properties:
        id:
          type: string
          pattern: ^pol_[0-9a-f]{32}$
          example: pol_0193a6c2e7b47c3d9f1e2a4b5c6d7e8f
        object:
          type: string
          enum:
            - organization.policy
        name:
          type: string
        description:
          type: string
        state:
          type: string
          enum:
            - draft
            - monitoring
            - enforcing
            - paused
        revision:
          type: integer
        has_unpublished_changes:
          type: boolean
        current_version:
          type:
            - integer
            - 'null'
        created_at:
          type: integer
          description: Unix seconds
          example: 1793750400
        updated_at:
          type: integer
          description: Unix seconds
          example: 1793750400
        direction:
          type: string
          enum:
            - request
            - response
            - both
        scope:
          type: string
          enum:
            - organization
            - projects
            - unattached
        mode:
          type: string
          enum:
            - monitoring
            - enforcing
        project_count:
          type: integer
      required:
        - id
        - object
        - name
        - description
        - state
        - revision
        - has_unpublished_changes
        - current_version
        - created_at
        - updated_at
        - direction
        - scope
        - mode
        - project_count
  securitySchemes:
    adminKey:
      type: http
      scheme: bearer
      description: '`ak_admin_…` Admin API key'
    session:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: >-
        Supabase access token + `Antara-Organization` (management) or
        `Antara-Project` (inference)

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.