Account

GET /v1/me

Returns the organization, the calling key and the WhatsApp numbers available.

Scope: account:read

This is the call to make first, and the call to make when something is wrong. It reaches the database, so a 200 proves the key is real, active and scoped; it cannot send anything or change anything, so it is safe to run from a terminal while debugging.

curl https://k-message.kerneltics.com/v1/me \
  -H "Authorization: Bearer km_live_YOUR_KEY"

200

{
  "organization": {
    "id": "8f3a1c2d-...",
    "name": "Zaiti Auto Parts",
    "slug": "zaiti"
  },
  "api_key": {
    "id": "1a2b3c4d-...",
    "name": "Orders service",
    "prefix": "km_live_a1b2c3d4",
    "scopes": ["account:read", "messages:send"],
    "rate_limit_per_min": 600,
    "expires_at": null,
    "last_used_at": "2026-08-20T09:14:58Z"
  },
  "whatsapp_accounts": [
    {
      "id": "9e8d7c6b-...",
      "name": "Main",
      "display_phone_number": "+966 51 021 5213",
      "phone_id": "123456789012345",
      "is_default_outgoing": true,
      "quality_rating": "GREEN",
      "messaging_limit_tier": "TIER_10K",
      "messaging_limit": 10000,
      "limits_synced_at": "2026-08-20T06:00:00Z"
    }
  ]
}

GET /v1/accounts

The WhatsApp numbers this organization can send from, most-default first.

Scope: account:read

200

{
  "data": [
    {
      "id": "9e8d7c6b-...",
      "name": "Main",
      "display_phone_number": "+966 51 021 5213",
      "phone_id": "123456789012345",
      "is_default_outgoing": true,
      "quality_rating": "GREEN",
      "messaging_limit_tier": "TIER_10K",
      "messaging_limit": 10000
    }
  ],
  "has_more": false
}

Fields

Field	Notes
name	What you pass as from when sending. Unique within your organization.
display_phone_number	The number as Meta formats it, for showing to people.
phone_id	Meta’s own identifier. Useful when comparing our records with your Meta dashboard.
is_default_outgoing	Used when a send omits from.
quality_rating	Meta’s rating: GREEN, YELLOW, RED or UNKNOWN. A drop to RED precedes a messaging-limit cut.
messaging_limit	Distinct people you may start a conversation with per rolling 24 hours. 0 means not synced yet, which callers should treat as unknown rather than as zero.

The messaging limit is counted by Meta at the business portfolio level, so every number sharing a portfolio draws on one pool. Two numbers each reporting 10,000 does not mean 20,000 between them.

Access tokens, app secrets and webhook verify tokens are never returned by this API.