---
title: "Start Monitoring Domain"
method: POST
path: "/api/v1/monitoring/start"
tags: ["Monitoring Domains"]
---

# Start Monitoring Domain

`POST /api/v1/monitoring/start`

Start monitoring a domain.
This endpoint requires a valid API key (X-API-KEY) to be  provided in the headers and is rate limited to 5 requests
per second.

## Request body

- StartInput
  - `domain` string, required
  - `external_ref_id` string
  - `packages` PackageInput[]
    - `type` 'io.truebiz.monitoring.package.basic' | 'io.truebiz.monitoring.package.extended', required
    - `frequency` PackageFrequency
      - `days` 7 | 30 | 90, required — An enumeration.

## Response `200`

OK

- MonitoredDomain
  - `domain` string, required
  - `external_ref_id` string
  - `packages` MonitoringPackage[]
    - `type` 'io.truebiz.monitoring.package.basic' | 'io.truebiz.monitoring.package.extended' | 'io.truebiz.monitoring.package.website-content' | 'io.truebiz.monitoring.package.business-closure' | 'io.truebiz.monitoring.package.sentiment-analysis' | 'io.truebiz.monitoring.package.connected-entities' | 'io.truebiz.monitoring.package.people' | 'io.truebiz.monitoring.package.business-profile', required — An enumeration.
    - `frequency` PackageFrequency, required
      - `days` 7 | 30 | 90, required — An enumeration.

## Other responses

- `202` — Accepted
- `204` — No Content
- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `409` — Conflict
- `422` — Unprocessable Entity
- `429` — Too Many Requests
- `500` — Internal Server Error

---

[API](https://skmtc.net/truebiz/apis/truebiz-web-presence-review-api.md) · [All operations](https://skmtc.net/truebiz/apis/truebiz-web-presence-review-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/truebiz/truebiz-web-presence-review-api/revisions/22a9a6d3740a/schema)
