curl "https://searchcompany-main.up.railway.app/api/user/businesses" \
-H "Authorization: Bearer <clerk_jwt_token>"
{
"businesses": [
{
"id": "org_2abc123",
"name": "Nike",
"slug": "nike-123456",
"image_url": null,
"role": "org:admin",
"business_url": "https://nike.com",
"subscription_status": "active",
"created_at": 1702234567
},
{
"id": "org_2def456",
"name": "Adidas",
"slug": "adidas-789012",
"image_url": null,
"role": "org:admin",
"business_url": "https://adidas.com",
"subscription_status": "active",
"created_at": 1702345678
}
],
"total": 2
}
🟢 GET - User Businesses
Get User Businesses
Get all businesses the authenticated user belongs to
GET
/
api
/
user
/
businesses
curl "https://searchcompany-main.up.railway.app/api/user/businesses" \
-H "Authorization: Bearer <clerk_jwt_token>"
{
"businesses": [
{
"id": "org_2abc123",
"name": "Nike",
"slug": "nike-123456",
"image_url": null,
"role": "org:admin",
"business_url": "https://nike.com",
"subscription_status": "active",
"created_at": 1702234567
},
{
"id": "org_2def456",
"name": "Adidas",
"slug": "adidas-789012",
"image_url": null,
"role": "org:admin",
"business_url": "https://adidas.com",
"subscription_status": "active",
"created_at": 1702345678
}
],
"total": 2
}
Returns all organizations (businesses) that the authenticated user is a member of. Used for the business switcher toggle to allow users to switch between their different businesses.
Each business is completely independent with its own:
- Billing and subscription
- Team members
- Products and tracking data
- Visibility scores
Authentication
Requires a valid Clerk JWT token in the Authorization header.Response
array
List of businesses the user belongs to
integer
Total number of businesses
Business Object
| Field | Type | Description |
|---|---|---|
id | string | Clerk organization ID |
name | string | Business display name |
slug | string | URL-friendly identifier |
image_url | string | Business logo/image URL |
role | string | User’s role (org:admin or org:member) |
business_url | string | Primary website URL |
subscription_status | string | active, trialing, canceled, etc. |
created_at | integer | Unix timestamp |
curl "https://searchcompany-main.up.railway.app/api/user/businesses" \
-H "Authorization: Bearer <clerk_jwt_token>"
{
"businesses": [
{
"id": "org_2abc123",
"name": "Nike",
"slug": "nike-123456",
"image_url": null,
"role": "org:admin",
"business_url": "https://nike.com",
"subscription_status": "active",
"created_at": 1702234567
},
{
"id": "org_2def456",
"name": "Adidas",
"slug": "adidas-789012",
"image_url": null,
"role": "org:admin",
"business_url": "https://adidas.com",
"subscription_status": "active",
"created_at": 1702345678
}
],
"total": 2
}
Use Cases
- Business Switcher: Populate the dropdown showing all businesses a user can access
- Multi-tenant Dashboard: Allow users to manage multiple independent businesses
- Role-based Access: Show different UI based on user’s role in each org
Notes
- A user can belong to multiple organizations
- Each organization is billed separately
- Switching between orgs is instant (no page reload needed)
- New businesses are created via the onboarding flow with
?new=trueparameter