DocumentationAPI v1
Providers
Every company whose own pages Vitna reads a price from, with the pages read, the markets each sells into, and any registered products no longer on the board.
GET /api/v1/providers
GET /api/v1/providers/{id}curl https://vitna.ai/api/v1/providers
curl https://vitna.ai/api/v1/providers/openaiIndex response
{
"summary": "45 companies whose own pages Vitna reads a price from...",
"providers": [
{
"id": "openai",
"name": "OpenAI",
"homepage": "https://openai.com",
"path": "/providers/openai",
"pricedSkuCount": 42,
"registeredSkuCount": 45,
"awaitingSkuCount": 0,
"withdrawnSkuCount": 3,
"unattestedSkuCount": 0,
"livePageCount": 2,
"cadence": "every hour",
"freshestConfirmedAt": "2026-09-12T08:00:11.402Z",
"markets": [
{
"class": "model",
"label": "Language models",
"rowCount": 35,
"skuCount": 35
}
],
"summary": "Vitna reads 2 pages from OpenAI every hour..."
}
],
"meta": {
"generatedAt": "2026-09-12T09:14:02.881Z",
"source": "database",
"count": 45
}
}Provider detail response
{
"provider": {
"id": "openai",
"name": "OpenAI",
"homepage": "https://openai.com",
"path": "/providers/openai",
"termsUrl": "/api/v1/providers/openai/terms",
"pricedSkuCount": 42,
"registeredSkuCount": 45,
"livePageCount": 2,
"cadence": "every hour",
"pages": [
{
"id": "openai-pricing-md",
"publicUrl": "https://developers.openai.com/api/docs/pricing",
"cadenceMinutes": 60,
"live": true,
"notes": null
}
],
"markets": [
{
"class": "model",
"label": "Language models",
"skuCount": 35,
"skus": [
{
"slug": "gpt-5.4-pro",
"name": "gpt-5.4-pro",
"kind": "model",
"historyUrl": "/api/v1/skus/gpt-5.4-pro/history",
"confirmedAt": null,
"stale": false,
"derived": false
}
]
}
],
"withdrawn": [ ... ],
"unattested": [ ... ],
"summary": "Vitna reads 2 pages from OpenAI every hour..."
},
"meta": {
"generatedAt": "2026-09-12T09:14:02.881Z",
"source": "database"
}
}Joined through the register, never by display name
A board row belongs to a provider through sku.providerId in the SKU register rather than by matching the display string printed on a board. One company spelled two ways across two markets still resolves to one row here and on /providers/{id}.
withdrawn vs unattested
Both arrays list registered SKUs that are absent from the current boards, and the distinction is the point:
| Key | Meaning |
|---|---|
withdrawn | A healthy source read its page on schedule and the SKU was no longer on it |
unattested | The provider's source could not read its page, so nobody can speak for whether the SKU is still sold |
Caching
public, max-age=60, stale-while-revalidate=3600.
