---
title: "User organizations"
method: GET
path: "/users/{user_id}/organizations"
tags: ["Organizations"]
---

# User organizations

`GET /users/{user_id}/organizations`

Retrieves organizations that the specified user is a member of.

## Path parameters

- `user_id` string, uuid, required

## Query parameters

- `filter[id]` StringFilter
  - `eq` string — Equal
  - `ne` string — Not equal
  - `in` string — In (comma-separated list)
  - `nin` string — Not in (comma-separated list)
  - `between` string — Between (comma-separated list)
  - `contains` string — Contains
  - `starts` string — Starts with
  - `ends` string — Ends with
- `filter[type]` StringFilter
  - `eq` string — Equal
  - `ne` string — Not equal
  - `in` string — In (comma-separated list)
  - `nin` string — Not in (comma-separated list)
  - `between` string — Between (comma-separated list)
  - `contains` string — Contains
  - `starts` string — Starts with
  - `ends` string — Ends with
- `filter[vendor]` StringFilter
  - `eq` string — Equal
  - `ne` string — Not equal
  - `in` string — In (comma-separated list)
  - `nin` string — Not in (comma-separated list)
  - `between` string — Between (comma-separated list)
  - `contains` string — Contains
  - `starts` string — Starts with
  - `ends` string — Ends with
- `filter[status]` StringFilter
  - `eq` string — Equal
  - `ne` string — Not equal
  - `in` string — In (comma-separated list)
  - `nin` string — Not in (comma-separated list)
  - `between` string — Between (comma-separated list)
  - `contains` string — Contains
  - `starts` string — Starts with
  - `ends` string — Ends with
- `filter[updated_at]` DateTimeFilter
  - `eq` string — Equal
  - `ne` string — Not equal
  - `between` string — Between (comma-separated list)
  - `gt` string — Greater than
  - `gte` string — Greater than or equal
  - `lt` string — Less than
  - `lte` string — Less than or equal
- `page[size]` integer
- `page[before]` string
- `page[after]` string
- `sort` string

## Response `200`

OK

- object
  - `items` Organization[]
    - `id` string, ulid — The ID of the organization.
    - `type` 'fixed' | 'flexible' — The type of the organization.
    - `owner_id` string, uuid — The ID of the owner.
    - `namespace` string — The namespace in which the organization name is unique.
    - `name` string — A unique machine name representing the organization.
    - `label` string — The human-readable label of the organization.
    - `country` string — The organization country (2-letter country code).
    - `capabilities` string[] — The organization capabilities.
    - `vendor` string — The vendor.
    - `billing_account_id` string — The Billing Account ID.
    - `billing_legacy` boolean — Whether the account is billed with the legacy system.
    - `security_contact` string, email — The security contact email address for the organization.
    - `status` 'active' | 'restricted' | 'suspended' | 'deleted' — The status of the organization.
    - `created_at` string, date-time — The date and time when the organization was created.
    - `updated_at` string, date-time — The date and time when the organization was last updated.
    - `_links` object
      - `self` object — Link to the current organization.
        - `href` string — URL of the link.
      - `update` object — Link for updating the current organization.
        - `href` string — URL of the link.
        - `method` string — The HTTP method to use.
      - `delete` object — Link for deleting the current organization.
        - `href` string — URL of the link.
        - `method` string — The HTTP method to use.
      - `members` object — Link to the current organization's members.
        - `href` string — URL of the link.
      - `create-member` object — Link for creating a new organization member.
        - `href` string — URL of the link.
        - `method` string — The HTTP method to use.
      - `address` object — Link to the current organization's address.
        - `href` string — URL of the link.
      - `profile` object — Link to the current organization's profile.
        - `href` string — URL of the link.
      - `payment-source` object — Link to the current organization's payment source.
        - `href` string — URL of the link.
      - `orders` object — Link to the current organization's orders.
        - `href` string — URL of the link.
      - `vouchers` object — Link to the current organization's vouchers.
        - `href` string — URL of the link.
      - `apply-voucher` object — Link for applying a voucher for the current organization.
        - `href` string — URL of the link.
        - `method` string — The HTTP method to use.
      - `subscriptions` object — Link to the current organization's subscriptions.
        - `href` string — URL of the link.
      - `create-subscription` object — Link for creating a new organization subscription.
        - `href` string — URL of the link.
        - `method` string — The HTTP method to use.
      - `estimate-subscription` object — Link for estimating the price of a new subscription.
        - `href` string — URL of the link.
      - `mfa-enforcement` object — Link to the current organization's MFA enforcement settings.
        - `href` string — URL of the link.
  - `_links` ListLinks
    - `self` Link — A hypermedia link to the {current, next, previous} set of items.
      - `href` string — URL of the link
    - `previous` Link — A hypermedia link to the {current, next, previous} set of items.
      - `href` string — URL of the link
    - `next` Link — A hypermedia link to the {current, next, previous} set of items.
      - `href` string — URL of the link

## Other responses

- `400` — Bad Request
- `403` — Forbidden

---

[API](https://skmtc.net/upsun/apis/upsun-com-rest-api.md) · [All operations](https://skmtc.net/upsun/apis/upsun-com-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/upsun/upsun-com-rest-api/revisions/6cc88fde6435/schema)