---
title: "Read the workspace's capabilities record, the selectable use-case profiles, and live usage against its caps"
method: GET
path: "/v1/organizations/{organization_id}/capabilities"
---

# Read the workspace's capabilities record, the selectable use-case profiles, and live usage against its caps

`GET /v1/organizations/{organization_id}/capabilities`

## Request

- Base URL: `https://api.skysay.ai`
- URL: `https://api.skysay.ai/v1/organizations/{organization_id}/capabilities`
- Auth: none declared

Pure read. Every workspace has exactly one record from creation on: `capabilities.status` is `not_activated` until the workspace clears verification (an operator's business review, or its first registration-free number), when it becomes `active` on the default profile, the channels the workspace holds and every destination except the sanctioned set (`all_countries: true`). `pending_review` means a request is with an Skysay operator and nothing new is authorized yet; `suspended` means an operator paused outbound. When `all_countries` is false, `countries` is the explicit allowlist (ISO 3166-1 alpha-2). `calling_rules` is the application cadence contract an operator recorded on approval, or null, and `calling_rules_active` says whether it is enforced right now. Every outbound call and SMS is authorized against this record (see POST /v1/policies/authorize-outbound).

## Path parameters

- `organization_id` string, required

## Response `200`

Capabilities record, calling rules, available profiles and usage

- CapabilitiesDetail: The record, its calling rules, the profiles the workspace may select from, and live usage against its caps.
  - `available_profiles` CapabilitiesProfile[]
    - `allowed_purposes` string[]
    - `allowed_recipient_types` string[]
    - `channels` string[]
    - `default_caps` object
    - `description` string
    - `key` 'personal_assistant' | 'business_support' | 'appointments_reservations' | 'payment_reminder' | 'internal_operations' | 'customer_outreach' | 'implementation_services_custom'
    - `label` string
  - `calling_rules` object, nullable: The customer-visible projection of the application calling rules recorded during Skysay approval (effective period, time zone, calling windows, per-case cadence and attempt cap, escalation actions), or null when none apply. Configured by Skysay, never by this API.
  - `calling_rules_active` boolean: True when calling rules are set and the record is active, i.e. they are enforced on every call right now.
  - `capabilities` Capabilities: The workspace's capabilities record: what it may do outbound. One per workspace, always. `active` authorizes outbound within the listed profiles, channels, destinations and limits; every other status authorizes nothing new.
    - `all_countries` boolean: True: every destination except the sanctioned set is authorized and `countries` is empty. False: `countries` is the explicit allowlist. Activation through verification sets it true; a request chooses.
    - `approved_at` string, nullable
    - `approved_by` string: `self_serve` for a request approved within the catalog, the operator who approved it, or the verification door that activated it.
    - `approved_profiles` string[]
    - `calling_rules` object: The application calling rules an operator recorded on approval; `{}` when none apply.
    - `channels` string[]
    - `compliance_profile_id` string: The verified business profile the record was activated against; empty until verification clears.
    - `countries` string[]: The destination allowlist as ISO 3166-1 alpha-2 codes when `all_countries` is false. A call or text to any other country is held for review.
    - `created_at` string
    - `customer_visible_message` string: Server-composed status sentence for the workspace; display as-is.
    - `destination_restrictions` string[], nullable: Optional customer narrowing, intersected with current capabilities at admission. null means no additional customer restriction.
    - `destination_revision` integer: Revision required when saving optional destination restrictions.
    - `id` string
    - `limits` object: The profile caps projected into the workspace's risk controls at its last activation or approval (per-day/per-minute call and SMS counts, unique destinations, daily voice and wallet spend in minor units). Empty when no profile caps were projected. The caps enforced right now are the workspace's risk controls, which an operator may have changed since; `/v1/dashboard/capabilities` reports those.
    - `metadata` object
    - `organization_id` string
    - `policy_accepted_at` string, nullable
    - `policy_accepted_by` string
    - `policy_version` string
    - `status` 'not_activated' | 'pending_review' | 'active' | 'suspended'
    - `updated_at` string
  - `generated_at` string
  - `usage` CapabilitiesUsage: Live usage for the same rolling windows the record's limits are expressed in.
    - `outbound_calls_last_day` integer
    - `outbound_calls_last_minute` integer
    - `sms_last_day` integer
    - `unique_destinations_last_day` integer
    - `wallet_spend_last_day_minor` integer

## Other responses

- `403`: The credential does not belong to this organization
- `404`: Unknown organization

---

[API](https://skmtc.dev/skysay/apis/skysay-api.md) · [All operations](https://skmtc.dev/skysay/apis/skysay-api/llms.txt) · [OpenAPI document](https://skmtc.dev/skysay/apis/skysay-api/revisions/95b8c66f99aa?raw)