Checks

Check agent evidence (alias)

Backward-compatible alias for POST /api/v1/check.

No authentication required. Rate limited to 5 requests/minute/IP (D1-backed, shared across isolates). Agent assistants should preserve utm_source, utm_campaign, and product query parameters when calling this endpoint so merchant handoffs can be measured.

post/api/check

Request

  • Base URL: https://agenticcom.ai
  • URL: https://agenticcom.ai/api/check
  • Auth: none declared

Query parameters

utm_sourcestring
Example:agent_cta_openapi

Optional attribution source. Agent-facing surfaces should use an agent_cta_* source.

utm_campaignstring
Example:agent_focused_cta_v2

Optional attribution campaign for daily Check-to-next-action measurement.

productstring
Example:check

Optional product attribution. Use check for public-evidence scans.

Request body

urlstring required

Store URL to check.

Example request

{
  "url": "https://example-store.com"
}

Response

Check completed successfully.

urlstring required
agent_readyboolean required

Stable legacy protocol-evidence flag. It does not mean an AI tool found or recommended a product.

fully_coveredboolean required

Stable legacy protocol-evidence flag. It does not establish AI-engine coverage.

verdict'AGENT-READY' | 'PARTIALLY AGENT-READY' | 'NOT AGENT-READY' required

Colter's stable public-evidence label, not an AI-engine outcome.

recommendationstring required
checked_atstring date-time required
result_idstring uuid
site_typestring
agentic_levelnumber
agentic_level_labelstring
composite_scorenumber

Legacy aggregate public-evidence score, not a placement or recommendation probability.

gradestring
content_hashesobject
cdn_propagation_suspectedboolean
previous_check_atstring date-time
previous_check_minutes_agointeger

Example response

{
  "agent_handoff": {
    "attribution": {
      "utm_source": "agent_cta_check_api",
      "utm_campaign": "agent_focused_cta_v2",
      "product": "check"
    }
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.