---
title: "Get admin's organizations"
method: GET
path: "/v2/organizations"
---

# Get admin's organizations

`GET /v2/organizations`

## Request

- Base URL: `https://api.signnow.com`
- URL: `https://api.signnow.com/v2/organizations`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/signnow/apis/signnow-api/docs/v2/organizations/get.ts> (a function with typed inputs; its response is checked against the schema)

This endpoint allows API users to retrieve the organizations in which the user is a moderator or admin.

## Response `200`

Successful response. Returns the list of organizations.

- object
  - `data` object[], required: Organizations in which the user is an admin or moderator.
    - `id` string, required: ID of the organization.
    - `logo` unknown
    - `name` string, required: Name of the organization.
    - `active` boolean, required: `true` if the organization is active.
    - `has_admin` boolean: `true` if the organization has an admin.
    - `creator_id` string: ID of the user who created the organization.
    - `membership` object[]: Membership of the current user in the organization.
      - `role` object: Role of the current user in the organization.
        - `name` string: Name of the role, for example `admin`.
        - `unique_id` string: ID of the role.
        - `capabilities` object: Permissions of the role.
          - `edit` boolean: `true` if the role can edit documents.
          - `send` boolean: `true` if the role can send documents for signing.
          - `view` boolean: `true` if the role can view documents.
          - `invite_request` boolean: `true` if the role can request to invite users.
          - `documents_manage` boolean: `true` if the role can manage documents of other members.
          - `workspace_create` boolean: `true` if the role can create workspaces.
          - `workspace_users_manage` boolean: `true` if the role can manage workspace users.
          - `workspace_settings_manage` boolean: `true` if the role can manage workspace settings.
      - `type` string: Membership type of the current user, for example `admin`.
      - `status` string: Status of the membership, for example `active`.
      - `invited_by` object: User who invited the current user to the organization.
        - `id` string: ID of the user who sent the invite.
        - `email` string: Email address of the user who sent the invite.
    - `is_workspace` boolean: `true` if the organization is a workspace.
    - `is_default_workspace` boolean: `true` if the organization is the default workspace of the user.
  - `meta` object, required: Pagination details.
    - `pagination` object, required: Pagination details.
      - `count` number, required: Number of items on the current page.
      - `links` object, required: Links to the adjacent pages. An empty array if there are no other pages.
        - `next` string: URL of the next page. Returned only if there is a next page.
        - `previous` string: URL of the previous page. Returned only if there is a previous page.
      - `total` number, required: Total number of items.
      - `per_page` number, required: Maximum number of items per page.
      - `total_pages` number, required: Total number of pages.
      - `current_page` number, required: Number of the current page.

## Other responses

- `400`: * Wrong, expired, or missing token. * `per_page` isn't a number. * `per_page` is greater than `100`. * `page` isn't a number.

---

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