> ## Documentation Index > Fetch the complete documentation index at: https://docs.xerobi.com/llms.txt > Use this file to discover all available pages before exploring further. # Get consumer usage stats > Returns data usage statistics including daily and monthly consumption. Usage data is updated approximately every 15 minutes. **Use Cases:** - Monitor data consumption - Display usage graphs in customer portal - Check against data caps (if applicable) Returns data usage statistics including daily and monthly consumption. Usage data is updated approximately every 15 minutes. **Use Cases:** * Monitor data consumption * Display usage graphs in customer portal * Check against data caps (if applicable) ## OpenAPI ````yaml GET /consumer/usage openapi: 3.1.0 info: title: Xerobi Fiber API description: >- API for Xerobi Fiber customers and business clients. ## Overview The Xerobi Fiber API provides two distinct interfaces: - **Consumer API**: Simple, user-friendly endpoints for residential customers to check their network status, account details, usage statistics, and run speed tests. - **Business API**: Advanced endpoints for enterprise clients to manage IP assignments, monitor bandwidth usage, and automate network operations. ## Authentication All endpoints require Bearer token authentication. Include your JWT token in the Authorization header: ``` Authorization: Bearer YOUR_JWT_TOKEN ``` Tokens can be obtained from your Xerobi account dashboard. ## Versioning All requests must include the `Hixe-Version` header with the API version date (format: YYYY-MM-DD). Current version: `2026-01-01` ## Rate Limiting - Consumer endpoints: 100 requests per minute - Business endpoints: 1000 requests per minute Rate limit information is included in response headers: - `X-RateLimit-Limit`: Maximum requests allowed - `X-RateLimit-Remaining`: Requests remaining in current window - `X-RateLimit-Reset`: Unix timestamp when the limit resets version: '2026-01-01' contact: name: Xerobi API Support email: support@xerobi.com url: https://support.hixbe.com license: name: Proprietary url: https://hixbe.com/terms servers: - url: https://api.hixbe.com/fiber description: Production API security: - bearerAuth: [] tags: - name: Consumer description: Endpoints for residential customers - name: Business description: Endpoints for enterprise clients paths: /consumer/usage: get: tags: - Consumer summary: Get consumer usage stats description: >- Returns data usage statistics including daily and monthly consumption. Usage data is updated approximately every 15 minutes. **Use Cases:** - Monitor data consumption - Display usage graphs in customer portal - Check against data caps (if applicable) operationId: getConsumerUsage parameters: - $ref: '#/components/parameters/hixeVersionHeader' responses: '200': description: Successfully retrieved usage statistics content: application/json: schema: $ref: '#/components/schemas/ConsumerUsage' example: daily_gb: 12.5 monthly_gb: 387.2 monthly_limit_gb: null last_updated: '2026-01-15T14:30:00Z' '401': $ref: '#/components/responses/UnauthorizedError' '429': $ref: '#/components/responses/RateLimitError' components: parameters: hixeVersionHeader: name: Hixe-Version in: header description: 'API version in YYYY-MM-DD format. Current version: 2026-01-01' required: true schema: type: string pattern: ^\d{4}-\d{2}-\d{2}$ example: '2026-01-01' schemas: ConsumerUsage: type: object description: Data usage statistics for consumer account properties: daily_gb: type: number description: Data used today in gigabytes example: 12.5 minimum: 0 monthly_gb: type: number description: Data used this billing cycle in gigabytes example: 387.2 minimum: 0 monthly_limit_gb: type: number description: Monthly data cap in gigabytes (null if unlimited) example: null nullable: true last_updated: type: string format: date-time description: Timestamp of last usage update (ISO 8601 format) example: '2026-01-15T14:30:00Z' required: - daily_gb - monthly_gb Error: type: object description: Standard error response properties: error: type: object properties: code: type: string description: Error code for programmatic handling example: invalid_request message: type: string description: Human-readable error message example: The Hixe-Version header is required details: type: object description: Additional error details nullable: true required: - code - message required: - error responses: UnauthorizedError: description: Authentication failed - invalid or missing token content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: unauthorized message: Invalid or expired authentication token RateLimitError: description: Rate limit exceeded content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: rate_limit_exceeded message: Too many requests. Please retry after 60 seconds headers: X-RateLimit-Limit: schema: type: integer description: Maximum requests allowed per window X-RateLimit-Remaining: schema: type: integer description: Requests remaining in current window X-RateLimit-Reset: schema: type: integer description: Unix timestamp when rate limit resets Retry-After: schema: type: integer description: Seconds to wait before retrying securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: JWT description: JWT token obtained from Xerobi account dashboard ```` ## Related topics - [Get usage report](https://docs.xerobi.com/sms-api/endpoint/get-usage-report.md) - [Get business bandwidth usage](https://docs.xerobi.com/network-api/endpoint/get-business-bandwidth-usage.md) - [Get consumer network info](https://docs.xerobi.com/network-api/endpoint/get-consumer-network.md) - [Get consumer account info](https://docs.xerobi.com/network-api/endpoint/get-consumer-account.md) - [Get Status](https://docs.xerobi.com/rpki-api/endpoint/get-status.md) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.