expiry-dashboard
/api/v1/expiry-dashboard
0 credits/call
expiry
Home-screen summary: active items split into red/yellow/green urgency bands (<=1 / 2-3 / 4-7+ days to expiry, DLCScan pattern from PLAN.md), plus totals.
Sign in + create an API key on the keys page to authenticate calls.
curl -X POST https://rokom.ba/api/v1/expiry-dashboard \
-H "Authorization: Bearer mcpsk_<your_api_key>" \
-H "Content-Type: application/json" \
-d '{}'
Add this server to Claude Desktop's claude_desktop_config.json. The endpoint becomes a callable tool inside Claude. See the MCP setup guide for the full walk-through.
{
"mcpServers": {
"this-api": {
"url": "https://rokom.ba/mcp",
"transport": "http",
"auth": {
"type": "bearer",
"token": "mcpsk_<your_api_key>"
}
}
}
}
Inside Claude this endpoint surfaces as the tool expiry-dashboard.
Standard requests — no custom SDK needed. pip install requests first.
import requests
r = requests.post(
"https://rokom.ba/api/v1/expiry-dashboard",
headers={"Authorization": "Bearer mcpsk_<your_api_key>"},
json={},
)
r.raise_for_status()
print(r.json())
Plain fetch. Works in Node 18+, Deno, Bun, and any modern browser.
const r = await fetch("https://rokom.ba/api/v1/expiry-dashboard", {
method: "POST",
headers: {
"Authorization": "Bearer mcpsk_<your_api_key>",
"Content-Type": "application/json",
},
body: JSON.stringify({}),
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
console.log(await r.json());
Input
This endpoint takes no input.
Output
| Field | Type | Required | Default | Description | ||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| company_name | string | required | — | |||||||||||||||||
| store_name | string | required | — | |||||||||||||||||
| credit_balance | integer | required | — | |||||||||||||||||
| expired | object<UrgencyBand> | required | — |
View nested fields (3)
|
||||||||||||||||
| red | object<UrgencyBand> | required | — |
View nested fields (3)
|
||||||||||||||||
| yellow | object<UrgencyBand> | required | — |
View nested fields (3)
|
||||||||||||||||
| green | object<UrgencyBand> | required | — |
View nested fields (3)
|
||||||||||||||||
| total_active | integer | required | — | |||||||||||||||||
| total_quantity | integer | required | — |
Try it
Fires a real POST /api/v1/expiry-dashboard from your browser. Charges 0 credits per call against your account.