---
title: "List organizations"
method: GET
path: "/organizations"
tags: ["Organizations"]
---

# List organizations

`GET /organizations`

## Request

- Base URL: `https://dashboard.hologram.io/api/1`
- URL: `https://dashboard.hologram.io/api/1/organizations`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/hologram/apis/hologram-rest-api-v1/docs/organizations/get.ts> (a function with typed inputs; its response is checked against the schema)

List organizations. Returns all organizations that you are a member of. This includes the personal organization tied to your user. When you create your Hologram account, a personal organization associated solely with your account is also created. This personal org is named after you. You cannot add other users to this personal organization.

## Query parameters

- `limit` integer
- `id` integer
- `ids` string
- `startafter` integer
- `q` string
- `personal_for` integer
- `shared_orgs_only` integer
- `userids` string
- `with_verified_status` integer
- `withbilling_scheme` boolean

## Response `200`

OK

- ListOrganizationsResponse
  - `success` boolean: Indicates whether the request was successful.
  - `limit` integer
  - `size` integer
  - `continues` boolean
  - `lastid` integer: ID of the last record returned, for cursor-based pagination
  - `links` PaginationLinks
    - `path` string: The API endpoint path
    - `base` string: The API base URL
    - `next` string: URL to retrieve the next page of results
  - `data` OrganizationObject[]
    - `id` integer: Unique organization ID
    - `name` string: Organization display name
    - `ownerid` integer: User ID of the organization owner
    - `is_personal` 0 | 1: 1 if this is a personal organization belonging to a single user
    - `ccemails` string: Comma-separated list of email addresses for credit card receipts
    - `proplan` 0 | 1: 1 if the organization is on a Pro plan
    - `invoice_text` string: Custom text appended to invoices
    - `preflight_timeout_in_days` integer: Number of days a SIM stays in Test Mode before automatically activating
    - `users` OrganizationUserEntry[]: Members of the organization
      - `id` integer: User ID
      - `email` string: User email
      - `first` string: First name
      - `last` string: Last name
      - `permissions` string[]: List of permissions granted to this user in the organization
    - `pending` OrganizationPendingEntry[]: Users with pending invitations
      - `email` string: Email address the invitation was sent to
      - `inviteid` integer: Invitation ID

## Other responses

- `401`: Unauthorized

---

[API](https://skmtc.dev/hologram/apis/hologram-rest-api-v1.md) - [All operations](https://skmtc.dev/hologram/apis/hologram-rest-api-v1/llms.txt) - [OpenAPI document](https://skmtc.dev/hologram/apis/hologram-rest-api-v1/revisions/1bc07dcd1631?raw)