About Services Tools Blog Contact us

Jurisdiction Disclosure Gate

A country check that withholds sensitive financial documents from visitors treated as being in a restricted country. It is as accurate as the available data allows.

  • Web Tools
  • Mining and exploration
  • Tool
  • Productised
  • Hybrid
  • 2026

The problem

Some financing disclosures must not be sent into a restricted jurisdiction. A disclaimer on the page is a weak control if the file still downloads. So the file itself has to be held back.

What it does

The check reads the visitor's country from Cloudflare first, then falls back to an ip-api lookup that is remembered for that visit. On the live site, an unknown country is treated as restricted. Pages use the yes or no result to hide or refuse restricted PDFs, as a technical control alongside the legal wording.

Outcomes

  • Restricted documents stay hidden from visitors treated as being in a restricted country.
  • An unknown country is blocked on the live site.
  • The article page and the PDF download use the same result.

Simplified mockup

Interactive preview with sample data. Nothing is sent to a server.

Disclosure desk

Withhold
Article page · Greybirch Exploration
Financing update, March 2026
Gated PDF · financing-march.pdf
Withheld

This document is not offered for download. The article and the file stream read the same flag.

Site photograph set
February 2026 · always public
Operations note
Q1 2026 · always public
How this visitor was resolved
HeaderCDN country header present
CacheSession cache not used
ModeLive site
FlagWithhold
StreamFinancing PDF refused

Decision matrix

Financing PDF
Visitor countryLive siteLocal preview
Home country Allow Allow
Restricted jurisdiction Withhold Withhold
Unknown Withhold fail closed Allow fail open
Shared flag

The article hides the download control. The PDF stream refuses the same request. A legend on the page is not the control.

Best effort

The header is read first. A short lookup is cached in the session for one hour. An unknown country withholds the file on the live site only.

Request trace

Sample · 203.0.113.44
RequestGET /files/financing-march.pdf
HeaderAbsent
LookupNo country returned
CacheUnknown, 60 minutes
EnvironmentLive site
Resolve
  1. Read the header
  2. Look up the address
  3. Cache the miss
  4. Fail closed
  5. Refuse the file
Unknown country on the live site

How it works

  1. Read the country that Cloudflare supplies when one is present.
  2. Otherwise look up the visitor's address with ip-api and remember the country for that visit.
  3. Treat an unknown country as restricted on the live site.
  4. Return a yes or no result that both the page and the file download check.
  5. Hide or refuse the restricted download when the result says so.

Pipeline

flowchart LR
  A[Request] --> B[Country header]
  B --> C[Cached lookup]
  C --> D{Restricted or unknown}
  D -->|Yes| E[Hide download]
  D -->|No| F[Allow download]