API reference

Register a site

Register a site so you can verify ownership and enable recurring monitoring. The response includes a verification token to add to DNS or the site's HTML.

POST/v1/sites

Request body

Field	Type	Status	Description
root_url	string	required	The site's root URL, e.g. https://www.example-clinic.com.
display_name	string	optional	A label for dashboards and reports. Defaults to the hostname.

Response

Field	Type	Description
id	string	Site id, used by verify / findings / history endpoints.
verification_status	string	unverified · pending · verified.
verification_token	string	Add as sift-site-verification=… in DNS TXT or a meta tag.

json

{
  "id": "site_a1b2",
  "root_url": "https://www.example-clinic.com",
  "display_name": "Example Clinic",
  "verification_status": "unverified",
  "verification_token": "abc123def456ghi789"
}

Examples

curl -s https://api.sifthealth.app/v1/sites \
  -H "Authorization: Bearer $SIFT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"root_url": "https://www.example-clinic.com", "display_name": "Example Clinic"}'

Next step

Hand the verification_token to whoever controls the domain, then call POST /v1/sites/{id}/verify once the record is live.

Verify a site

Confirm ownership.

Domain verification

The DNS / meta-tag guide.

Consultant onboarding

Bulk-register client sites.

Monitoring

Turn on recurring rescans.