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

# Get workspace usage

> Returns current usage counts and plan limits for the authenticated workspace.



## OpenAPI

````yaml /openapi.yaml get /api/v1/workspace/usage
openapi: 3.0.3
info:
  title: Torpedo API
  version: '1.0'
  description: |
    Torpedo is a transactional email API built for developers.
    Send emails from your own verified domain with a single HTTP call.
  contact:
    email: support@torpedo.co.mz
  termsOfService: https://torpedo.co.mz/terms
servers:
  - url: https://api.torpedo.co.mz
    description: Production
security:
  - ApiKeyAuth: []
paths:
  /api/v1/workspace/usage:
    get:
      tags:
        - Workspace
      summary: Get workspace usage
      description: >-
        Returns current usage counts and plan limits for the authenticated
        workspace.
      operationId: getWorkspaceUsage
      responses:
        '200':
          description: Usage and limits
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      plan:
                        type: string
                        example: pro
                      limits:
                        type: object
                        description: Plan limits. `-1` means unlimited.
                        properties:
                          emailsPerMonth:
                            type: integer
                            example: 20000
                          emailsPerDay:
                            type: integer
                            example: 1000
                          domains:
                            type: integer
                            example: 3
                          apiKeys:
                            type: integer
                            example: -1
                          webhooks:
                            type: integer
                            example: 10
                          members:
                            type: integer
                            example: 10
                      usage:
                        type: object
                        properties:
                          emailsThisMonth:
                            type: integer
                            example: 4231
                          emailsToday:
                            type: integer
                            example: 87
                          smsThisMonth:
                            type: integer
                            example: 512
                          smsCreditsBalance:
                            type: integer
                            example: 9488
                          domains:
                            type: integer
                            example: 2
                          apiKeys:
                            type: integer
                            example: 3
                          webhooks:
                            type: integer
                            example: 1
                          members:
                            type: integer
                            example: 2
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key
      description: |
        Prefix `tor_` followed by a base64url-encoded random key.
        Obtain one from `POST /api/v1/workspaces` or `POST /api/v1/auth/keys`.

````