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

# SMS Queue Stats

> Get SMS queue statistics for monitoring.

Returns the number of active and pending messages in each provider queue.

Args:
    provider: Optional provider filter (twilio, vonage, telnyx)

Returns:
    SMSQueueStatsResponse: Queue statistics

Inspect SMS queue statistics for provider-level monitoring.

### Query Parameters

* `provider` (string, optional): Filter queue stats to one provider. Supported values include `twilio`, `telnyx`, and `vonage`.

### Response

```json Response theme={null}
{
  "timestamp": "2026-04-30T10:15:00Z",
  "queues": {
    "twilio": {
      "pending": 2,
      "active": 1,
      "failed": 0
    },
    "telnyx": {
      "pending": 0,
      "active": 0,
      "failed": 0
    },
    "vonage": {
      "pending": 1,
      "active": 0,
      "failed": 0
    }
  }
}
```

The exact queue keys may vary as the queue service evolves, but the response always includes a `timestamp` and a `queues` object keyed by provider.


## OpenAPI

````yaml GET /sms/queue/stats
openapi: 3.1.0
info:
  title: Burki
  description: A system that uses AI to answer customer Calls.
  version: 0.1.0
servers: []
security: []
paths:
  /sms/queue/stats:
    get:
      summary: Get Sms Queue Stats
      description: >-
        Get SMS queue statistics for monitoring.


        Returns the number of active and pending messages in each provider
        queue.


        Args:
            provider: Optional provider filter (twilio, vonage, telnyx)

        Returns:
            SMSQueueStatsResponse: Queue statistics
      operationId: get_sms_queue_stats_sms_queue_stats_get
      parameters:
        - name: provider
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            title: Provider
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SMSQueueStatsResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - HTTPBearer: []
components:
  schemas:
    SMSQueueStatsResponse:
      properties:
        timestamp:
          type: string
          title: Timestamp
        queues:
          additionalProperties: true
          type: object
          title: Queues
          description: Queue statistics per provider
      type: object
      required:
        - timestamp
        - queues
      title: SMSQueueStatsResponse
      description: Response model for SMS queue statistics.
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    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:
    HTTPBearer:
      type: http
      scheme: bearer

````