Organization
Get your organization
Returns your organization's settings, including its name, billing email, plan and throughput tier, message retention window, and a summary of its 10DLC registration (overall brand status plus brand and campaign counts).
The organization is always resolved from your credentials, so this endpoint only ever returns your own organization.
Requires the org:read scope, which is granted to every customer role.
AuthorizationBearer <token>
Authenticate by sending your API key as a bearer token:
Authorization: Bearer am_live_.... Every request is automatically
scoped to the organization that owns the key and to the scopes granted
to that key.
In: header
Response Body
application/json
application/json
application/json
curl -X GET "https://example.com/v1/organization"{
"success": true,
"data": {
"id": "0190a1b2-c3d4-e5f6-a7b8-c9d0e1f2a3b4",
"name": "Acme Health",
"billing_email": "billing@acme.example",
"plan": "payg",
"throughput_tier": 2,
"message_retention_days": 90,
"mms_retention_days": 30,
"is_reseller": false,
"quiet_hours": {
"enabled": false,
"start": "21:00",
"end": "08:00",
"mode": "reject"
},
"auto_replies": {
"enabled": true,
"stop_text": null,
"help_text": null,
"start_text": null
},
"registration_status": {
"brand": "ACTIVE",
"brand_count": 1,
"campaign_count": 2
},
"created_at": "2026-01-04T12:00:00Z"
}
}{
"success": false,
"error": {
"code": "UNAUTHORIZED",
"message": "authentication failed",
"request_id": "01JTBQH2FZ8K1RXC0WJ4Z9P3VM"
}
}{
"success": false,
"error": {
"code": "FORBIDDEN",
"message": "missing required scope",
"request_id": "01JTBQH2FZ8K1RXC0WJ4Z9P3VM"
}
}