Skip to main content
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
​
_meta
object
Request metadata

​
Rate Limit

100 requests per minute per IP address

​
Example Request

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,
  };
}

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 };
}

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