> Source: https://vitna.ai/docs/api/v1/prices/providers
> Raw Markdown: https://vitna.ai/docs/api/v1/prices/providers.md
> Corpus index: https://vitna.ai/llms.txt

# 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}
```

```bash
curl https://vitna.ai/api/v1/providers
curl https://vitna.ai/api/v1/providers/openai
```

## Index response

```json
{
  "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

```json
{
  "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](../../../concepts/sku.md) 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`.
