---
title: "Gets organizations."
method: GET
path: "/account/organizations"
tags: ["Account"]
---

# Gets organizations.

`GET /account/organizations`

## Request

- Base URL: `https://api.reveldigital.com`
- URL: `https://api.reveldigital.com/account/organizations`
- Auth: one of:
  - OAuth 2
    - Authorization code: `https://id.reveldigital.com/connect/authorize`
    - Token URL: `https://id.reveldigital.com/connect/token` scopes: `webapi`
  - API key in header `X-RevelDigital-ApiKey`
  - API key in query parameter `api_key`
- TypeScript: <https://skmtc.dev/reveldigital/apis/revel-digital-rest-api/docs/account/organizations/get.ts> (a function with typed inputs; its response is checked against the schema)

## Response `200`

Returns list of organizations

- Organization[]
  - `id` string, nullable: The organization id
  - `name` string, nullable: The organization name
  - `address_1` string, nullable: Address line 1
  - `address_2` string, nullable: Address line 2
  - `city` string, nullable: The city
  - `state` string, nullable: The state
  - `postal_code` string, nullable: The postal code
  - `country` string, nullable: The country
  - `phone` string, nullable: The phone number
  - `fax` string, nullable: The fax number
  - `timeZone` string, nullable: The time zone
  - `language_code` string, nullable: The language code
  - `users` User[], nullable: The users assigned to this organization
    - `id` string, nullable: The user id
    - `first_name` string, nullable: The first name
    - `last_name` string, nullable: The last name
    - `city` string, nullable: The city
    - `state` string, nullable: The state
    - `postal_code` string, nullable: The postal code
    - `country` string, nullable: The country
    - `home_phone` string, nullable: The home phone number
    - `work_phone` string, nullable: The work phone number
    - `mobile_phone` string, nullable: The mobile phone number
    - `created_on` string, date-time, nullable: The date the user was created
    - `email` string, nullable: The email address
    - `role` string[], nullable: The roles assigned to this user
    - `user_name` string, nullable: The username
    - `last_activity` string, date-time, nullable: The date the user last logged in
    - `email_alerts` boolean, nullable: Whether the user has email alerts enabled
    - `sms_alerts` boolean, nullable: Whether the user has SMS alerts enabled
    - `is_two_factor` boolean, nullable: Whether the user has two-factor authentication enabled

## Other responses

- `400`: If the account API key is invalid

---

[API](https://skmtc.dev/reveldigital/apis/revel-digital-rest-api.md) - [All operations](https://skmtc.dev/reveldigital/apis/revel-digital-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/reveldigital/apis/revel-digital-rest-api/revisions/39d5c8302822?raw)