Get Account Details

Retrieve current organization information, account owner details, active registered WhatsApp phone numbers, primary WABA metadata, and subscription limits using an API key. Essential for third-party integrations, Zapier, Make, and Google Workspace Add-ons.

GET/api/v1/account

Recommendation

You can also use the canonical alias endpoint: GET /api/v1/me

Response Payload

200 OKapplication/json

successbooleanrequired

Whether request succeeded

messagestringrequired

Human-readable result

data.organizationobjectrequired

Organization metadata (id, name, slug, timezone, currency)

data.userobjectrequired

User account details (user_id, email, full_name)

data.api_keyobjectrequired

Authenticated API key info and rate limit tier

data.subscriptionobjectrequired

Current billing plan tier and subscription status

data.whatsapp.phone_numbersarray<object>required

List of registered WhatsApp phone numbers with verified names, status, and is_default indicator

data.whatsapp.wabaobjectrequired

Primary WhatsApp Business Account metadata

Code Snippets & Examples

curl -X GET "https://app.chatofy.in/api/v1/account" \
  -H "Authorization: Bearer YOUR_API_KEY"

Was this endpoint guide helpful?

Enterprise SLA•99.99% Guaranteed

curl -X GET "https://app.chatofy.in/api/v1/account" \
  -H "Authorization: Bearer YOUR_API_KEY"

200 OKapplication/json

{
  "success": true,
  "message": "Account details retrieved successfully",
  "data": {
    "organization": {
      "id": "9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d",
      "name": "Acme Technologies",
      "slug": "acme-tech",
      "created_at": "2026-01-10T12:00:00.000Z",
      "timezone": "Asia/Kolkata",
      "locale": "en-US",
      "currency": "INR"
    },
    "user": {
      "user_id": "c1f2e3d4-5678-90ab-cdef-1234567890ab",
      "email": "[email protected]",
      "full_name": "Sumit Singh"
    },
    "api_key": {
      "id": "key_83749281",
      "name": "Google Workspace Add-on",
      "rate_limit_tier": "growth"
    },
    "subscription": {
      "tier": "growth",
      "name": "Growth Plan",
      "status": "ACTIVE",
      "current_period_end": "2026-10-10T12:00:00.000Z"
    },
    "whatsapp": {
      "default_phone_number_id": "104829384729102",
      "total_phone_numbers": 1,
      "phone_numbers": [
        {
          "id": "pn_0928374",
          "phone_number_id": "104829384729102",
          "display_phone_number": "+91 78383 43515",
          "verified_name": "Chatofy Notifications",
          "quality_rating": "GREEN",
          "status": "CONNECTED",
          "throughput_level": "STANDARD",
          "messaging_limit_tier": "TIER_10K",
          "name_status": "APPROVED",
          "is_default": true,
          "created_at": "2026-01-15T09:30:00.000Z"
        }
      ],
      "waba": {
        "id": "waba_928374",
        "waba_id": "293847192847102",
        "name": "Chatofy Main WABA",
        "currency": "INR",
        "timezone": "Asia/Kolkata",
        "status": "ACTIVE"
      }
    }
  }
}

{ "success": true, "message": "Account details retrieved successfully", "data": { "organization": { "id": "9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d", "name": "Acme Technologies", "slug": "acme-tech", "created_at": "2026-01-10T12:00:00.000Z", "timezone": "Asia/Kolkata", "locale": "en-US", "currency": "INR" }, "user": { "user_id": "c1f2e3d4-5678-90ab-cdef-1234567890ab", "email": "[email protected]", "full_name": "Sumit Singh" }, "api_key": { "id": "key_83749281", "name": "Google Workspace Add-on", "rate_limit_tier": "growth" }, "subscription": { "tier": "growth", "name": "Growth Plan", "status": "ACTIVE", "current_period_end": "2026-10-10T12:00:00.000Z" }, "whatsapp": { "default_phone_number_id": "104829384729102", "total_phone_numbers": 1, "phone_numbers": [ { "id": "pn_0928374", "phone_number_id": "104829384729102", "display_phone_number": "+91 78383 43515", "verified_name": "Chatofy Notifications", "quality_rating": "GREEN", "status": "CONNECTED", "throughput_level": "STANDARD", "messaging_limit_tier": "TIER_10K", "name_status": "APPROVED", "is_default": true, "created_at": "2026-01-15T09:30:00.000Z" } ], "waba": { "id": "waba_928374", "waba_id": "293847192847102", "name": "Chatofy Main WABA", "currency": "INR", "timezone": "Asia/Kolkata", "status": "ACTIVE" } } } }