resources/geoprimitives/POST /v1/geometry/difference
POSTorigin reachablediscovery only

geoprimitives /v1/geometry/difference APIPOST /v1/geometry/difference · x402 API by geoprimitives

Cut holes out of a polygon: the buildable part of a parcel once setbacks are removed, the land outside a protected area, the part of a route not already covered. Order is significant, so this is the one overlay op where swapping the operands gives a different answer. Subtracting everything answers geojson:null with empty:true, a real answer rather than an error. Send a FeatureCollection of Polygons or MultiPolygons; the first member in document order has every later member subtracted from it. The answer is a single Feature, or null with empty:true when nothing survives. Clipping is planar in longitude/latitude, so edges are straight in degrees rather than geodesics. The 2000-position cap is CPU rather than bandwidth: the sweep-line overlay is quadratic on self-intersecting input. Input is

https://api.geoprimitives.dev/v1/geometry/difference

What does this x402 API do?

geoprimitives /v1/geometry/difference API. This is an x402-gated POST API resource from geoprimitives. TOLL·402 did not invoke this route automatically because doing so was not considered safe. No normalized USD price is recorded; the listing names Base. No settled paid call has been verified.

Published price
No normalized USD price is recorded
Networks
Base
Latest evidence
TOLL·402 did not invoke this route automatically because doing so was not considered safe
Resource ID
4e159a65b99f375e442a455d
USE THIS RESOURCE

Start with a quote-only recipe. Payment signing stays in your project.

CODE
AI CODING TOOLS
quote-check.ts
const response = await fetch("https://api.geoprimitives.dev/v1/geometry/difference", {
  method: "POST",
  headers: { "content-type": "application/json" },
  body: JSON.stringify({
  "type": "http",
  "method": "POST",
  "bodyType": "json",
  "bodyFieldNames": [
    "geojson"
  ],
  "pathParamNames": [],
  "queryParamNames": []
}),
});

console.log(response.status);
console.log(Object.fromEntries(response.headers));
console.log((await response.text()).slice(0, 1000));

// A valid 402 is a quote, not a completed paid call.

Review the provider input schema before running this non-read-only method. No payment code is included.

STATUS HISTORY

  1. Exact route checked

    not safely testable · potentially-mutating-method:POST

  2. Origin reachable

    HEAD https://api.geoprimitives.dev/ returned 200.

  3. Observed in cdp-bazaar

    The registry record was observed and retained with provenance.

What evidence supports this listing?

cdp-bazaarobserved 2026-08-25 · open source record ↗
origin checkHEAD https://api.geoprimitives.dev/ → 200 on 2026-08-25
route quotenot invoked automatically · potentially-mutating-method:POST · 2026-08-25

Each record has an exact-route quote outcome. Unresolved templates and potentially mutating methods are labeled instead of being invoked without provider-specific test input. A quote is still separate from a settled paid call. Read the discovery and verification methodology →

Which networks and payment options does it accept?

The normalized listing price is No normalized USD price is recorded. Raw protocol requirements remain visible below for implementation and audit use.

Baseexact10000 atomic · 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913
geoprimitives POST /v1/geometry/difference · 4e159a x402 API · TOLL·402