List organizations

​

Returns a paginated list of organizations the calling user belongs to, sorted alphabetically.

Permissions
Key type Accepted Permission required Notes
Org API key no (403) — User-level endpoint — org keys have no user identity and cannot list orgs
Personal API key yes org:read Returns orgs in the key's scope (all user orgs, or the selected list); X-Org-ID is not required
Error Codes
Code HTTP Description
authorize.unauthenticated 401 No valid auth credentials
authorize.forbidden 403 Missing org:read permission or org key used
org.list.user_required 401 An authenticated user is required for this request
org.list.user.lookup_failed 500 Could not resolve calling user
org.list.failed 500 Failed to query memberships
Query Parameters
  • page
    Type: integer

    Page number (default 1)

  • limit
    Type: integer
    max:  
    100

    Items per page (default 20, max 100)

  • search
    Type: string

    Case-insensitive name search

Responses
  • application/json
  • application/json
  • application/json
  • application/json
Request Example for get/orgs
curl 'https://api.nametrust.com/orgs?page=1&limit=20&search='

{
  "object": "list",
  "items": [
    {
      "object": "org",
      "id": "org_01h455vb4pex5vsknk084sn02q",
      "name": "Acme Corp",
      "slug": "acme-corp",
      "created_at": "2025-06-01T12:00:00Z",
      "updated_at": "2025-06-15T09:30:00Z"
    }
  ],
  "pages": {
    "object": "cursor",
    "has_prev": true,
    "direction": "next",
    "cursor": "abc123",
    "next_cursor": "def456",
    "prev_cursor": "xyz789",
    "page": 2,
    "total_pages": 10,
    "total_items": 100,
    "limit": 20,
    "has_next": true
  }
}

Paginated list of organizations