---
title: "Get Organizations"
method: POST
path: "/organizations/get"
tags: ["Organizations"]
---

# Get Organizations

`POST /organizations/get`

## Request

- Base URL: `https://api.velt.dev/v2`
- URL: `https://api.velt.dev/v2/organizations/get`
- Auth: API key in header `x-velt-api-key` and API key in header `x-velt-auth-token`

Use this API to retrieve specific organizations by organization IDs.

**Requirements:**
- Enable advanced queries option in the Velt Console
- Deploy v4 series of the Velt SDK

## Request body

- object
  - `data` object, required
    - `organizationIds` string[]: Array of Organization IDs (max 30). If not provided, returns all organizations.
    - `pageSize` integer: Number of items per page
    - `pageToken` string: Page token from previous API call

## Response `200`

Organizations retrieved successfully

- object
  - `result` object
    - `status` string
    - `message` string
    - `data` Organization[]
      - `organizationId` string, required: Unique identifier for the organization
      - `organizationName` string, required: Display name of the organization
      - `disabled` boolean: Whether the organization is disabled
    - `nextPageToken` string

## Other responses

- `400`: Invalid request

---

[API](https://skmtc.dev/velt-js/apis/velt-rest-api.md) - [All operations](https://skmtc.dev/velt-js/apis/velt-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/velt-js/apis/velt-rest-api/revisions/0f5af15fa267?raw)