Skip to main content
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 the Authorization header.

​
Path Parameters

​
business_id
string
required
The Clerk organization slug (e.g., alphax-technologies-787155)

​
Response

​
business
object
The business entity object, or null if not found.
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:
  1. Fetch: Tries /favicon.ico, /apple-touch-icon.png, then Google’s favicon service
  2. Convert: Converts to PNG (128x128) for browser compatibility
  3. Upload: Stores in Supabase Storage bucket favicons
  4. 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

StatusDescription
401Missing or invalid JWT token
500Database not configured