Skip to main content
GET
https://searchcompany-main.up.railway.app
/
api
/
organization
/
{org_id}
/
members
curl "https://searchcompany-main.up.railway.app/api/organization/org_2abc123/members" \
  -H "Authorization: Bearer <token>"
{
  "organization_id": "org_2abc123",
  "members": [
    {
      "id": "orgmem_xyz789",
      "user_id": "user_abc123",
      "first_name": "Colin",
      "last_name": "Snyder",
      "email": "colin@colinsnyder.com",
      "image_url": "https://img.clerk.com/...",
      "role": "org:admin",
      "created_at": 1702234567
    },
    {
      "id": "orgmem_def456",
      "user_id": "user_def456",
      "first_name": "Jane",
      "last_name": "Doe",
      "email": "jane@company.com",
      "image_url": "https://img.clerk.com/...",
      "role": "org:member",
      "created_at": 1702345678
    }
  ],
  "total_members": 2,
  "pending_invitations": [
    {
      "id": "inv_pending123",
      "email": "newteammate@company.com",
      "role": "org:member",
      "status": "pending",
      "created_at": 1702456789
    }
  ]
}
Returns all active team members and pending invitations for the Settings - Team page.

Path Parameters

org_id
string
required
The Clerk organization ID

Query Parameters

limit
integer
default:"100"
Maximum number of members to return
offset
integer
default:"0"
Pagination offset
include_pending
boolean
default:"true"
Whether to include pending invitations

Response

organization_id
string
The organization ID
members
array
List of active team members
total_members
integer
Total count of active members
pending_invitations
array
List of pending invitations (if include_pending=true)

Member Object

FieldTypeDescription
idstringMembership ID
user_idstringClerk user ID
first_namestringUser’s first name
last_namestringUser’s last name
emailstringUser’s email address
image_urlstringURL to user’s profile image
rolestring"org:admin" or "org:member"
created_atintegerUnix timestamp when user joined

Pending Invitation Object

FieldTypeDescription
idstringInvitation ID
emailstringInvited email address
rolestringRole they’ll have when they join
statusstring"pending"
created_atintegerUnix timestamp when invitation sent
curl "https://searchcompany-main.up.railway.app/api/organization/org_2abc123/members" \
  -H "Authorization: Bearer <token>"
{
  "organization_id": "org_2abc123",
  "members": [
    {
      "id": "orgmem_xyz789",
      "user_id": "user_abc123",
      "first_name": "Colin",
      "last_name": "Snyder",
      "email": "colin@colinsnyder.com",
      "image_url": "https://img.clerk.com/...",
      "role": "org:admin",
      "created_at": 1702234567
    },
    {
      "id": "orgmem_def456",
      "user_id": "user_def456",
      "first_name": "Jane",
      "last_name": "Doe",
      "email": "jane@company.com",
      "image_url": "https://img.clerk.com/...",
      "role": "org:member",
      "created_at": 1702345678
    }
  ],
  "total_members": 2,
  "pending_invitations": [
    {
      "id": "inv_pending123",
      "email": "newteammate@company.com",
      "role": "org:member",
      "status": "pending",
      "created_at": 1702456789
    }
  ]
}

Notes

  • Requires authentication with a valid Clerk JWT token
  • User must be a member of the organization to view members
  • Pending invitations are only returned if include_pending=true