Organizations

Get an organization

Get an organization. Returns JSON unless otherwise noted.

Authentication

Authorizationbearer token

Requires organizations.read — Read organizations.

Path parameters

organizationIdstringrequired

The organization identifier.

Responses

200Successful response

400The request is invalid

401Authentication is missing or invalid

403The token does not have the required scope

429Rate limit exceeded

const response = await fetch('https://api.ufw.dev/v1/account/organizations/{organizationId}', {
  method: 'GET',
  headers: {
    Authorization: 'Bearer YOUR_ACCESS_TOKEN',
  },
});

const data = await response.json();

Response200

{
  "organization": {
    "id": "org_5Yb3Nq8Wd2",
    "slug": "acme",
    "name": "Acme, Inc.",
    "website_url": "https://example.com",
    "support_email": "support@example.com",
    "description": "Independent audio studio.",
    "sso_enabled": false,
    "logo_url": "https://assets.ufw.dev/orgs/acme.png",
    "current_role": "OWNER",
    "can_admin": true,
    "can_own": true,
    "members": [
      {
        "id": "mem_2Gc5Xr7Tk1",
        "account_id": "acc_7Kd2Rm9QpX",
        "handle": "ada",
        "display_name": "Ada Lovelace",
        "email": "ada@example.com",
        "role": "OWNER",
        "created_at": "2026-08-11T09:24:05Z"
      }
    ],
    "domains": [
      {
        "id": "dom_9Lz3Fp4Nv6",
        "domain": "example.com",
        "status": "VERIFIED",
        "verification_token": "ufw-verify=8f2c1a…",
        "verification_hostname": "_ufw.example.com",
        "verified_at": "2026-08-11T09:24:05Z"
      }
    ],
    "audit": [
      {
        "id": "aud_7Bt4Mq2Wd9",
        "action": "MEMBER_INVITED",
        "target_type": "MEMBER",
        "target_label": "grace@example.com",
        "actor_name": "Ada Lovelace",
        "created_at": "2026-08-11T09:24:05Z"
      }
    ]
  }
}