Skip to main content
Research Preview — This API is under development.

​
List plugins

List the verification plugins available on the service. Each plugin represents a proof-of-location system that can produce LocationStamps. 
GET /verify/v0/plugins

​
Example request

curl https://staging-api.astral.global/verify/v0/plugins \
  -H "X-API-Key: your-api-key"

​
Response

​
plugins
Plugin[]
required
Array of available plugins.

​
Plugin object

FieldTypeDescription
namestringPlugin identifier (e.g., "proofmode", "witnesschain")
versionstringSemver version string
environmentsstring[]Runtime environments the plugin supports
descriptionstringHuman-readable description
ProofMode is working today — the Verify service implements ProofMode stamp verification. The other plugins listed (witnesschain, gpsd, geoclue, wifi-mls, ip-geolocation) are experimental: their interfaces are defined and early verification logic exists, but they aren’t production yet. We’re keen to develop new proof-of-location plugins with partners — get in touch. On the client side, the SDK bundles MockPlugin for development; ProofMode evidence comes from the ProofMode app.

​
Example response

{
  "plugins": [
    {
      "name": "proofmode",
      "version": "0.1.0",
      "environments": ["mobile", "server"],
      "description": "Device attestation with hardware-backed cryptographic signatures"
    },
    {
      "name": "witnesschain",
      "version": "0.1.0",
      "environments": ["server", "node"],
      "description": "WitnessChain proof-of-location via network latency triangulation"
    },
    {
      "name": "gpsd",
      "version": "0.1.0",
      "environments": ["server", "node"],
      "description": "GPS daemon (gpsd) location readings"
    },
    {
      "name": "geoclue",
      "version": "0.1.0",
      "environments": ["server", "node"],
      "description": "GeoClue geolocation service"
    },
    {
      "name": "wifi-mls",
      "version": "0.1.0",
      "environments": ["server", "node"],
      "description": "Wi-Fi positioning via Mozilla Location Service"
    },
    {
      "name": "ip-geolocation",
      "version": "0.1.0",
      "environments": ["server", "node"],
      "description": "IP-based geolocation lookup"
    }
  ]
}

​
Errors

TypeStatusDescription
internal500Failed to retrieve plugin list
rate-limited429Too many requests
unauthorized401Invalid or missing API key

SDK: Location proofs

See the SDK documentation for client-side usage