Get an organization

One organization in full, with its members and their roles — everything a team settings page needs in a single call. Invite tokens are never included, even for members who have not accepted yet. Requires the `organizations.read` permission.

GET
/organizations/{organizationId}

Authorization

AuthorizationBearer <token>

The access token returned after a successful sign-in, sent as Authorization: Bearer <access_token>.

It identifies the person and the organization they are working in, and it lasts about fifteen minutes. When it runs out, use their refresh token at POST /auth/refresh-token instead of asking them to sign in again.

In: header

Path Parameters

organizationId*string

Identifier of the organization. Each endpoint states whether it must be the caller's active organization or may be used without authentication.

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://api.dual.network/organizations/665f1c2d4b1a2c3d4e5f6aa0"
{
  "id": "665f1c2d4b1a2c3d4e5f6aa0",
  "name": "Northside Events",
  "description": "Ticketing for the Northside venues.",
  "fqdn": "tickets.northside.example",
  "owner_id": "665f1c2d4b1a2c3d4e5f6a01",
  "members": [
    {
      "id": "665f1c2d4b1a2c3d4e5f6a70",
      "wallet_id": "665f1c2d4b1a2c3d4e5f6a01",
      "email": "alex@example.com",
      "role_name": "owner",
      "invite_status": "accepted",
      "when_created": "2026-02-01T09:00:00Z"
    },
    {
      "id": "665f1c2d4b1a2c3d4e5f6a71",
      "email": "sam@example.com",
      "role_name": "member",
      "invite_status": "pending",
      "when_created": "2026-03-05T15:12:00Z"
    }
  ],
  "roles": [
    {
      "id": "665f1c2d4b1a2c3d4e5f6ab0",
      "name": "member",
      "permissions": [
        {
          "resource": "objects",
          "crud": {
            "read": true,
            "create": false,
            "update": false,
            "delete": false
          }
        }
      ],
      "when_created": "2026-02-01T09:00:00Z",
      "when_modified": "2026-02-01T09:00:00Z"
    }
  ],
  "when_created": "2026-02-01T09:00:00Z",
  "when_modified": "2026-03-05T15:12:00Z"
}
{
  "code": 3,
  "message": "Key: 'limit' Error:Field validation for 'limit' failed on the 'lte' tag"
}

{
  "code": 16,
  "message": "no auth provided"
}

{
  "code": 5,
  "message": "object not found"
}
{
  "code": 13,
  "message": "internal error"
}