Get account usage and limits

Returns current usage and limit information for your account.

This endpoint is designed for:

• AI agents/MCP servers: Check constraints before planning batch operations
• Monitoring dashboards: Display current usage status
• Rate limit awareness: Know remaining capacity before making requests

Response includes:

• rateLimit - API request rate limit (requests per second)
• sendLimit - Email sending limit (emails per hour)
• billing - Credit balance and auto-recharge configuration

Notes:

• This request counts against your rate limit
• sendLimit may be null if Postal is temporarily unavailable
• billing is null if billing is not configured
• Send limit resets at the top of each hour

{
  "data": {
    "rateLimit": {
      "limit": 10,
      "remaining": 8,
      "reset": 1705312260,
      "period": "second"
    },
    "sendLimit": {
      "limit": 100,
      "used": 42,
      "remaining": 58,
      "usagePercent": 42,
      "period": "hour",
      "resetsAt": "2024-01-15T11:00:00.000Z"
    },
    "billing": {
      "creditBalance": "25.50",
      "creditBalanceCents": 2550,
      "autoRecharge": {
        "enabled": true,
        "threshold": "5.00",
        "amount": "20.00"
      },
      "hasPaymentMethod": true
    }
  },
  "meta": {
    "requestId": "req_V1StGXR8_Z5jdHi6"
  }
}