GET /api/partners/:id

Get public metadata for a specific partner

Fetches public metadata for a partner by its UUID, including branding information.

Endpoint

GET https://app.kash.bot/api/partners/:id

Path Parameters

id · string · required

The unique partner identifier (UUID format)

Response

partner · object

Partner metadata

Show Partner Object

id · string

Unique partner identifier

organizationId · string

Parent organization ID

name · string

Partner name

slug · string

URL-friendly slug

description · string

Partner description (nullable)

displayName · string

Display name for UI rendering (nullable)

tagline · string

Short tagline (nullable)

colorPrimary · string

Brand color in hex format (nullable)

logoUrl · string

Logo image URL (nullable)

websiteUrl · string

Partner website URL (nullable)

status · string

Partner status: active, inactive

_meta · object

Request metadata

Show Metadata Properties

requestedAt · string

ISO 8601 timestamp of request processing

Rate Limit

100 requests per minute per IP address

Example Request

cURL

curl "https://app.kash.bot/api/partners/6ba7b810-9dad-11d1-80b4-00c04fd430c8"

Example Response

200 - Success

{
  "partner": {
    "id": "6ba7b810-9dad-11d1-80b4-00c04fd430c8",
    "organizationId": "550e8400-e29b-41d4-a716-446655440000",
    "name": "sports-daily",
    "slug": "sports-daily",
    "description": "Leading sports prediction marketplace",
    "displayName": "Sports Daily",
    "tagline": "Predict every game",
    "colorPrimary": "#3EF47E",
    "logoUrl": "https://cdn.kash.bot/partners/sports-daily-logo.png",
    "websiteUrl": "https://sportsdaily.example.com",
    "status": "active"
  },
  "_meta": {
    "requestedAt": "2026-03-04T12:00:00Z"
  }
}

404 - Not Found

{
  "error": "Partner not found",
  "message": "No partner exists with ID: 6ba7b810-9dad-11d1-80b4-00c04fd430c8",
  "code": "NOT_FOUND"
}

429 - Rate Limit Exceeded

{
  "error": "Too many requests",
  "message": "Rate limit of 100 requests per minute exceeded",
  "code": "RATE_LIMIT_EXCEEDED",
  "retryAfter": 45
}

Common Use Cases

Apply partner branding to an embed

async function applyPartnerBranding(partnerId) {
  const { partner } = await fetch(
    `https://app.kash.bot/api/partners/${partnerId}`
  ).then(r => r.json());

  return {
    name: partner.displayName || partner.name,
    color: partner.colorPrimary,
    logo: partner.logoUrl,
    tagline: partner.tagline,
  };
}

Navigate from partner to its organization

async function getPartnerOrg(partnerId) {
  const { partner } = await fetch(
    `https://app.kash.bot/api/partners/${partnerId}`
  ).then(r => r.json());

  const { organization } = await fetch(
    `https://app.kash.bot/api/organizations/${partner.organizationId}`
  ).then(r => r.json());

  return { partner, organization };
}

Related Endpoints

GET /api/partners/:id/threads

List threads for this partner

GET /api/organizations/:id

Get the parent organization

GET /api/markets

Filter markets by partnerId