---
title: "Resolve a share token"
method: GET
path: "/api/shares/{token}"
tags: ["Results"]
---

# Resolve a share token

`GET /api/shares/{token}`

## Request

- Base URL: `https://agenticcom.ai`
- URL: `https://agenticcom.ai/api/shares/{token}`
- Auth: none declared

Resolve an active share token to its stored result payload.

Public endpoint. Rate limited to 30 requests/minute/IP.

## Path parameters

- `token` string, required

## Response `200`

Share + result payload.

- ResolveShareResponse
  - `share` ShareInfo
    - `token` string
    - `result_id` string, uuid
    - `brand` string, nullable
    - `logo` string, nullable
    - `expires_at` string, date-time
  - `result` CheckResponse
    - `url` string, required
    - `agent_ready` boolean, required: Stable legacy protocol-evidence flag. It does not mean an AI tool found or recommended a product.
    - `fully_covered` boolean, required: Stable legacy protocol-evidence flag. It does not establish AI-engine coverage.
    - `protocols` ProtocolStatus, required
      - `ucp` ProtocolCheck, required
        - `detected` boolean
        - `endpoint` string
        - `version` string
        - `error` string
      - `acp` ProtocolCheck, required
        - `detected` boolean
        - `endpoint` string
        - `version` string
        - `error` string
      - `mcp` ProtocolCheck, required
        - `detected` boolean
        - `endpoint` string
        - `version` string
        - `error` string
      - `webmcp` WebMCPCheck
        - `detected` boolean
    - `store` StoreStatus, required
      - `platform` string
      - `platform_confidence` number
      - `product_count` integer
      - `psp` string
      - `detectable` boolean
      - `vertical` StoreVertical
        - `primary` string
        - `secondary` string
        - `confidence` number
        - `signals` string[]
    - `coverage` CoverageStatus, required
      - `google_ecosystem` boolean: Deprecated compatibility name that mirrors UCP endpoint detection only; not evidence of Google placement or behavior.
      - `openai_ecosystem` boolean: Deprecated compatibility name that mirrors ACP endpoint detection only; not evidence of OpenAI placement or behavior.
    - `web_signals` WebSignals, required
      - `json_ld_found` boolean
      - `json_ld_types` string[]
      - `sitemap_found` boolean
      - `robots_txt_found` boolean
      - `og_tags_found` boolean
      - `webmcp_html_found` boolean
      - `webmcp_html_tools` integer
      - `webmcp_html_tool_names` string[]
      - `webmcp_html_checkout_tools` boolean
      - `webmcp_html_param_desc` boolean
      - `webmcp_html_param_desc_count` integer
      - `webmcp_html_total_fields` integer
      - `webmcp_html_auto_submit` boolean
      - `webmcp_html_auto_submit_count` integer
      - `webmcp_html_avg_desc_len` number
      - `webmcp_html_categories` string[]
      - `markdown_for_agents` boolean
      - `agents_md` boolean
      - `product_count` integer
    - `verdict` 'AGENT-READY' | 'PARTIALLY AGENT-READY' | 'NOT AGENT-READY', required: Colter's stable public-evidence label, not an AI-engine outcome.
    - `interpretation` PublicEvidenceInterpretation, required
      - `basis` 'legacy_protocol_presence', required
      - `limitation` string, required: Explicit boundary for deprecated compatibility labels.
      - `compatibility_fields` string[], required
    - `recommendation` string, required
    - `next_step` NextStep
      - `kind` 'cli'
      - `command` 'colter'
      - `args` string[]
      - `reason` string
    - `plain_language` PlainLanguage, required
      - `merchant` string
      - `agency` string
      - `developer` string
    - `checked_at` string, date-time, required
    - `result_id` string, uuid
    - `google_ucp` GoogleUCPAssessment
      - `generic_ucp_readiness` string
      - `google_ucp_relevance` string
      - `google_native_readiness_state` string
      - `runtime_validation_required` boolean
      - `summary_counts` GoogleUCPSummaryCounts
        - `verified_now` integer
        - `merchant_review_needed` integer
        - `runtime_test_required` integer
        - `fixable_now` integer
        - `not_supported_yet` integer
      - `findings` object
        - `verified_now` GoogleUCPFinding[]
          - `id` string
          - `title` string
          - `importance` string
          - `bucket` string
          - `verification_status` string
          - `status` string
          - `rationale` string
          - `recommended_next_step` string
          - `route_to_product` string
          - `fixable_now` boolean
        - `merchant_review_needed` GoogleUCPFinding[]
          - `id` string
          - `title` string
          - `importance` string
          - `bucket` string
          - `verification_status` string
          - `status` string
          - `rationale` string
          - `recommended_next_step` string
          - `route_to_product` string
          - `fixable_now` boolean
        - `runtime_test_required` GoogleUCPFinding[]
          - `id` string
          - `title` string
          - `importance` string
          - `bucket` string
          - `verification_status` string
          - `status` string
          - `rationale` string
          - `recommended_next_step` string
          - `route_to_product` string
          - `fixable_now` boolean
        - `fixable_now` GoogleUCPFinding[]
          - `id` string
          - `title` string
          - `importance` string
          - `bucket` string
          - `verification_status` string
          - `status` string
          - `rationale` string
          - `recommended_next_step` string
          - `route_to_product` string
          - `fixable_now` boolean
        - `not_supported_yet` GoogleUCPFinding[]
          - `id` string
          - `title` string
          - `importance` string
          - `bucket` string
          - `verification_status` string
          - `status` string
          - `rationale` string
          - `recommended_next_step` string
          - `route_to_product` string
          - `fixable_now` boolean
    - `site_type` string
    - `agentic_level` number
    - `agentic_level_label` string
    - `scores` ScoreBreakdown
      - `discovery` DimensionScore
        - `name` string
        - `score` integer
        - `grade` string
        - `details` string[]
        - `fixes` ScoreFix[]
          - `key` string
          - `description` string
          - `impact` string
          - `score_improvement` integer
          - `tier` string
        - `commentary` string[]
        - `platform_provided` string[]
      - `transaction` DimensionScore
        - `name` string
        - `score` integer
        - `grade` string
        - `details` string[]
        - `fixes` ScoreFix[]
          - `key` string
          - `description` string
          - `impact` string
          - `score_improvement` integer
          - `tier` string
        - `commentary` string[]
        - `platform_provided` string[]
      - `security` DimensionScore
        - `name` string
        - `score` integer
        - `grade` string
        - `details` string[]
        - `fixes` ScoreFix[]
          - `key` string
          - `description` string
          - `impact` string
          - `score_improvement` integer
          - `tier` string
        - `commentary` string[]
        - `platform_provided` string[]
      - `ecosystem` DimensionScore
        - `name` string
        - `score` integer
        - `grade` string
        - `details` string[]
        - `fixes` ScoreFix[]
          - `key` string
          - `description` string
          - `impact` string
          - `score_improvement` integer
          - `tier` string
        - `commentary` string[]
        - `platform_provided` string[]
      - `content_quality` DimensionScore
        - `name` string
        - `score` integer
        - `grade` string
        - `details` string[]
        - `fixes` ScoreFix[]
          - `key` string
          - `description` string
          - `impact` string
          - `score_improvement` integer
          - `tier` string
        - `commentary` string[]
        - `platform_provided` string[]
    - `composite_score` number: Legacy aggregate public-evidence score, not a placement or recommendation probability.
    - `grade` string
    - `content_hashes` object
    - `cdn_propagation_suspected` boolean
    - `previous_check_at` string, date-time
    - `previous_check_minutes_ago` integer
    - `evidence_summary` EvidenceSummary
      - `verified` integer
      - `inferred` integer
      - `runtime_test_required` integer
      - `gaps` integer
      - `top_verified` string[]
      - `top_runtime_required` string[]
      - `note` string
    - `catalog_readiness` CatalogReadiness
      - `status` 'strong' | 'partial' | 'limited'
      - `summary` string
      - `items` CatalogReadinessItem[]
        - `key` string
        - `label` string
        - `status` 'verified' | 'inferred' | 'runtime_test_required' | 'gap' | 'not_checked'
        - `evidence` string
        - `next_step` string
    - `agent_handoff` AgentHandoff
      - `summary` string
      - `risk` string
      - `next_actions` string[]
      - `fix_url` string, uri: Compatibility field containing an attributed Recommendation Audit URL.
      - `lens_url` string, uri: Compatibility field containing an attributed Shopify monitoring-plans URL.
      - `report_url` string, uri: Attributed human-readable result report URL. Use verbatim.
      - `attribution` object
        - `utm_source` string
        - `utm_campaign` string
        - `product` string
        - `check_id` string, uuid
        - `result_id` string, uuid
        - `score` number
    - `usage` CheckUsage
      - `checks_remaining` integer: Remaining checks in the current period; -1 means unmetered.
      - `plan` string
      - `period` string

## Other responses

- `404`: Share not found, expired, or revoked.
- `429`: Rate limit exceeded.

---

[API](https://skmtc.dev/agenticcom/apis/colter-public-api.md) · [All operations](https://skmtc.dev/agenticcom/apis/colter-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/agenticcom/apis/colter-public-api/revisions/c86a6b9228f0?raw)