---
title: "Load domain history"
method: POST
path: "/projects/{project_id}/domain-overview/history"
tags: ["domain-overview"]
---

# Load domain history

`POST /projects/{project_id}/domain-overview/history`

## Request

- Base URL: `https://eu.bisibility.com/api/v1`
- URL: `https://eu.bisibility.com/api/v1/projects/{project_id}/domain-overview/history`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer
  - OAuth 2 (authorization code, authorization URL `/api/auth/oauth2/authorize`, token URL `/api/auth/oauth2/token`, scopes: `api:write`)

Loads the priced history module for a current overview snapshot. max_cost_cents is required; use zero for cache-only access.

## Path parameters

- `project_id` string, required: Public project ID; membership and token scope are enforced.

## Headers

- `Bisibility-API-Version` 'v1'
- `Idempotency-Key` string
- `X-Bisibility-Source` 'sdk' | 'cli' | 'mcp'

## Request body

- DomainOverviewHistoryRequest
  - `fresh` boolean
  - `language_code` string, required
  - `location_code` integer, required
  - `scope_override` 'root' | 'subdomain'
  - `target` string, required
  - `max_cost_cents` integer, required

## Response `200`

JSON response

- DomainOverviewHistoryResponse
  - `data` object, required
    - `cached` boolean, required
    - `cost_cents` number, required
    - `data` DomainOverviewHistoricalRow[], required
      - `metrics` DomainOverviewMetrics, required
        - `count` integer, nullable, required
        - `estimated_traffic_cost_cents` number, nullable, required
        - `etv` number, nullable, required
        - `is_down` integer, required
        - `is_lost` integer, required
        - `is_new` integer, required
        - `is_up` integer, required
        - `pos1` integer, required
        - `pos2_3` integer, required
        - `pos4_10` integer, required
        - `pos11_20` integer, required
        - `pos21_30` integer, required
        - `pos31_40` integer, required
        - `pos41_50` integer, required
        - `pos51_60` integer, required
        - `pos61_70` integer, required
        - `pos71_80` integer, required
        - `pos81_90` integer, required
        - `pos91_100` integer, required
      - `month` integer, required
      - `year` integer, required
    - `fetched_at` string, date-time, nullable, required

## Other responses

- `400`: Bad request
- `401`: Unauthorized
- `402`: Deployment credits exhausted for a paid provider request
- `403`: Forbidden, or `byok_required`: the account runs paid provider work only on its own provider keys and none serves this request
- `404`: Not found
- `409`: snapshot_expired; Unsupported API version
- `422`: unsupported_target, unsupported_location, needs_reauth, lookup_failed, or cost_limit_exceeded
- `429`: budget_exhausted, in_progress, or rate_limited

---

[API](https://skmtc.dev/bisibility/apis/bisibility-public-api.md) · [All operations](https://skmtc.dev/bisibility/apis/bisibility-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/bisibility/apis/bisibility-public-api/revisions/a6e1ec0dec82?raw)