---
title: "Anonymous placement check"
method: POST
path: "/free/check"
---

# Anonymous placement check

`POST /free/check`

## Request

- Base URL: `https://app.agentlinkops.com`
- URL: `https://app.agentlinkops.com/free/check`
- Auth: none required

## Request body

- object
  - `sourceUrl` string, required: Public publisher URL with the placement.
  - `targetUrl` string, required: Expected public destination URL.
  - `scope` 'exact' | 'domain' | 'subdomain' | 'path': URL matching rule: exact URL, domain, subdomain, or path prefix.

## Response `200`

Public result; inspect state because success does not establish link presence.

- object
  - `state` 'success' | 'valid-negative' | 'unknown' | 'failed', required: Saved lifecycle or evidence state, as enumerated for this record.
  - `reason` string, required: Recorded explanation; null when no explanation applies.
  - `requested_url` string, nullable, required
  - `inspected_url` string, nullable, required
  - `target_url` string, nullable, required: Destination URL recorded in this evidence.
  - `scope` string, required
  - `checked_at` string, required: UTC timestamp of the saved check.
  - `complete` boolean, required
  - `occurrences` object[], required
    - `targetUrl` string, required
    - `anchor` string, required
    - `rel` string[], required
  - `checker_version` string, nullable, required
  - `uncertainty` string[], required
  - `failure` 'invalid_input' | 'budget' | 'cooling' | 'service'
  - `retry_at` string
  - `retry_after_seconds` number
  - `result_id` string
  - `permalink` string, nullable
  - `cached` boolean

## Other responses

- `422`: Invalid placement input returned as a failed public result.
- `429`: Request-rate or usage refusal. Inspect error.code and recovery details before retrying.
- `503`: Unavailable check service: public failed result or Worker error envelope.
- `default`: Error envelope. Non-configuration 5xx messages are masked and details omitted; allowlisted configuration errors retain static operator recovery.

---

[API](https://skmtc.dev/agentlinkops/apis/agentlinkops-http-api.md) · [All operations](https://skmtc.dev/agentlinkops/apis/agentlinkops-http-api/llms.txt) · [OpenAPI document](https://skmtc.dev/agentlinkops/apis/agentlinkops-http-api/revisions/2a712a1dcfa7?raw)