curl -X GET "https://searchcompany-main.up.railway.app/api/business/alphax-technologies-787155" \
-H "Authorization: Bearer YOUR_CLERK_JWT"
{
"business": {
"id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
"name": "AlphaX Technologies",
"url": "https://alphax.inc",
"favicon_url": "https://wrxafcplzfqywrswtlgg.supabase.co/storage/v1/object/public/favicons/alphax-technologies-787155/a1b2c3d4e5f6.png",
"citation_count": 5,
"clerk_org_id": "alphax-technologies-787155",
"created_at": "2024-12-19T10:30:00Z"
}
}
🟢 GET - Business
Get Business
Retrieve business entity details including favicon
GET
/
api
/
business
/
{business_id}
curl -X GET "https://searchcompany-main.up.railway.app/api/business/alphax-technologies-787155" \
-H "Authorization: Bearer YOUR_CLERK_JWT"
{
"business": {
"id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
"name": "AlphaX Technologies",
"url": "https://alphax.inc",
"favicon_url": "https://wrxafcplzfqywrswtlgg.supabase.co/storage/v1/object/public/favicons/alphax-technologies-787155/a1b2c3d4e5f6.png",
"citation_count": 5,
"clerk_org_id": "alphax-technologies-787155",
"created_at": "2024-12-19T10:30:00Z"
}
}
Gets the business entity associated with a Clerk organization.
Authentication
Requires a valid Clerk JWT token in theAuthorization header.
Path Parameters
string
required
The Clerk organization slug (e.g.,
alphax-technologies-787155)Response
object
The business entity object, or
null if not found.Show Business Object
Show Business Object
string
UUID of the business entity
string
Display name of the business
string
Business website URL
string
Public URL to the business favicon (PNG, 128x128).
Stored in Supabase Storage. May be
null if not fetched yet.integer
Number of AI citations created for this business
string
Clerk organization slug
string
ISO 8601 timestamp of creation
curl -X GET "https://searchcompany-main.up.railway.app/api/business/alphax-technologies-787155" \
-H "Authorization: Bearer YOUR_CLERK_JWT"
{
"business": {
"id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
"name": "AlphaX Technologies",
"url": "https://alphax.inc",
"favicon_url": "https://wrxafcplzfqywrswtlgg.supabase.co/storage/v1/object/public/favicons/alphax-technologies-787155/a1b2c3d4e5f6.png",
"citation_count": 5,
"clerk_org_id": "alphax-technologies-787155",
"created_at": "2024-12-19T10:30:00Z"
}
}
{
"business": null
}
Favicon Storage
Favicons are automatically fetched and stored during onboarding:- Fetch: Tries
/favicon.ico,/apple-touch-icon.png, then Google’s favicon service - Convert: Converts to PNG (128x128) for browser compatibility
- Upload: Stores in Supabase Storage bucket
favicons - URL: Returns public CDN URL
Favicons are only fetched for business entities, not products.
If favicon fetch fails, the entity is still created with
favicon_url: null.Errors
| Status | Description |
|---|---|
| 401 | Missing or invalid JWT token |
| 500 | Database not configured |