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

# Get Account Limits

> Return the authenticated account plan, subscription status, current usage, limits, and enabled features.

Return the authenticated account plan, subscription status, current usage, limits, and enabled features.

Use this endpoint before creating instances, importing contacts, or sending high-volume messages so your external application can show remaining quota clearly.

```json theme={null}
{
  "success": true,
  "account": {
    "teamId": 25,
    "teamName": "Jhon Doe Team"
  },
  "plan": {
    "id": 2,
    "name": "Pro",
    "interval": "month",
    "currency": "usd",
    "amount": 2900
  },
  "subscription": {
    "status": "active",
    "hasAccess": true,
    "isExpired": false,
    "isTrial": false,
    "isCancelled": false,
    "isPending": false,
    "isPastDue": false,
    "effectiveExpiry": "2026-07-13T08:00:00.000Z",
    "currentPeriodEnd": "2026-07-13T08:00:00.000Z",
    "trialEndsAt": null,
    "expiresAt": null
  },
  "limits": {
    "users": {
      "limit": 5,
      "used": 2,
      "remaining": 3,
      "isLimitReached": false
    },
    "contacts": {
      "limit": 10000,
      "used": 1240,
      "remaining": 8760,
      "isLimitReached": false
    },
    "instances": {
      "limit": 3,
      "used": 1,
      "remaining": 2,
      "isLimitReached": false
    },
    "messages": null
  },
  "features": {
    "ai": true,
    "flowBuilder": true,
    "campaigns": true,
    "templates": true,
    "voiceCalls": false
  }
}
```

<Note>
  A limit value of `Unlimited` means the plan does not restrict that resource.
</Note>


## OpenAPI

````yaml GET /account/limits
openapi: 3.0.3
info:
  title: Wachat Enterprise API
  description: >
    Welcome to the official Wachat API reference. Wachat provides
    developer-friendly, ultra-reliable infrastructure to scale your WhatsApp
    communications programmatically.


    Easily deploy automated messaging pipelines, orchestrate interactive
    customer engagement patterns, verify phone numbers instantly, and control
    containerized WhatsApp instances via a secure, production-grade REST
    architecture.
  version: 1.0.0
servers:
  - url: https://app.wachat.net/api/v1
    description: Live Production Gateway
security:
  - bearerAuth: []
paths:
  /account/limits:
    get:
      tags:
        - Account
      summary: Get Account Limits
      description: >-
        Return the authenticated account plan, subscription status, current
        usage, limits, and enabled features.
      responses:
        '200':
          description: Account limits returned successfully.
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: true
                  account:
                    type: object
                    properties:
                      teamId:
                        type: integer
                        example: 25
                      teamName:
                        type: string
                        example: Jakarta Team
                  plan:
                    type: object
                    properties:
                      id:
                        type: integer
                        nullable: true
                        example: 2
                      name:
                        type: string
                        nullable: true
                        example: Pro
                      interval:
                        type: string
                        nullable: true
                        example: month
                      currency:
                        type: string
                        nullable: true
                        example: usd
                      amount:
                        type: integer
                        nullable: true
                        example: 2900
                  subscription:
                    type: object
                    properties:
                      status:
                        type: string
                        example: active
                      hasAccess:
                        type: boolean
                        example: true
                      isExpired:
                        type: boolean
                        example: false
                      isTrial:
                        type: boolean
                        example: false
                      isCancelled:
                        type: boolean
                        example: false
                      isPending:
                        type: boolean
                        example: false
                      isPastDue:
                        type: boolean
                        example: false
                      effectiveExpiry:
                        type: string
                        nullable: true
                        format: date-time
                        example: '2026-07-13T08:00:00.000Z'
                      currentPeriodEnd:
                        type: string
                        nullable: true
                        format: date-time
                        example: '2026-07-13T08:00:00.000Z'
                      trialEndsAt:
                        type: string
                        nullable: true
                        format: date-time
                        example: null
                      expiresAt:
                        type: string
                        nullable: true
                        format: date-time
                        example: null
                  limits:
                    type: object
                    properties:
                      users:
                        $ref: '#/components/schemas/UsageLimit'
                      contacts:
                        $ref: '#/components/schemas/UsageLimit'
                      instances:
                        $ref: '#/components/schemas/UsageLimit'
                      messages:
                        nullable: true
                        allOf:
                          - $ref: '#/components/schemas/UsageLimit'
                  features:
                    type: object
                    properties:
                      ai:
                        type: boolean
                        example: true
                      flowBuilder:
                        type: boolean
                        example: true
                      campaigns:
                        type: boolean
                        example: true
                      templates:
                        type: boolean
                        example: true
                      voiceCalls:
                        type: boolean
                        example: false
        '401':
          description: Missing or invalid API key.
        '403':
          description: Subscription restriction prevented account limit lookup.
        '500':
          description: Internal server error.
components:
  schemas:
    UsageLimit:
      type: object
      properties:
        limit:
          oneOf:
            - type: integer
            - type: string
          example: 3
        used:
          type: integer
          example: 1
        remaining:
          oneOf:
            - type: integer
            - type: string
          example: 2
        isLimitReached:
          type: boolean
          example: false
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        Authenticate your integration payloads by injecting your premium secure
        Wachat Account API Private Secret Key inside standard Authorization
        Bearer header vectors.

````