List Organizations

GET

/org

GET

/api/v1/org

$ curl -G https://app.rightbrain.ai/api/v1/org \
>      -H "Authorization: Bearer <token>" \
>      -d membership=active

1 {
2   "results": [
3     {
4       "name": "Meridian Freight Logistics",
5       "contact_email": "[email protected]",
6       "id": "019a2f10-8a1c-7e42-9b53-1c9d4e7b6f01",
7       "avatar_url": "https://cdn.rightbrain.ai/assets/avatars/organization/019a2f10-8a1c-7e42-9b53-1c9d4e7b6f01/base.png",
8       "public_metadata": {},
9       "low_credit_alerts": true,
10       "usage_based_pricing_enabled": false,
11       "plan": "teams",
12       "plan_status": "active",
13       "plan_interval": "monthly",
14       "auto_topup_config": {
15         "enabled": false
16       },
17       "account": {
18         "org_id": "019a2f10-8a1c-7e42-9b53-1c9d4e7b6f01",
19         "id": "019a2f10-8a2c-7e43-8e97-1c9d4e7b6f0a",
20         "credits": 48000,
21         "modified": "2026-07-15T09:00:00Z"
22       }
23     },
24     {
25       "name": "Meridian Sandbox",
26       "contact_email": "[email protected]",
27       "id": "019a2f10-8f1d-7e4a-8fa8-1c9d4e7b6f0b",
28       "public_metadata": {},
29       "low_credit_alerts": false,
30       "usage_based_pricing_enabled": false,
31       "plan": "trial",
32       "plan_status": "active",
33       "trial_ends_at": "2026-08-19T00:00:00Z",
34       "auto_topup_config": {},
35       "account": {
36         "org_id": "019a2f10-8f1d-7e4a-8fa8-1c9d4e7b6f0b",
37         "id": "019a2f10-8f2e-7e4b-90b9-1c9d4e7b6f0c",
38         "credits": 500,
39         "modified": "2026-07-01T00:00:00Z"
40       }
41     }
42   ],
43   "pagination": {
44     "next_cursor": "0190a234-8dc6-6d08-aea9-928fcecad8f2",
45     "has_next": true,
46     "page_limit": 25
47   }
48 }

List organizations based on the user’s relationship to them.

Use the membership parameter to filter organizations by your access level:

active: Organizations you are a member of (default)
joinable: Organizations you can request to join
joinable_by_domain: Organizations that accept members from your email domain
joinable_by_invite: Organizations you have pending invites to

This endpoint is useful for:

Displaying the user’s current organizations
Showing organizations the user can join
Building organization switching interfaces

List organizations based on the user's relationship to them. Use the `membership` parameter to filter organizations by your access level: - **active**: Organizations you are a member of (default) - **joinable**: Organizations you can request to join - **joinable_by_domain**: Organizations that accept members from your email domain - **joinable_by_invite**: Organizations you have pending invites to This endpoint is useful for: - Displaying the user's current organizations - Showing organizations the user can join - Building organization switching interfaces

Authentication

AuthorizationBearer

API key or access token, sent as Authorization: Bearer <token>. The simplest option: create an API key in your dashboard under Settings, then paste it here.

Query parameters

membershipenumOptionalDefaults to active

Filter organizations by membership status.

Values:

active (default) - Organizations you belong to
joinable - Organizations you can request to join
joinable_by_domain - Organizations matching your email domain
joinable_by_invite - Organizations you have pending invites to

Filter organizations by membership status. **Values:** - `active` (default) - Organizations you belong to - `joinable` - Organizations you can request to join - `joinable_by_domain` - Organizations matching your email domain - `joinable_by_invite` - Organizations you have pending invites to

Allowed values:

cursorstring or nullOptionalformat: "uuid"

Pagination cursor for the next page of results

page_limitintegerOptional1-100Defaults to 100

Maximum number of organizations to return per page

Response

Successfully retrieved organizations

resultslist of objects

The list of items returned for the current page.

paginationobject or nullOptional

Contains pagination information for the result set.

Errors

401

Unauthorized Error

422

Unprocessable Entity Error

500

Internal Server Error