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

# List Schemas

> Returns a paginated list of active schemas. Supports filtering by schema type.

## Query Parameters

<ParamField query="page" type="integer" default="1">
  Page number
</ParamField>

<ParamField query="page_size" type="integer" default="20">
  Items per page (max: 100)
</ParamField>

<ParamField query="type" type="string" optional>
  Filter by schema type ("invoice" or "bank\_statement")
</ParamField>

## Response

```json Success Response (200) theme={null}
{
  "success": true,
  "data": {
    "schemas": [
      {
        "id": "b3376c85-86e0-476e-aee9-5f05afaa05ea",
        "name": "invoice_schema_v1",
        "type": "invoice",
        "description": "Schema for parsing standard invoices",
        "version": 1,
        "is_active": true,
        "created_at": "2024-01-18T12:34:56Z",
        "updated_at": "2024-01-18T12:34:56Z"
      }
    ],
    "page": 1,
    "limit": 20,
    "total": 1
  }
}
```

## Examples

### List All Schemas

```bash Curl theme={null}
# List all schemas
curl "https://api.invaro.ai/api/v1/schemas/list" \
  -H "Authorization: Bearer your_api_key"
```

### List with Pagination and Filtering

```bash Curl theme={null}
# List with pagination and filtering
curl "https://api.invaro.ai/api/v1/schemas/list?page=1&page_size=10&type=invoice" \
  -H "Authorization: Bearer your_api_key"
```


## OpenAPI

````yaml GET /api/v1/schemas/list
openapi: 3.0.0
info:
  title: Invaro Document Processing API
  description: API for processing bank statements and invoices using OCR and AI
  version: 1.0.0
  contact:
    name: Invaro Support
    email: support@invaro.ai
    url: https://docs.invaro.ai
servers:
  - url: https://api.invaro.ai/api/v1
    description: Production API
security:
  - bearerAuth: []
paths:
  /api/v1/schemas/list:
    get:
      tags:
        - Schema Management
      summary: List Schemas
      description: >-
        Returns a paginated list of active schemas. Supports filtering by schema
        type.
      operationId: listSchemas
      parameters:
        - name: page
          in: query
          required: false
          schema:
            type: integer
            default: 1
          description: Page number
        - name: page_size
          in: query
          required: false
          schema:
            type: integer
            default: 20
            maximum: 100
          description: Items per page
        - name: type
          in: query
          required: false
          schema:
            type: string
            enum:
              - invoice
              - bank_statement
          description: Filter by schema type
      responses:
        '200':
          description: Schemas retrieved successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: true
                  data:
                    type: object
                    properties:
                      schemas:
                        type: array
                        items:
                          $ref: '#/components/schemas/SchemaMetadata'
                      page:
                        type: integer
                        example: 1
                      limit:
                        type: integer
                        example: 20
                      total:
                        type: integer
                        example: 1
components:
  schemas:
    SchemaMetadata:
      type: object
      properties:
        id:
          type: string
          format: uuid
          example: b3376c85-86e0-476e-aee9-5f05afaa05ea
        name:
          type: string
          example: invoice_schema_v1
        type:
          type: string
          enum:
            - invoice
            - bank_statement
          example: invoice
        description:
          type: string
          example: Schema for parsing standard invoices
        version:
          type: integer
          example: 1
        is_active:
          type: boolean
          example: true
        created_at:
          type: string
          format: date-time
          example: '2024-01-18T12:34:56Z'
        updated_at:
          type: string
          format: date-time
          example: '2024-01-18T12:34:56Z'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````