> ## Documentation Index
> Fetch the complete documentation index at: https://docs.daysync.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Organizations

> Read the organizations a user belongs to and the members of an organization.

**Organizations** are the top-level accounts that own tours. These endpoints are read-only and are the usual starting point for an integration — list the user's organizations, then list tours within one. Organization IDs are UUID strings.

All endpoints require the standard [authentication](/authentication) headers.

***

## List organizations

```text theme={null}
GET /v1/organizations
```

Returns every organization the authenticated user belongs to.

**Scope:** `organization.read`

This endpoint takes no parameters — the organizations are derived from the user token.

**Example**

```bash theme={null}
curl "$BASE/v1/organizations" \
  -H "x-api-key: $KEY" -H "x-api-secret: $SECRET" -H "Authorization: Bearer $TOKEN"
```

**Response `data`** — array of organizations:

```json theme={null}
{
  "id": "2f1c…",
  "name": "Acme Touring",
  "fileName": "logo.png",
  "orgUserCount": 12,
  "is_deactivated": false,
  "isBeta": false,
  "fromBeta": false,
  "is_unlimited_free": false,
  "is_trial": true,
  "absoluteLink": "https://app.daysync.com/org/2f1c…",
  "loggedInUserRole": { "id": 1, "name": "Owner" },
  "type": { "id": 1, "type": "AGENCY", "description": "Touring agency" },
  "created_by": { "id": "…", "firstname": "Jane", "lastname": "Doe" },
  "avatarColorType": { "id": 1, "type": "BLUE" }
}
```

* `loggedInUserRole` — the authenticated user's role in this organization.
* `is_unlimited_free` / `is_trial` / `isBeta` — billing flags; organizations with any of these are exempt from the [subscription requirement](/errors#subscription-requirement-402) on writes.

***

## List organization members

```text theme={null}
GET /v1/organizations/{orgId}/users
```

Returns active members, seat usage, and pending invites for an organization.

**Scope:** `organization.read`

**Path parameters**

| Name    | Type          | Description       |
| ------- | ------------- | ----------------- |
| `orgId` | string (UUID) | The organization. |

**Response `data`**

```json theme={null}
{
  "activeSeats": 10,
  "availableSeats": 2,
  "deactivatedSeats": 1,
  "activeUsers": [
    {
      "user_id": "…",
      "firstname": "Jane",
      "lastname": "Doe",
      "email": "jane@…",
      "phone_number": "+61…",
      "user_image": "https://…",
      "is_owner": true,
      "is_removed": false,
      "is_deleted": false,
      "is_deactivated": false,
      "last_active": "2026-06-01T09:00:00Z",
      "org_join_date": "2025-01-10T00:00:00Z",
      "user_role": { "id": 1, "name": "Owner" }
    }
  ],
  "invitedUsers": [
    {
      "invite_id": "…",
      "email": "newuser@…",
      "role": { "id": 2, "name": "Member" },
      "invited_by_fullname": "Jane Doe",
      "invite_sent_on": "2026-05-30T00:00:00Z",
      "is_deactivated": false
    }
  ]
}
```

***

See also: [Tours](/endpoints/tours).