{
  "openapi": "3.0.3",
  "info": {
    "title": "Redirect Trace API",
    "version": "1.0.0",
    "description": "Traces a link in a real Chrome, in a throwaway container, and answers with the whole chain: every redirect and how it was made (HTTP, meta refresh, JavaScript, forms…), where it ended, the destination page, its domain and certificate, safety signals, files and downloads. One synchronous call: it answers as soon as the trace ends, within `timeLimit`."
  },
  "servers": [
    {
      "url": "https://trace.unshortlink.com",
      "description": "The Redirect Trace API"
    }
  ],
  "security": [
    {
      "billingToken": []
    }
  ],
  "paths": {
    "/v1/traces": {
      "post": {
        "operationId": "createTrace",
        "summary": "Trace a link",
        "description": "Traces one link and answers when the trace ends. Counts one trace when it answers `200`.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/TraceRequest"
              },
              "example": {
                "url": "https://bit.ly/3xyz",
                "device": "iphone",
                "timeLimit": 30,
                "idleTime": 10
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The trace",
            "headers": {
              "X-Request-Id": {
                "description": "Nadles' `X-Billing-Request-Id` for this call, sent back for support",
                "schema": {
                  "type": "string"
                },
                "example": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
              },
              "X-Quota": {
                "description": "Added by Nadles on plans with a hard limit: the limit, what is left and when it resets. Nadles' own documentation doesn't mention it; httpstatus.io, which runs on Nadles, documents it",
                "schema": {
                  "type": "string"
                },
                "example": "label=traces; limit-type=hard; quota=2000; remaining=1873; usage=127; call-usage=1; reset=268395"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Trace"
                }
              }
            }
          },
          "400": {
            "description": "`invalid_request`: Malformed JSON, an unknown parameter, or a value out of range; `param` names it",
            "headers": {
              "X-Request-Id": {
                "description": "Nadles' `X-Billing-Request-Id` for this call, sent back for support",
                "schema": {
                  "type": "string"
                },
                "example": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
              },
              "X-Quota": {
                "description": "Added by Nadles on plans with a hard limit: the limit, what is left and when it resets. Nadles' own documentation doesn't mention it; httpstatus.io, which runs on Nadles, documents it",
                "schema": {
                  "type": "string"
                },
                "example": "label=traces; limit-type=hard; quota=2000; remaining=1873; usage=127; call-usage=1; reset=268395"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "invalid_request",
                    "message": "Malformed JSON, an unknown parameter, or a value out of range"
                  }
                }
              }
            }
          },
          "403": {
            "description": "`forbidden_url`: A private, local or reserved address, or a link our abuse rules refuse",
            "headers": {
              "X-Request-Id": {
                "description": "Nadles' `X-Billing-Request-Id` for this call, sent back for support",
                "schema": {
                  "type": "string"
                },
                "example": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
              },
              "X-Quota": {
                "description": "Added by Nadles on plans with a hard limit: the limit, what is left and when it resets. Nadles' own documentation doesn't mention it; httpstatus.io, which runs on Nadles, documents it",
                "schema": {
                  "type": "string"
                },
                "example": "label=traces; limit-type=hard; quota=2000; remaining=1873; usage=127; call-usage=1; reset=268395"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "forbidden_url",
                    "message": "A private, local or reserved address, or a link our abuse rules refuse"
                  }
                }
              }
            }
          },
          "413": {
            "description": "`request_too_large`: A body over 64 KB",
            "headers": {
              "X-Request-Id": {
                "description": "Nadles' `X-Billing-Request-Id` for this call, sent back for support",
                "schema": {
                  "type": "string"
                },
                "example": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
              },
              "X-Quota": {
                "description": "Added by Nadles on plans with a hard limit: the limit, what is left and when it resets. Nadles' own documentation doesn't mention it; httpstatus.io, which runs on Nadles, documents it",
                "schema": {
                  "type": "string"
                },
                "example": "label=traces; limit-type=hard; quota=2000; remaining=1873; usage=127; call-usage=1; reset=268395"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "request_too_large",
                    "message": "A body over 64 KB"
                  }
                }
              }
            }
          },
          "429": {
            "description": "The plan's quota of traces is used up, or its rate limit is exceeded (answered by Nadles' gateway)"
          },
          "500": {
            "description": "`internal_error`: Our fault",
            "headers": {
              "X-Request-Id": {
                "description": "Nadles' `X-Billing-Request-Id` for this call, sent back for support",
                "schema": {
                  "type": "string"
                },
                "example": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
              },
              "X-Quota": {
                "description": "Added by Nadles on plans with a hard limit: the limit, what is left and when it resets. Nadles' own documentation doesn't mention it; httpstatus.io, which runs on Nadles, documents it",
                "schema": {
                  "type": "string"
                },
                "example": "label=traces; limit-type=hard; quota=2000; remaining=1873; usage=127; call-usage=1; reset=268395"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "internal_error",
                    "message": "Our fault"
                  }
                }
              }
            }
          },
          "503": {
            "description": "`busy`: No browser freed up in time to leave the trace 4 seconds of `timeLimit`. Try again; `unavailable`: The API is paused. Try again later",
            "headers": {
              "X-Request-Id": {
                "description": "Nadles' `X-Billing-Request-Id` for this call, sent back for support",
                "schema": {
                  "type": "string"
                },
                "example": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
              },
              "X-Quota": {
                "description": "Added by Nadles on plans with a hard limit: the limit, what is left and when it resets. Nadles' own documentation doesn't mention it; httpstatus.io, which runs on Nadles, documents it",
                "schema": {
                  "type": "string"
                },
                "example": "label=traces; limit-type=hard; quota=2000; remaining=1873; usage=127; call-usage=1; reset=268395"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": {
                    "code": "busy",
                    "message": "No browser freed up in time to leave the trace 4 seconds of `timeLimit`. Try again"
                  }
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "securitySchemes": {
      "billingToken": {
        "type": "apiKey",
        "in": "header",
        "name": "X-Billing-Token",
        "description": "The customer's key, issued by Nadles when they subscribe and managed in Nadles' portal. Nadles checks it and removes it before forwarding the call"
      }
    },
    "schemas": {
      "TraceRequest": {
        "type": "object",
        "properties": {
          "url": {
            "type": "string",
            "maxLength": 8192,
            "description": "The link to trace, `http` or `https`. Without a scheme, `https://` is added. Private, local and reserved addresses are refused with `403 forbidden_url`",
            "example": "https://bit.ly/3xyz"
          },
          "device": {
            "type": "string",
            "description": "What the browser presents itself as. `desktop`: the real desktop Chrome, window 1440×900. `iphone`: 390×844, touch, an iPhone user agent. `android`: 412×915, touch, an Android Chrome user agent. Uses Chrome's own device emulation",
            "enum": [
              "desktop",
              "iphone",
              "android"
            ],
            "example": "iphone",
            "default": "desktop"
          },
          "headers": {
            "type": "object",
            "additionalProperties": {
              "type": "string"
            },
            "maxProperties": 20,
            "description": "Extra headers sent with every request the browser makes, on every site in the chain, so they must not hold secrets. `Referer` is the exception: it must be a full `http` or `https` address, the page the link was on, and it's sent as a click there sends it: with the first request and the server redirects that follow, while each page's own requests and redirects carry that page's address (as an extra header on every request, Chrome would refuse those whose `Referer` its referrer policy wouldn't send). At most 20 headers and 8 KB. `Accept-Language` also sets the browser's own language, so the page's scripts see the same. `Host`, `Cookie`, `Authorization`, `User-Agent`, `Proxy-*`, `Sec-*` and connection headers are refused with `400`",
            "example": {
              "Referer": "https://news.example.com/",
              "Accept-Language": "fr-FR"
            },
            "default": {}
          },
          "maxRedirects": {
            "type": "integer",
            "minimum": 1,
            "maximum": 20,
            "description": "Stops the trace after this many redirects of any kind (HTTP, meta refresh, JavaScript…), counted as in `redirects.total`, with `settled: \"redirect_limit\"`. The answer then ends at the step whose redirect went past the limit, which isn't followed: `end.type` is `redirect`, and `redirects.total` counts that last redirect too. Chrome itself stops after 20 HTTP redirects in a row and reports a loop",
            "example": 10,
            "default": 20
          },
          "timeLimit": {
            "type": "integer",
            "minimum": 5,
            "maximum": 50,
            "description": "The longest the call may take, the wait for a free browser included. It's a ceiling, not a duration: the call answers as soon as the trace ends. When reached: `settled: \"time_limit\"`. If no browser frees up while at least 4 seconds of it remain for the trace, the call answers `503` `busy`",
            "example": 15,
            "default": 50
          },
          "idleTime": {
            "type": "integer",
            "minimum": 3,
            "maximum": 30,
            "description": "How long nothing may change (no redirect, no new page) before the trace ends. Raise it for pages that redirect later without announcing it, such as countdown and interstitial pages: on prod, 16 caught 21 of 24 such links and 30 caught all of them. `timeLimit` still applies",
            "example": 16,
            "default": 3
          },
          "body": {
            "type": "boolean",
            "description": "Adds the body of every page that loaded, up to 200 KB each, in `steps[].body`",
            "example": true,
            "default": false
          }
        },
        "required": [
          "url"
        ],
        "additionalProperties": false,
        "description": "Only `url` is required; every other option has a default. Unknown parameters are refused with `400`, so typos fail loudly instead of being ignored."
      },
      "Trace": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "The trace's id, also used in its file links",
            "example": "tr_8f2c41d07a9b4e36"
          },
          "url": {
            "type": "string",
            "description": "The link as traced, after adding a missing scheme",
            "example": "https://bit.ly/3xyz"
          },
          "startedAt": {
            "type": "string",
            "format": "date-time",
            "description": "When the browser started and ended the trace",
            "example": "2026-11-21T14:03:51.660Z"
          },
          "finishedAt": {
            "type": "string",
            "format": "date-time",
            "description": "When the browser started and ended the trace"
          },
          "durationMs": {
            "type": "integer",
            "description": "From `startedAt` to `finishedAt`",
            "example": 9258
          },
          "redirects": {
            "type": "object",
            "properties": {
              "total": {
                "type": "integer",
                "description": "How many redirects the chain made, counted as the website counts them: HTTP redirects, the pages' own redirects and Chrome's own steps. Not counted: address changes without a page load, Chrome's retries of an address that failed, its https attempt when it fell back to http, and a page's attempt to open an app",
                "example": 2
              },
              "byServer": {
                "type": "integer",
                "description": "The same count by who made each redirect: the server (HTTP 301, 302, 303, 307 or 308), the page itself (meta refresh, Refresh header, JavaScript, a form or a link) or Chrome (HSTS, HTTPS-Upgrades, a client-hints retry)",
                "example": 1
              },
              "byPage": {
                "type": "integer",
                "description": "The same count by who made each redirect: the server (HTTP 301, 302, 303, 307 or 308), the page itself (meta refresh, Refresh header, JavaScript, a form or a link) or Chrome (HSTS, HTTPS-Upgrades, a client-hints retry)",
                "example": 1
              },
              "byChrome": {
                "type": "integer",
                "description": "The same count by who made each redirect: the server (HTTP 301, 302, 303, 307 or 308), the page itself (meta refresh, Refresh header, JavaScript, a form or a link) or Chrome (HSTS, HTTPS-Upgrades, a client-hints retry)",
                "example": 0
              }
            }
          },
          "settled": {
            "type": "string",
            "description": "Which rule ended the trace (section 1)",
            "enum": [
              "stable",
              "time_limit",
              "redirect_limit"
            ],
            "example": "stable"
          },
          "end": {
            "type": "object",
            "properties": {
              "type": {
                "type": "string",
                "description": "What the link ended in: `page`, `download`, `file` (a file shown in the browser, such as a PDF; details in `file`), `app` (an app link), `http_error`, `empty` (204 or 205), `network_error`, `bot_check`, `warning_page` (Chrome's own warning instead of the page), `redirect` (the trace stopped at `maxRedirects`: this step's redirect wasn't followed)",
                "enum": [
                  "page",
                  "download",
                  "file",
                  "app",
                  "http_error",
                  "empty",
                  "network_error",
                  "bot_check",
                  "warning_page",
                  "redirect"
                ],
                "example": "page"
              },
              "step": {
                "type": "integer",
                "nullable": true,
                "description": "The step it ended on",
                "example": 2
              },
              "status": {
                "type": "integer",
                "description": "The HTTP status, for `http_error` and `empty`. Present with those types.",
                "example": 404
              },
              "error": {
                "type": "object",
                "properties": {
                  "kind": {
                    "type": "string",
                    "enum": [
                      "dns",
                      "refused",
                      "reset",
                      "timeout",
                      "unreachable",
                      "certificate",
                      "tls",
                      "loop",
                      "blocked",
                      "policy",
                      "unsafe",
                      "http2",
                      "aborted",
                      "other"
                    ]
                  },
                  "message": {
                    "type": "string",
                    "description": "Chrome's own message, such as `net::ERR_NAME_NOT_RESOLVED`"
                  }
                },
                "required": [
                  "kind",
                  "message"
                ],
                "description": "For `network_error`: `kind` (section 8) and Chrome's message. Present with that type.",
                "example": {
                  "kind": "dns",
                  "message": "net::ERR_NAME_NOT_RESOLVED"
                }
              },
              "deadReason": {
                "type": "string",
                "description": "When the domain no longer resolves, the registry's reason: `not_registered`, `redemption`, `deleting`, `suspended_by_registry`, `suspended_by_registrar`, `no_name_servers`, `expired`, `platform` (an address on a platform such as GitHub Pages that no longer exists), `active` (the registry reports no problem), `unknown`. Present with `dns` errors.",
                "enum": [
                  "not_registered",
                  "redemption",
                  "deleting",
                  "suspended_by_registry",
                  "suspended_by_registrar",
                  "no_name_servers",
                  "expired",
                  "platform",
                  "active",
                  "unknown"
                ],
                "example": "redemption"
              },
              "botCheck": {
                "type": "string",
                "description": "The provider whose check page stopped the browser: `cloudflare`, `vercel`, `aws_waf`, `datadome`, `human`, `imperva`, `sucuri`. Present with `bot_check`.",
                "enum": [
                  "cloudflare",
                  "vercel",
                  "aws_waf",
                  "datadome",
                  "human",
                  "imperva",
                  "sucuri"
                ],
                "example": "cloudflare"
              },
              "warning": {
                "type": "string",
                "description": "Which Chrome warning page; today only `safe_browsing`. What it warns of is in `threat`, and Chrome's own words in `warningText`. Present with `warning_page`.",
                "enum": [
                  "safe_browsing"
                ],
                "example": "safe_browsing"
              },
              "threat": {
                "type": "string",
                "enum": [
                  "phishing",
                  "malware",
                  "unwanted_software",
                  "billing",
                  "unknown"
                ],
                "description": "For `safe_browsing`: what Google Safe Browsing lists the address for: `phishing` (it tries to steal passwords or card numbers), `malware` (it spreads harmful software), `unwanted_software` (it tries to install programs that change how you browse), `billing` (it may charge you money), or `unknown` when Chrome's wording isn't one of these. Present with `warning_page`."
              },
              "warningText": {
                "type": "string",
                "description": "For `safe_browsing`: Chrome's own warning, in English, as it showed it: its title on the first line, then its explanation, without its buttons. Present with `warning_page`."
              },
              "app": {
                "type": "object",
                "properties": {
                  "scheme": {
                    "type": "string"
                  },
                  "name": {
                    "type": "string",
                    "nullable": true
                  },
                  "url": {
                    "type": "string"
                  },
                  "package": {
                    "type": "string"
                  },
                  "appStoreId": {
                    "type": "string"
                  },
                  "fallbackUrl": {
                    "type": "string"
                  }
                },
                "required": [
                  "scheme",
                  "name",
                  "url"
                ],
                "description": "For `app`: `scheme`, the app's `name` when the scheme is one app's (WhatsApp, Telegram, App Store…) or else `null`, the full `url`, and when known the Android `package`, App Store `appStoreId` and Android's `fallbackUrl`. Present with `app`.",
                "example": {
                  "scheme": "tg",
                  "name": "Telegram",
                  "url": "tg://resolve?domain=example"
                }
              },
              "files": {
                "type": "integer",
                "description": "For `download`: how many files the link started, as listed in `downloads`; files refused after the 5th are in `downloadsRefused`. Present with `download`.",
                "example": 1
              }
            }
          },
          "final": {
            "type": "object",
            "properties": {
              "url": {
                "type": "string",
                "description": "The last web page reached (for an app link, the page before the app)",
                "example": "https://shop.example.com/p/42?utm_source=x&amp;tag=aff-21"
              },
              "cleanUrl": {
                "type": "string",
                "description": "The same address without tracking parameters; unchanged when there are none. What was removed is in `safety.removedParams`",
                "example": "https://shop.example.com/p/42"
              },
              "status": {
                "type": "integer",
                "nullable": true,
                "description": "Its HTTP status",
                "example": 200
              },
              "title": {
                "type": "string",
                "nullable": true,
                "description": "Its title",
                "example": "Blue mug, 350 ml"
              },
              "screenshotUrl": {
                "type": "string",
                "nullable": true,
                "description": "Its last screenshot, as a signed link that works for 30 days",
                "example": "https://unshortlink.com/api/v1/files/tr_8f2c/s2.jpg?sig="
              }
            }
          },
          "request": {
            "$ref": "#/components/schemas/TraceRequest"
          },
          "meta": {
            "type": "object",
            "properties": {
              "apiVersion": {
                "type": "string",
                "description": "The API version, and when this answer was produced",
                "example": "1"
              },
              "generatedAt": {
                "type": "string",
                "description": "The API version, and when this answer was produced",
                "example": "2026-11-21T14:04:01.002Z"
              }
            }
          },
          "steps": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "index": {
                  "type": "integer",
                  "description": "Position in the chain, from 0",
                  "example": 1
                },
                "url": {
                  "type": "string",
                  "description": "The step's address",
                  "example": "https://track.example.net/c?id=9"
                },
                "method": {
                  "type": "string",
                  "nullable": true,
                  "description": "`GET`, or `POST` when a form sent it",
                  "example": "GET"
                },
                "startedMs": {
                  "type": "integer",
                  "description": "When the step began, counted from the trace's start",
                  "example": 640
                },
                "status": {
                  "type": "integer",
                  "nullable": true,
                  "description": "The HTTP status; `null` when nothing answered (a failure, an address change without a load)",
                  "example": 302,
                  "default": null
                },
                "statusText": {
                  "type": "string",
                  "description": "The status's text",
                  "example": "Found",
                  "default": ""
                },
                "chrome": {
                  "type": "object",
                  "properties": {
                    "reason": {
                      "type": "string"
                    },
                    "fallback": {
                      "type": "boolean"
                    }
                  },
                  "nullable": true,
                  "description": "Set on Chrome's own steps, where no server answered: the `reason`, such as `HSTS`, `HttpsUpgrades` or a client-hints retry",
                  "example": {
                    "reason": "HSTS"
                  },
                  "default": null
                },
                "redirect": {
                  "type": "object",
                  "properties": {
                    "to": {
                      "type": "string",
                      "description": "The next address. Present when the step redirects.",
                      "example": "https://shop.example.com/p/42"
                    },
                    "mechanism": {
                      "type": "string",
                      "description": "How it redirected: `http`, `meta_refresh`, `refresh_header`, `javascript`, `form_post`, `form_get`, `link`, `history`, `fragment`, `chrome`; rarely `reload` (the page reloaded itself), `navigation` (another navigation the page started) or `blocked` (Chrome's own blocking page). Present when the step redirects.",
                      "enum": [
                        "http",
                        "meta_refresh",
                        "refresh_header",
                        "javascript",
                        "form_post",
                        "form_get",
                        "link",
                        "history",
                        "fragment",
                        "chrome",
                        "reload",
                        "navigation",
                        "blocked"
                      ],
                      "example": "javascript"
                    },
                    "relation": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      },
                      "description": "`same-origin` or `cross-origin`; `same-host` or `cross-host`; `same-site` or `cross-site`; and `http-to-https`, or `https-to-http` for a downgrade. Present when the step redirects.",
                      "example": [
                        "cross-origin",
                        "cross-host",
                        "cross-site"
                      ]
                    },
                    "changes": {
                      "type": "object",
                      "properties": {
                        "scheme": {
                          "type": "boolean"
                        },
                        "host": {
                          "type": "boolean"
                        },
                        "path": {
                          "type": "boolean"
                        },
                        "fragment": {
                          "type": "boolean"
                        },
                        "added": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "name": {
                                "type": "string"
                              },
                              "family": {
                                "type": "string",
                                "description": "What the parameter is for, e.g. `campaign`, `affiliate`, `click_id`",
                                "nullable": true
                              }
                            }
                          }
                        },
                        "removed": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "name": {
                                "type": "string"
                              },
                              "family": {
                                "type": "string",
                                "description": "What the parameter is for, e.g. `campaign`, `affiliate`, `click_id`",
                                "nullable": true
                              }
                            }
                          }
                        },
                        "changed": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "name": {
                                "type": "string"
                              },
                              "family": {
                                "type": "string",
                                "description": "What the parameter is for, e.g. `campaign`, `affiliate`, `click_id`",
                                "nullable": true
                              }
                            }
                          }
                        }
                      },
                      "nullable": true,
                      "description": "What changed in the address: `scheme`, `host`, `path`, `fragment` (true or false), and the query parameters `added`, `removed` and `changed`, each `{name, family}`. Family is `campaign`, `click`, `affiliate`, `referral`, or `null` when it isn't tracking. Present when the step redirects.",
                      "example": {
                        "host": true,
                        "added": [
                          {
                            "name": "utm_source",
                            "family": "campaign"
                          }
                        ]
                      }
                    },
                    "afterMs": {
                      "type": "integer",
                      "nullable": true,
                      "description": "How long the page waited between its answer and the next request. Present when the step redirects.",
                      "example": 1840
                    },
                    "announcedDelayS": {
                      "type": "number",
                      "nullable": true,
                      "description": "The countdown the page announced (meta refresh or Refresh header), as Chrome reported it (a meta refresh a script adds later reports the delay it was added with, often 0); `null` for other mechanisms. Present when the step redirects.",
                      "example": 5,
                      "default": null
                    },
                    "lateMs": {
                      "type": "integer",
                      "nullable": true,
                      "description": "Set when the redirect came after the chain had settled, unannounced: how long after. A countdown the page announced isn't late: the trace waits for it. One that comes later than announced is, such as a meta refresh a script adds after the page has loaded. Present when the step redirects.",
                      "example": 4200,
                      "default": null
                    },
                    "script": {
                      "type": "object",
                      "properties": {
                        "url": {
                          "type": "string"
                        },
                        "line": {
                          "type": "integer",
                          "nullable": true
                        },
                        "column": {
                          "type": "integer",
                          "nullable": true
                        },
                        "function": {
                          "type": "string"
                        }
                      },
                      "nullable": true,
                      "description": "For `javascript`: the script's `url`, `line`, `column` (both counted from 1) and function name. Present when the step redirects.",
                      "example": {
                        "url": "https://track.example.net/r.js",
                        "line": 12,
                        "column": 8
                      },
                      "default": null
                    },
                    "cache": {
                      "type": "object",
                      "properties": {
                        "cached": {
                          "type": "boolean"
                        },
                        "permanent": {
                          "type": "boolean"
                        },
                        "maxAgeS": {
                          "type": "integer",
                          "nullable": true
                        }
                      },
                      "nullable": true,
                      "description": "For HTTP redirects: whether browsers remember it (`cached`), whether it is `permanent` (301 or 308), and `maxAgeS` when the server set one. Present when the step redirects.",
                      "example": {
                        "cached": true,
                        "permanent": true,
                        "maxAgeS": null
                      },
                      "default": null
                    }
                  },
                  "nullable": true,
                  "description": "How this step sent the browser on; `null` on the last step (unless the trace stopped at `maxRedirects`)"
                },
                "server": {
                  "type": "object",
                  "properties": {
                    "ip": {
                      "type": "string",
                      "nullable": true,
                      "description": "The address that answered",
                      "example": "104.18.6.92",
                      "default": null
                    },
                    "port": {
                      "type": "integer",
                      "nullable": true,
                      "description": "Its port",
                      "example": 443,
                      "default": null
                    },
                    "protocol": {
                      "type": "string",
                      "nullable": true,
                      "description": "`http/1.1`, `h2` or `h3`",
                      "example": "h2",
                      "default": null
                    },
                    "country": {
                      "type": "string",
                      "nullable": true,
                      "description": "The address's country code; `null` for CDN edges and clouds, whose addresses don't say where the site is",
                      "example": "DE",
                      "default": null
                    },
                    "asn": {
                      "type": "integer",
                      "nullable": true,
                      "description": "The network the address belongs to",
                      "example": 13335,
                      "default": null
                    },
                    "org": {
                      "type": "string",
                      "nullable": true,
                      "description": "The network the address belongs to",
                      "example": "Cloudflare, Inc."
                    },
                    "network": {
                      "type": "string",
                      "nullable": true,
                      "description": "`cdn` (an edge near the visitor), `cloud`, or `null`",
                      "enum": [
                        "cdn",
                        "cloud",
                        null
                      ],
                      "example": "cdn",
                      "default": null
                    },
                    "cdn": {
                      "type": "string",
                      "nullable": true,
                      "description": "The CDN, host and platform named from the response headers, and the `Server` and `X-Powered-By` headers",
                      "default": null
                    },
                    "hosting": {
                      "type": "string",
                      "nullable": true,
                      "description": "The CDN, host and platform named from the response headers, and the `Server` and `X-Powered-By` headers"
                    },
                    "platform": {
                      "type": "string",
                      "nullable": true,
                      "description": "The CDN, host and platform named from the response headers, and the `Server` and `X-Powered-By` headers"
                    },
                    "software": {
                      "type": "string",
                      "nullable": true,
                      "description": "The CDN, host and platform named from the response headers, and the `Server` and `X-Powered-By` headers"
                    },
                    "poweredBy": {
                      "type": "string",
                      "nullable": true,
                      "description": "The CDN, host and platform named from the response headers, and the `Server` and `X-Powered-By` headers"
                    }
                  }
                },
                "tls": {
                  "type": "object",
                  "properties": {
                    "protocol": {
                      "type": "string",
                      "nullable": true
                    },
                    "cipher": {
                      "type": "string",
                      "nullable": true
                    },
                    "keyExchange": {
                      "type": "string",
                      "nullable": true
                    }
                  },
                  "nullable": true,
                  "description": "The connection's TLS `protocol`, `cipher` and `keyExchange`",
                  "example": {
                    "protocol": "TLS 1.3",
                    "cipher": "AES_128_GCM"
                  },
                  "default": null
                },
                "certificate": {
                  "type": "object",
                  "nullable": true,
                  "properties": {
                    "issuer": {
                      "type": "string",
                      "nullable": true,
                      "description": "Issuer (known names normalised, such as Let's Encrypt) and subject",
                      "example": "Sectigo"
                    },
                    "subject": {
                      "type": "string",
                      "nullable": true,
                      "description": "Issuer (known names normalised, such as Let's Encrypt) and subject"
                    },
                    "altNames": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      },
                      "description": "The names it covers, up to 20",
                      "example": [
                        "shop.example.com",
                        "example.com"
                      ],
                      "default": []
                    },
                    "validFrom": {
                      "type": "string",
                      "description": "Its validity",
                      "example": "2026-03-01T00:00:00Z"
                    },
                    "validTo": {
                      "type": "string",
                      "description": "Its validity"
                    },
                    "daysLeft": {
                      "type": "integer",
                      "description": "Days left, days since issue, and whether it has expired",
                      "example": 102
                    },
                    "ageDays": {
                      "type": "integer",
                      "description": "Days left, days since issue, and whether it has expired",
                      "example": 263
                    },
                    "expired": {
                      "type": "boolean",
                      "description": "Days left, days since issue, and whether it has expired",
                      "example": false
                    },
                    "transparency": {
                      "type": "string",
                      "description": "Chrome's Certificate Transparency check: `compliant`, `not-compliant` or `unknown`",
                      "enum": [
                        "compliant",
                        "not-compliant",
                        "unknown"
                      ],
                      "example": "compliant"
                    }
                  },
                  "description": "The certificate this step's server presented, as Chrome reported it, redirects included; `null` for plain `http` steps, Chrome's own steps and steps nothing answered. Who the issuer verified is known only for the final page (`certificate.validation`, `certificate.owner`)"
                },
                "timing": {
                  "type": "object",
                  "properties": {
                    "dnsMs": {
                      "type": "integer",
                      "nullable": true
                    },
                    "connectMs": {
                      "type": "integer",
                      "nullable": true
                    },
                    "tlsMs": {
                      "type": "integer",
                      "nullable": true
                    },
                    "sendMs": {
                      "type": "integer",
                      "nullable": true
                    },
                    "waitMs": {
                      "type": "integer",
                      "nullable": true
                    },
                    "firstByteMs": {
                      "type": "integer",
                      "nullable": true
                    },
                    "lastByteMs": {
                      "type": "integer",
                      "nullable": true
                    },
                    "reusedConnection": {
                      "type": "boolean"
                    }
                  },
                  "nullable": true,
                  "description": "`dnsMs`, `connectMs`, `tlsMs`, `sendMs`, `waitMs` (the server's time), `firstByteMs`, `lastByteMs`, `reusedConnection`",
                  "example": {
                    "dnsMs": 12,
                    "connectMs": 18,
                    "tlsMs": 25,
                    "waitMs": 61,
                    "firstByteMs": 140,
                    "lastByteMs": 190,
                    "reusedConnection": false
                  },
                  "default": null
                },
                "mime": {
                  "type": "string",
                  "nullable": true,
                  "description": "Content type and size in bytes of the answer",
                  "example": "text/html",
                  "default": null
                },
                "size": {
                  "type": "integer",
                  "nullable": true,
                  "description": "Content type and size in bytes of the answer",
                  "example": 48210
                },
                "title": {
                  "type": "string",
                  "nullable": true,
                  "description": "The page's title, for steps that showed a page",
                  "example": "Redirecting",
                  "default": null
                },
                "screenshotUrl": {
                  "type": "string",
                  "nullable": true,
                  "description": "The page's last screenshot (signed link), for steps that showed a page",
                  "example": "https://unshortlink.com/api/v1/files/tr_8f2c/s1.jpg?sig=",
                  "default": null
                },
                "error": {
                  "type": "object",
                  "properties": {
                    "kind": {
                      "type": "string",
                      "enum": [
                        "dns",
                        "refused",
                        "reset",
                        "timeout",
                        "unreachable",
                        "certificate",
                        "tls",
                        "loop",
                        "blocked",
                        "policy",
                        "unsafe",
                        "http2",
                        "aborted",
                        "other"
                      ]
                    },
                    "message": {
                      "type": "string",
                      "description": "Chrome's own message, such as `net::ERR_NAME_NOT_RESOLVED`"
                    }
                  },
                  "required": [
                    "kind",
                    "message"
                  ],
                  "nullable": true,
                  "description": "For a step that failed: `kind` (section 8) and Chrome's message",
                  "example": {
                    "kind": "timeout",
                    "message": "net::ERR_TIMED_OUT"
                  },
                  "default": null
                },
                "app": {
                  "type": "object",
                  "properties": {
                    "scheme": {
                      "type": "string"
                    },
                    "name": {
                      "type": "string",
                      "nullable": true
                    },
                    "url": {
                      "type": "string"
                    },
                    "package": {
                      "type": "string"
                    },
                    "appStoreId": {
                      "type": "string"
                    },
                    "fallbackUrl": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "scheme",
                    "name",
                    "url"
                  ],
                  "nullable": true,
                  "description": "For an app link: as `end.app` (section 4)",
                  "example": {
                    "scheme": "intent",
                    "name": "WhatsApp",
                    "package": "com.whatsapp"
                  },
                  "default": null
                },
                "signed": {
                  "type": "object",
                  "properties": {
                    "provider": {
                      "type": "string"
                    },
                    "expiresAt": {
                      "type": "string",
                      "format": "date-time",
                      "nullable": true
                    },
                    "expired": {
                      "type": "boolean"
                    }
                  },
                  "nullable": true,
                  "description": "A link signed for a limited time: `provider` (Microsoft, Amazon S3, Amazon CloudFront, Google Cloud Storage, Azure Storage, GitHub, Akamai), `expiresAt`, `expired`",
                  "example": {
                    "provider": "Amazon S3",
                    "expiresAt": "2026-11-21T15:00:00Z",
                    "expired": false
                  },
                  "default": null
                },
                "headers": {
                  "type": "object",
                  "properties": {
                    "request": {
                      "type": "array",
                      "items": {
                        "type": "array",
                        "items": {
                          "type": "string"
                        },
                        "minItems": 2,
                        "maxItems": 2,
                        "description": "[name, value]"
                      }
                    },
                    "response": {
                      "type": "array",
                      "items": {
                        "type": "array",
                        "items": {
                          "type": "string"
                        },
                        "minItems": 2,
                        "maxItems": 2,
                        "description": "[name, value]"
                      }
                    },
                    "postData": {
                      "type": "string",
                      "nullable": true
                    },
                    "curl": {
                      "type": "string",
                      "nullable": true
                    }
                  },
                  "description": "Raw `request` and `response` headers as `[name, value]` pairs, `postData` (first 4 KB) and `curl`, the request as a cURL command",
                  "example": {
                    "response": [
                      [
                        "location",
                        "https://"
                      ]
                    ],
                    "curl": "curl 'https://bit.ly/3xyz' -H "
                  }
                },
                "cookies": {
                  "type": "object",
                  "properties": {
                    "sent": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "name": {
                            "type": "string"
                          },
                          "value": {
                            "type": "string"
                          },
                          "domain": {
                            "type": "string",
                            "nullable": true
                          },
                          "path": {
                            "type": "string",
                            "nullable": true
                          }
                        }
                      }
                    },
                    "set": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "name": {
                            "type": "string"
                          },
                          "value": {
                            "type": "string"
                          },
                          "domain": {
                            "type": "string",
                            "nullable": true
                          },
                          "path": {
                            "type": "string",
                            "nullable": true
                          },
                          "lifetimeS": {
                            "type": "integer",
                            "nullable": true
                          },
                          "secure": {
                            "type": "boolean"
                          },
                          "httpOnly": {
                            "type": "boolean"
                          },
                          "sameSite": {
                            "type": "string",
                            "nullable": true
                          },
                          "deletes": {
                            "type": "boolean"
                          }
                        }
                      }
                    },
                    "blocked": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "name": {
                            "type": "string",
                            "nullable": true
                          },
                          "reason": {
                            "type": "string",
                            "nullable": true
                          }
                        }
                      }
                    }
                  },
                  "description": "`sent` and `set` (`name`, `value`, `domain`, `path`, `lifetimeS` or `null` until the browser closes, `secure`, `httpOnly`, `sameSite`) and `blocked` (with Chrome's reason)",
                  "example": {
                    "set": [
                      {
                        "name": "_aff",
                        "lifetimeS": 2592000,
                        "secure": true
                      }
                    ]
                  }
                },
                "body": {
                  "type": "object",
                  "properties": {
                    "size": {
                      "type": "integer",
                      "nullable": true
                    },
                    "text": {
                      "type": "string",
                      "nullable": true
                    },
                    "truncated": {
                      "type": "boolean"
                    },
                    "binary": {
                      "type": "boolean"
                    }
                  },
                  "description": "With `body: true`: `size`, `text` (up to 200 KB), `truncated`, `binary`. Redirect answers have no body. Present with `body: true`.",
                  "example": {
                    "size": 48210,
                    "truncated": false,
                    "binary": false,
                    "text": "&lt;!doctype html&gt;"
                  }
                }
              }
            }
          },
          "page": {
            "type": "object",
            "properties": {
              "url": {
                "type": "string",
                "nullable": true,
                "description": "The final page's address and title",
                "example": "Blue mug, 350 ml"
              },
              "title": {
                "type": "string",
                "nullable": true,
                "description": "The final page's address and title"
              },
              "description": {
                "type": "string",
                "nullable": true,
                "description": "Its meta description",
                "example": "Hand-made stoneware mug",
                "default": null
              },
              "language": {
                "type": "string",
                "nullable": true,
                "description": "The page's declared language and character set",
                "example": "en",
                "default": null
              },
              "charset": {
                "type": "string",
                "nullable": true,
                "description": "The page's declared language and character set",
                "example": "UTF-8"
              },
              "canonical": {
                "type": "string",
                "nullable": true,
                "description": "Its canonical address and AMP version",
                "example": "https://shop.example.com/p/42",
                "default": null
              },
              "amp": {
                "type": "string",
                "nullable": true,
                "description": "Its canonical address and AMP version"
              },
              "robots": {
                "type": "string",
                "nullable": true,
                "description": "Its robots instructions (meta robots and googlebot)",
                "example": "index, follow",
                "default": null
              },
              "openGraph": {
                "type": "object",
                "additionalProperties": {
                  "type": "string"
                },
                "description": "Its Open Graph and Twitter card tags, by name",
                "default": {}
              },
              "twitter": {
                "type": "object",
                "additionalProperties": {
                  "type": "string"
                },
                "description": "Its Open Graph and Twitter card tags, by name"
              },
              "jsonLd": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "type": {
                      "type": "string",
                      "nullable": true
                    },
                    "name": {
                      "type": "string",
                      "nullable": true
                    }
                  }
                },
                "description": "Its structured data (JSON-LD), up to 12 items: `type` and `name`",
                "example": [
                  {
                    "type": "Product",
                    "name": "Blue mug"
                  }
                ],
                "default": []
              },
              "hreflang": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "lang": {
                      "type": "string",
                      "nullable": true
                    },
                    "href": {
                      "type": "string",
                      "nullable": true
                    }
                  }
                },
                "description": "Language versions (`lang`, `href`), RSS/Atom/JSON feeds, the web app manifest",
                "example": [
                  {
                    "lang": "fr",
                    "href": "https://shop.example.com/fr/p/42"
                  }
                ],
                "default": []
              },
              "feeds": {
                "type": "array",
                "items": {
                  "type": "object"
                },
                "description": "Language versions (`lang`, `href`), RSS/Atom/JSON feeds, the web app manifest",
                "default": []
              },
              "manifest": {
                "type": "string",
                "nullable": true,
                "description": "Language versions (`lang`, `href`), RSS/Atom/JSON feeds, the web app manifest",
                "default": null
              },
              "generator": {
                "type": "string",
                "nullable": true,
                "description": "The page's own meta tags of those names",
                "example": "WordPress 6.8",
                "default": null
              },
              "author": {
                "type": "string",
                "nullable": true,
                "description": "The page's own meta tags of those names"
              },
              "keywords": {
                "type": "string",
                "nullable": true,
                "description": "The page's own meta tags of those names"
              },
              "themeColor": {
                "type": "string",
                "nullable": true,
                "description": "The page's own meta tags of those names"
              },
              "appStore": {
                "type": "object",
                "properties": {
                  "apple": {
                    "type": "string"
                  },
                  "googlePlay": {
                    "type": "string"
                  },
                  "appLinks": {
                    "type": "object"
                  },
                  "alternates": {
                    "type": "array",
                    "items": {
                      "type": "object"
                    }
                  }
                },
                "description": "App-store tags: `apple` (apple-itunes-app), `googlePlay`, `appLinks` (al:*), and android-app:/ios-app: alternates",
                "example": {
                  "apple": "app-id=284882215"
                },
                "default": {}
              },
              "technology": {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "description": "Site technology and trackers found in its code: WordPress, Shopify, Wix, Squarespace, Webflow, Next.js, Nuxt, Gatsby, Drupal, Tilda, Framer, GoDaddy Website Builder, HubSpot, Cloudflare Web Analytics, Google Tag Manager, Google Analytics, Meta Pixel, Microsoft Clarity, Hotjar",
                "example": [
                  "Shopify",
                  "Google Analytics",
                  "Meta Pixel"
                ],
                "default": []
              },
              "counts": {
                "type": "object",
                "properties": {
                  "links": {
                    "type": "integer",
                    "nullable": true
                  },
                  "forms": {
                    "type": "integer",
                    "nullable": true
                  },
                  "frames": {
                    "type": "integer",
                    "nullable": true
                  },
                  "passwordFields": {
                    "type": "integer",
                    "nullable": true
                  },
                  "passwordFieldsInCode": {
                    "type": "integer",
                    "nullable": true
                  }
                },
                "description": "`links`, `forms`, `frames`, `passwordFields` (ones a person can actually see) and `passwordFieldsInCode` (all, hidden ones included)",
                "example": {
                  "links": 84,
                  "forms": 2,
                  "frames": 1,
                  "passwordFields": 1,
                  "passwordFieldsInCode": 1
                }
              },
              "cookieBanner": {
                "type": "object",
                "properties": {
                  "covers": {
                    "type": "number",
                    "minimum": 0,
                    "maximum": 1
                  }
                },
                "nullable": true,
                "description": "A cookie or consent banner over the page on its last screenshot: `covers`, the share of the window it hides (0 to 1). `null` when none covers 3% or more",
                "example": {
                  "covers": 0.31
                },
                "default": null
              },
              "textSample": {
                "type": "string",
                "description": "The first 600 characters of the page's visible text",
                "example": "Blue mug, 350 ml €18.00 Add to cart",
                "default": ""
              },
              "scripts": {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "description": "Addresses of its scripts (up to 40) and frames (up to 20)",
                "example": [
                  "https://cdn.shopify.com/s/files//theme.js"
                ],
                "default": []
              },
              "frames": {
                "type": "array",
                "items": {
                  "type": "object"
                },
                "description": "Addresses of its scripts (up to 40) and frames (up to 20)"
              },
              "faviconUrl": {
                "type": "string",
                "nullable": true,
                "description": "Its icon and preview image (og:image), fetched by our browser and served from our server as signed links, so the customer never contacts the site",
                "example": "https://unshortlink.com/api/v1/files/tr_8f2c/icon.png?sig=",
                "default": null
              },
              "previewImageUrl": {
                "type": "string",
                "nullable": true,
                "description": "Its icon and preview image (og:image), fetched by our browser and served from our server as signed links, so the customer never contacts the site"
              }
            },
            "nullable": true,
            "description": "`null` when the link ended without a web page"
          },
          "domains": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "domain": {
                  "type": "string",
                  "description": "One registrable domain of the chain, in order of first appearance",
                  "example": "example.net"
                },
                "steps": {
                  "type": "array",
                  "items": {
                    "type": "integer"
                  },
                  "description": "The steps on this domain",
                  "example": [
                    1
                  ]
                },
                "registered": {
                  "type": "string",
                  "nullable": true,
                  "description": "Registration and expiry dates, from the registry",
                  "example": "2026-11-02",
                  "default": null
                },
                "expires": {
                  "type": "string",
                  "nullable": true,
                  "description": "Registration and expiry dates, from the registry",
                  "example": "2027-11-02"
                },
                "ageDays": {
                  "type": "integer",
                  "nullable": true,
                  "description": "Days since registration",
                  "example": 19,
                  "default": null
                },
                "registrar": {
                  "type": "string",
                  "nullable": true,
                  "description": "The registrar",
                  "example": "NameCheap, Inc.",
                  "default": null
                },
                "status": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  },
                  "description": "The registry's statuses, as written (`client hold`, `redemption period`…)",
                  "example": [
                    "client transfer prohibited"
                  ],
                  "default": []
                },
                "source": {
                  "type": "string",
                  "description": "`rdap`, or `whois` for registries without RDAP (.io, .co, .dz…). Answers are kept for a day",
                  "enum": [
                    "rdap",
                    "whois"
                  ],
                  "example": "rdap"
                },
                "unknown": {
                  "type": "string",
                  "nullable": true,
                  "description": "Why nothing could be read, when the registry gave nothing usable (for example `not-found`)",
                  "example": null,
                  "default": null
                }
              }
            }
          },
          "certificate": {
            "type": "object",
            "properties": {
              "step": {
                "type": "integer",
                "description": "The step whose certificate this is: the final page's. Only the final page's certificate says who the issuer verified (`validation`, `owner`); each step's own is in `steps[].certificate`",
                "example": 2
              },
              "validation": {
                "type": "string",
                "nullable": true,
                "description": "What the issuer checked: `domain`, `organization`, `extended` or `individual`",
                "enum": [
                  "domain",
                  "organization",
                  "extended",
                  "individual",
                  null
                ],
                "example": "organization",
                "default": null
              },
              "owner": {
                "type": "object",
                "properties": {
                  "organization": {
                    "type": "string",
                    "nullable": true
                  },
                  "country": {
                    "type": "string",
                    "nullable": true
                  }
                },
                "nullable": true,
                "description": "The company the issuer verified, `organization` and `country`; only on organization and extended certificates",
                "example": {
                  "organization": "Example Shop Ltd",
                  "country": "GB"
                },
                "default": null
              },
              "issuer": {
                "type": "string",
                "nullable": true,
                "description": "Issuer (known names normalised, such as Let's Encrypt) and subject",
                "example": "Sectigo"
              },
              "subject": {
                "type": "string",
                "nullable": true,
                "description": "Issuer (known names normalised, such as Let's Encrypt) and subject"
              },
              "altNames": {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "description": "The names it covers, up to 20",
                "example": [
                  "shop.example.com",
                  "example.com"
                ],
                "default": []
              },
              "validFrom": {
                "type": "string",
                "description": "Its validity",
                "example": "2026-03-01T00:00:00Z"
              },
              "validTo": {
                "type": "string",
                "description": "Its validity"
              },
              "daysLeft": {
                "type": "integer",
                "description": "Days left, days since issue, and whether it has expired",
                "example": 102
              },
              "ageDays": {
                "type": "integer",
                "description": "Days left, days since issue, and whether it has expired",
                "example": 263
              },
              "expired": {
                "type": "boolean",
                "description": "Days left, days since issue, and whether it has expired",
                "example": false
              },
              "protocol": {
                "type": "string",
                "description": "The connection that carried it",
                "example": "TLS 1.3"
              },
              "cipher": {
                "type": "string",
                "description": "The connection that carried it"
              },
              "keyExchange": {
                "type": "string",
                "description": "The connection that carried it"
              },
              "transparency": {
                "type": "string",
                "description": "Chrome's Certificate Transparency check: `compliant`, `not-compliant` or `unknown`",
                "enum": [
                  "compliant",
                  "not-compliant",
                  "unknown"
                ],
                "example": "compliant"
              }
            },
            "nullable": true,
            "description": "`null` without a secure final page"
          },
          "safety": {
            "type": "object",
            "properties": {
              "safeBrowsing": {
                "type": "string",
                "description": "`clean`; `dangerous` when Chrome showed its Safe Browsing warning; `unavailable` when the lists could not be loaded in time",
                "enum": [
                  "clean",
                  "dangerous",
                  "unavailable"
                ],
                "example": "clean"
              },
              "verdict": {
                "type": "string",
                "description": "One sentence in English summing up where the link goes",
                "example": "Goes to shop.example.com through 2 redirects."
              },
              "route": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "host": {
                      "type": "string"
                    },
                    "steps": {
                      "type": "array",
                      "items": {
                        "type": "integer"
                      }
                    },
                    "waitedMs": {
                      "type": "integer"
                    }
                  }
                },
                "description": "Who the chain went through, consecutive steps of one host merged: `host`, `steps`, and `waitedMs` when the page waited before moving on",
                "example": [
                  {
                    "host": "bit.ly",
                    "steps": [
                      0
                    ]
                  },
                  {
                    "host": "track.example.net",
                    "steps": [
                      1
                    ],
                    "waitedMs": 1840
                  }
                ]
              },
              "signals": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "level": {
                      "type": "string",
                      "description": "`danger`, `warn`, `ok` or `info`",
                      "enum": [
                        "danger",
                        "warn",
                        "ok",
                        "info"
                      ],
                      "example": "danger"
                    },
                    "code": {
                      "type": "string",
                      "description": "`safe_browsing`, `risky_file`, `hash_mismatch`, `domain_age` (danger under 30 days, warn under 180, ok above), `domain_age_unknown`, `password_field`, `plain_http`, `certificate` (warn under 7 days left), `certificate_expired`, `verified_company`, `bot_check`, `signed_link_expiry`, `app_link`, `server_location`, `cdn_edge`, `cloud`, `tracking_params`, `cookies`, `cookie_banner`",
                      "enum": [
                        "safe_browsing",
                        "risky_file",
                        "hash_mismatch",
                        "domain_age",
                        "domain_age_unknown",
                        "password_field",
                        "plain_http",
                        "certificate",
                        "certificate_expired",
                        "verified_company",
                        "bot_check",
                        "signed_link_expiry",
                        "app_link",
                        "server_location",
                        "cdn_edge",
                        "cloud",
                        "tracking_params",
                        "cookies",
                        "cookie_banner",
                        "other"
                      ],
                      "example": "domain_age"
                    },
                    "text": {
                      "type": "string",
                      "description": "The signal in an English sentence, and its supporting facts",
                      "example": "example.net was registered 19 days ago"
                    },
                    "detail": {
                      "type": "string",
                      "description": "The signal in an English sentence, and its supporting facts"
                    }
                  }
                }
              },
              "removedParams": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "name": {
                      "type": "string"
                    },
                    "family": {
                      "type": "string",
                      "description": "What the parameter is for, e.g. `campaign`, `affiliate`, `click_id`",
                      "nullable": true
                    }
                  }
                },
                "description": "Tracking parameters removed to make `final.cleanUrl`: `name` and `family` (`campaign`, `click`, `affiliate`, `referral`)",
                "example": [
                  {
                    "name": "utm_source",
                    "family": "campaign"
                  },
                  {
                    "name": "tag",
                    "family": "affiliate"
                  }
                ],
                "default": []
              }
            }
          },
          "file": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "nullable": true,
                "description": "A file the browser showed itself (a PDF, an image, a video): its name, from its address, and its size in bytes. Present with `file`.",
                "example": "invoice-1042.pdf"
              },
              "size": {
                "type": "integer",
                "nullable": true,
                "description": "A file the browser showed itself (a PDF, an image, a video): its name, from its address, and its size in bytes. Present with `file`.",
                "example": 284113
              },
              "sha256": {
                "type": "string",
                "nullable": true,
                "description": "Its fingerprints, from the bytes Chrome received. `null` when Chrome kept no copy of them (a video it streamed, a very large file), or when its PDF viewer kept them and reading the file again failed or passed 100 MB. Present with `file`.",
                "example": "3a7bd3e2360a3d29",
                "default": null
              },
              "md5": {
                "type": "string",
                "nullable": true,
                "description": "Its fingerprints, from the bytes Chrome received. `null` when Chrome kept no copy of them (a video it streamed, a very large file), or when its PDF viewer kept them and reading the file again failed or passed 100 MB. Present with `file`."
              },
              "type": {
                "type": "object",
                "properties": {
                  "kind": {
                    "type": "string",
                    "description": "What the bytes are, e.g. `pdf`, `zip`, `windows-program`, `image`"
                  },
                  "mime": {
                    "type": "string"
                  },
                  "risky": {
                    "type": "boolean",
                    "description": "A program, script or archive that can run code"
                  }
                },
                "nullable": true,
                "description": "What the file really is from its first bytes, as `downloads[].type`; `null` without its bytes. Present with `file`.",
                "example": {
                  "kind": "pdf",
                  "mime": "application/pdf",
                  "risky": false
                },
                "default": null
              },
              "stated": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "source": {
                      "type": "string",
                      "enum": [
                        "server",
                        "github",
                        "checksum_file"
                      ]
                    },
                    "url": {
                      "type": "string",
                      "description": "The checksum file, for `checksum_file`"
                    },
                    "algorithm": {
                      "type": "string",
                      "enum": [
                        "sha256",
                        "md5"
                      ]
                    },
                    "value": {
                      "type": "string"
                    },
                    "matches": {
                      "type": "boolean",
                      "description": "`null` when the file is unfinished or the algorithm can't be checked",
                      "nullable": true
                    }
                  }
                },
                "description": "Fingerprints the server states in its headers (source `server`), each checked against the file's own, as in `downloads[].stated`. Present with `file`.",
                "example": [
                  {
                    "source": "server",
                    "algorithm": "md5",
                    "matches": true
                  }
                ],
                "default": []
              },
              "virusTotal": {
                "type": "string",
                "nullable": true,
                "description": "VirusTotal's page for its SHA-256, or for the server's stated fingerprint when there are no bytes. Present with `file`.",
                "example": "https://www.virustotal.com/gui/file/3a7bd3",
                "default": null
              }
            }
          },
          "downloads": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "step": {
                  "type": "integer",
                  "description": "The step that started the file. Present when files started.",
                  "example": 3
                },
                "url": {
                  "type": "string",
                  "description": "The file's address after every redirect, and its name. Present when files started.",
                  "example": "setup.exe"
                },
                "filename": {
                  "type": "string",
                  "nullable": true,
                  "description": "The file's address after every redirect, and its name. Present when files started."
                },
                "builtByPage": {
                  "type": "boolean",
                  "description": "The page made the file itself (blob: or data:). Present when files started.",
                  "example": false,
                  "default": false
                },
                "size": {
                  "type": "integer",
                  "nullable": true,
                  "description": "Its full size in bytes, as the server or Chrome states it, also when the file was stopped; `null` when unknown. Present when files started.",
                  "example": 5242880,
                  "default": null
                },
                "receivedBytes": {
                  "type": "integer",
                  "description": "How much of it arrived: all of it when complete, the bytes so far when unfinished or stopped. Present when files started.",
                  "example": 5242880
                },
                "state": {
                  "type": "string",
                  "description": "`complete`: saved in the throwaway container and fingerprinted; it is never opened, and it is deleted with the container. `unfinished`: still arriving when the trace ended, which doesn't hold the answer; no fingerprints, and `receivedBytes` says how much had arrived. `stopped`: stopped by our limits (see `stopped`). `failed`: the server, the connection or the page ended it early. Present when files started.",
                  "enum": [
                    "complete",
                    "unfinished",
                    "stopped",
                    "failed"
                  ],
                  "example": "complete"
                },
                "stopped": {
                  "type": "string",
                  "nullable": true,
                  "description": "Why it was stopped, when `state` is `stopped`: `too_large` (over 100 MB) or `total_limit` (250 MB per trace). Files after the 5th are counted in `downloadsRefused` instead. Present when files started.",
                  "enum": [
                    "too_large",
                    "total_limit",
                    null
                  ],
                  "example": null,
                  "default": null
                },
                "sha256": {
                  "type": "string",
                  "nullable": true,
                  "description": "The file's own fingerprints, when its `state` is `complete`. Present when files started.",
                  "example": "9f86d081884c7d65",
                  "default": null
                },
                "md5": {
                  "type": "string",
                  "nullable": true,
                  "description": "The file's own fingerprints, when its `state` is `complete`. Present when files started."
                },
                "type": {
                  "type": "object",
                  "properties": {
                    "kind": {
                      "type": "string",
                      "description": "What the bytes are, e.g. `pdf`, `zip`, `windows-program`, `image`"
                    },
                    "mime": {
                      "type": "string"
                    },
                    "risky": {
                      "type": "boolean",
                      "description": "A program, script or archive that can run code"
                    }
                  },
                  "nullable": true,
                  "description": "What the file really is from its first bytes, whatever the server called it: `kind`, `mime`, and `risky` (programs, scripts, installers, archives that can hide them). Present when files started.",
                  "example": {
                    "kind": "exe",
                    "mime": "application/x-msdownload",
                    "risky": true
                  }
                },
                "stated": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "source": {
                        "type": "string",
                        "enum": [
                          "server",
                          "github",
                          "checksum_file"
                        ]
                      },
                      "url": {
                        "type": "string",
                        "description": "The checksum file, for `checksum_file`"
                      },
                      "algorithm": {
                        "type": "string",
                        "enum": [
                          "sha256",
                          "md5"
                        ]
                      },
                      "value": {
                        "type": "string"
                      },
                      "matches": {
                        "type": "boolean",
                        "description": "`null` when the file is unfinished or the algorithm can't be checked",
                        "nullable": true
                      }
                    }
                  },
                  "description": "Fingerprints others state: `source` (`server` headers, `github` release data, or the publisher's `checksum_file` with its `url`), `algorithm`, `value`, and `matches` (true, false, or `null` when the file wasn't saved). Present when files started.",
                  "example": [
                    {
                      "source": "checksum_file",
                      "algorithm": "sha256",
                      "matches": true
                    }
                  ],
                  "default": []
                },
                "virusTotal": {
                  "type": "string",
                  "nullable": true,
                  "description": "VirusTotal's page for the file's SHA-256, or for a fingerprint stated for it when the file isn't complete. Present when a fingerprint is known.",
                  "example": "https://www.virustotal.com/gui/file/9f86d0"
                }
              }
            }
          },
          "lookups": {
            "type": "object",
            "properties": {
              "virusTotal": {
                "type": "string",
                "description": "Links to those services' pages about the final domain (or address, or IP when it has no name). Links only: nothing is sent to them",
                "example": "https://www.virustotal.com/gui/domain/example.com"
              },
              "urlscan": {
                "type": "string",
                "description": "Links to those services' pages about the final domain (or address, or IP when it has no name). Links only: nothing is sent to them"
              },
              "wayback": {
                "type": "string",
                "description": "Links to those services' pages about the final domain (or address, or IP when it has no name). Links only: nothing is sent to them"
              }
            },
            "nullable": true,
            "description": "`null` for a page at a path of a platform's own address (a Google Form): those services would judge the platform"
          },
          "downloadsRefused": {
            "type": "integer",
            "description": "Files the link started after the first 5: stopped before they began, so they are counted here, not listed in `downloads`",
            "example": 1,
            "default": 0
          },
          "report": {
            "type": "object",
            "properties": {
              "keptUntil": {
                "type": "string",
                "description": "When the result, screenshots and files' records are deleted (30 days), unless deleted earlier",
                "example": "2026-12-21T14:04:01Z"
              }
            }
          }
        },
        "required": [
          "id",
          "url",
          "startedAt",
          "finishedAt",
          "durationMs",
          "redirects",
          "settled",
          "end",
          "final",
          "request",
          "meta",
          "steps",
          "page",
          "domains",
          "certificate",
          "safety",
          "lookups",
          "downloadsRefused",
          "report",
          "downloads"
        ],
        "description": "One trace: the chain of steps, where it ended, the destination, safety, files and links."
      },
      "Error": {
        "type": "object",
        "properties": {
          "error": {
            "type": "object",
            "properties": {
              "code": {
                "type": "string",
                "enum": [
                  "invalid_request",
                  "forbidden_url",
                  "request_too_large",
                  "internal_error",
                  "busy",
                  "unavailable"
                ]
              },
              "message": {
                "type": "string",
                "description": "One sentence for a person"
              },
              "param": {
                "type": "string",
                "description": "The parameter at fault, for `invalid_request`"
              }
            },
            "required": [
              "code",
              "message"
            ]
          }
        },
        "required": [
          "error"
        ]
      }
    }
  }
}
