---
title: "Retrieve or poll a scan result by share token"
method: GET
path: "/scan/{share_token}"
tags: ["Free Scanner"]
---

# Retrieve or poll a scan result by share token

`GET /scan/{share_token}`

## Request

- Base URL: `https://tlsradar.com/api/v1`
- URL: `https://tlsradar.com/api/v1/scan/{share_token}`
- Auth: none required

Returns a scan result by share token. Use this endpoint to poll for async scan completion - check scan_status field: 'pending' means still scanning, 'success' or 'failed' means done. Results are retained for 1 year. Share tokens are included in scan responses so results can be shared with colleagues.

## Path parameters

- `share_token` string, required

## Response `200`

Scan result (may be pending, success, or failed)

- FreeScanResult
  - `data` object
    - `domain` string: Scanned domain
    - `grade` 'A+' | 'A' | 'B' | 'C' | 'D' | 'F', nullable: Overall SSL/TLS grade (null while pending)
    - `scan_status` 'pending' | 'success' | 'failed': Current scan status. Poll until not 'pending'.
    - `scanned_at` string, date-time
    - `share_token` string: Token for sharing/polling this result
    - `share_url` string, uri: Shareable URL for this result
    - `pdf_url` string, uri, nullable: PDF report download URL (null while pending)
    - `expiration_date` string, date-time, nullable
    - `issues` object[]
      - `severity` 'critical' | 'high' | 'warning' | 'info'
      - `message` string
    - `certificate` object
      - `common_name` string
      - `issuer` string
      - `valid_from` string
      - `valid_until` string
      - `expired` boolean
      - `matches_hostname` boolean
      - `trusted` boolean
      - `subject_alternative_names` string[]
    - `monitor_cta` object: Call-to-action for continuous monitoring signup
      - `message` string
      - `signup_url` string, uri

## Other responses

- `404`: Scan result not found

---

[API](https://skmtc.dev/tlsradar/apis/tls-radar-api.md) · [All operations](https://skmtc.dev/tlsradar/apis/tls-radar-api/llms.txt) · [OpenAPI document](https://skmtc.dev/tlsradar/apis/tls-radar-api/revisions/ecf1eb879b34?raw)