---
title: "A full citation run finished"
method: POST
path: "run.completed"
---

# A full citation run finished

`POST run.completed` (webhook)

Sent after every weekly and on-demand full citation check (never the daily check, never the trend lane). Carries run status, checked/failed query counts, won/lost query lists, and the site's visibility score current at delivery time (null when unscorable). Retries with exponential backoff up to 8 attempts; respond 2xx to acknowledge. The receiver must be https:// on port 443 — any other port is refused at registration and at delivery.

## Payload

- object
  - `event` 'run.completed'
  - `deliveryId` string
  - `sentAt` string, date-time
  - `site` object
    - `id` string
    - `name` string
    - `domain` string
  - `run` object
    - `id` string
    - `status` 'completed' | 'partial' | 'failed'
    - `queriesChecked` integer
    - `queriesFailed` integer
    - `startedAt` string, date-time
  - `citations` object
    - `won` string[]
    - `lost` string[]
  - `visibilityScore` object, nullable
    - `score` integer
    - `grade` string
    - `modelVersion` integer
    - `thinBasis` object, nullable
      - `questionsNamingYou` integer
      - `threshold` integer
    - `basis` string

## Acknowledgement `200`

Acknowledged.

---

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