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://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

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": "Infrastructure verification via network latency triangulation"
    },
    {
      "name": "mock",
      "version": "0.1.0",
      "environments": ["server", "node", "browser"],
      "description": "Mock plugin for testing and development"
    }
  ]
}

Errors

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

SDK: Verify

See the SDK documentation for client-side usage