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

# Get processing performance statistics

> Get processing performance statistics.

Returns processing throughput, latency percentiles, error rates, and top errors.
Useful for operations monitoring and performance dashboards.



## OpenAPI

````yaml openapi.json get /v1/stats/processing
openapi: 3.1.0
info:
  title: DocIntell API
  description: >-

    # DocIntell API


    **Turn Documents into Data. Keep the Source Safe.**


    Financial document intelligence platform that turns PDFs into queryable data
    while keeping source files secure and compliant.


    ## Features


    - **Document Ingestion**: Upload PDFs with SEC 17a-4 compliant immutable
    storage

    - **Schema Projection**: Query extracted data with custom schemas (not data
    dumps!)

    - **Multi-Schema Support**: Same document, multiple query patterns

    - **Webhook Delivery**: Async notifications on job completion

    - **Row-Level Security**: Multi-tenant isolation built-in


    ## Authentication


    All API endpoints (except `/health`, `/`, `/docs`, and `/redoc`) require API
    key authentication.


    Include your API key in the `Authorization` header:


    ```

    Authorization: Bearer dk_live_<your_key>

    ```


    Test keys start with `dk_test_`, production keys with `dk_live_`.


    ## Rate Limiting


    Per-tenant rate limits:

    - **Document ingestion**: 100 documents/hour

    - **Projection queries**: 1,000 requests/hour

    - **Schema operations**: 10 creates/hour


    Rate limit info is returned in response headers:

    - `X-RateLimit-Limit`: Maximum requests allowed

    - `X-RateLimit-Remaining`: Remaining requests in window

    - `X-RateLimit-Reset`: Unix timestamp when limit resets


    ## Error Handling


    All errors follow RFC 7807 Problem Details format:


    ```json

    {
      "error": "error_code",
      "message": "Human-readable description",
      "details": {}
    }

    ```


    Common error codes:

    - `unauthorized` (401): Missing or invalid API key

    - `rate_limit_exceeded` (429): Too many requests

    - `invalid_file_type` (400): Only PDFs supported

    - `file_too_large` (413): File exceeds size limit (default 100MB,
    configurable via MAX_UPLOAD_SIZE_MB)

    - `job_not_found` (404): Job ID doesn't exist or doesn't belong to tenant


    ## Getting Started


    1. Obtain API key from dashboard

    2. Upload PDF: `POST /v1/documents`

    3. Poll status: `GET /v1/documents/{document_id}/status`

    4. Query results: `POST /v1/documents/{document_id}/project`


    Full documentation: [https://docs.docintel.com](https://docs.docintel.com)
        
  contact:
    name: DocIntell Support
    url: https://docintel.com/support
    email: support@docintel.com
  license:
    name: Proprietary
    url: https://docintel.com/terms
  version: 0.1.0
servers:
  - url: http://localhost:8000
    description: Local development
  - url: https://api.docintell.com
    description: Production API
  - url: https://api-staging.docintell.com
    description: Staging environment
security:
  - bearerAuth: []
tags:
  - name: health
    description: Health check operations. Verify service and dependency connectivity.
    x-mint-tag-group: System
  - name: api_keys
    description: API key management operations. Create, list, and revoke API keys.
    x-mint-tag-group: Management
  - name: documents
    description: Document ingestion operations. Upload PDFs for extraction.
    x-mint-tag-group: Core
  - name: jobs
    description: >-
      Job status and query operations. Check extraction status and query
      results.
    x-mint-tag-group: Core
  - name: document-types
    description: >-
      Document type schemas. List and retrieve extraction schema definitions for
      financial document types.
  - name: webhooks
    description: >-
      Webhook configuration management. Create, update, and manage webhook
      endpoints for job completion notifications.
    x-mint-tag-group: Integrations
  - name: stats
    description: Analytics and metrics endpoints. Get document, job, and schema statistics.
  - name: views
    description: >-
      View management for consumption layer. Define field subsets for querying
      extraction data.
paths:
  /v1/stats/processing:
    get:
      tags:
        - stats
      summary: Get processing performance statistics
      description: >-
        Get processing performance statistics.


        Returns processing throughput, latency percentiles, error rates, and top
        errors.

        Useful for operations monitoring and performance dashboards.
      operationId: get_stats_processing_v1_stats_processing_get
      parameters:
        - name: start_date
          in: query
          required: false
          schema:
            anyOf:
              - type: string
                format: date
              - type: 'null'
            description: 'Start date (ISO 8601, default: 30 days ago)'
            title: Start Date
          description: 'Start date (ISO 8601, default: 30 days ago)'
        - name: end_date
          in: query
          required: false
          schema:
            anyOf:
              - type: string
                format: date
              - type: 'null'
            description: 'End date (ISO 8601, default: today)'
            title: End Date
          description: 'End date (ISO 8601, default: today)'
      responses:
        '200':
          description: Processing throughput, latency, and error metrics
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StatsProcessingResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    StatsProcessingResponse:
      properties:
        period:
          $ref: '#/components/schemas/StatsPeriod'
          description: Time period covered
        throughput:
          $ref: '#/components/schemas/ProcessingThroughput'
          description: Documents and pages processed per day
        latency:
          $ref: '#/components/schemas/ProcessingLatency'
          description: Processing time percentiles
        error_rate:
          anyOf:
            - type: number
            - type: 'null'
          title: Error Rate
          description: Ratio of failed to total jobs (0.0-1.0)
        top_errors:
          items:
            $ref: '#/components/schemas/TopError'
          type: array
          title: Top Errors
          description: Most common error messages
      type: object
      required:
        - period
        - throughput
        - latency
        - top_errors
      title: StatsProcessingResponse
      description: |-
        Response for processing stats (GET /v1/stats/processing).

        Processing performance metrics for operations monitoring.
      examples:
        - error_rate: 0.033
          latency:
            avg_seconds: 11.8
            p50_seconds: 8.2
            p95_seconds: 28.7
            p99_seconds: 45.3
          period:
            end: '2025-12-07'
            start: '2025-12-01'
          throughput:
            documents_per_day: 45.2
            pages_per_day: 1823.5
          top_errors:
            - count: 3
              message: Document AI timeout
            - count: 2
              message: Invalid PDF format
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    StatsPeriod:
      properties:
        start:
          type: string
          title: Start
          description: Start date (ISO 8601)
        end:
          type: string
          title: End
          description: End date (ISO 8601)
      type: object
      required:
        - start
        - end
      title: StatsPeriod
      description: Time period for stats queries.
      examples:
        - end: '2025-12-07'
          start: '2025-11-07'
    ProcessingThroughput:
      properties:
        documents_per_day:
          type: number
          title: Documents Per Day
          description: Average documents processed per day
        pages_per_day:
          type: number
          title: Pages Per Day
          description: Average pages processed per day
      type: object
      required:
        - documents_per_day
        - pages_per_day
      title: ProcessingThroughput
      description: Processing throughput metrics.
      examples:
        - documents_per_day: 45.2
          pages_per_day: 1823.5
    ProcessingLatency:
      properties:
        avg_seconds:
          anyOf:
            - type: number
            - type: 'null'
          title: Avg Seconds
          description: Average processing time in seconds
        p50_seconds:
          anyOf:
            - type: number
            - type: 'null'
          title: P50 Seconds
          description: 50th percentile processing time
        p95_seconds:
          anyOf:
            - type: number
            - type: 'null'
          title: P95 Seconds
          description: 95th percentile processing time
        p99_seconds:
          anyOf:
            - type: number
            - type: 'null'
          title: P99 Seconds
          description: 99th percentile processing time
      type: object
      title: ProcessingLatency
      description: Processing latency metrics.
      examples:
        - avg_seconds: 11.8
          p50_seconds: 8.2
          p95_seconds: 28.7
          p99_seconds: 45.3
    TopError:
      properties:
        message:
          type: string
          title: Message
          description: Error message or type
        count:
          type: integer
          title: Count
          description: Number of occurrences
      type: object
      required:
        - message
        - count
      title: TopError
      description: Top error message with count.
      examples:
        - count: 3
          message: Document AI timeout
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API Key
      description: 'API Key authentication. Format: dk_test_<key> or dk_live_<key>'

````