POST /verify/v0/stamp

Verify a single location stamp’s internal validity

Research Preview — This API is under development.

Verify stamp

Verify a single location stamp’s internal validity — checks cryptographic signatures, structure, and signal consistency. This endpoint does not assess how well the stamp supports a claim; use verify proof for that.

POST /verify/v0/stamp

Request body

stamp · LocationStamp · required

The location stamp to verify. See LocationStamp for the full type definition.

Key fields: lpVersion, locationType, location, srs, temporalFootprint, plugin, pluginVersion, signals, signatures.

Example request

cURL

curl -X POST https://staging-api.astral.global/verify/v0/stamp \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your-api-key" \
  -d '{
    "stamp": {
      "lpVersion": "0.2",
      "locationType": "geojson-point",
      "location": { "type": "Point", "coordinates": [-122.4194, 37.7749] },
      "srs": "http://www.opengis.net/def/crs/OGC/1.3/CRS84",
      "temporalFootprint": {
        "start": 1706901000,
        "end": 1706901060
      },
      "plugin": "proofmode",
      "pluginVersion": "0.1.0",
      "signals": { "sensorData": "..." },
      "signatures": [{
        "signer": { "scheme": "device-pubkey", "value": "0xabcd..." },
        "algorithm": "secp256k1",
        "value": "0x...",
        "timestamp": 1706901030
      }]
    }
  }'

Response

valid · boolean · required

Overall validity — true only if all checks pass.

signaturesValid · boolean · required

Whether all cryptographic signatures verified successfully.

structureValid · boolean · required

Whether the stamp conforms to the expected structure for its plugin.

signalsConsistent · boolean · required

Whether internal signals are self-consistent.

details · object · required

Plugin-specific verification details. Contents vary by plugin.

Example response

Example only. details contents are plugin-specific, and some fields shown here (for example certificateChainValid) correspond to checks that are planned but not yet performed in v0. See the ProofMode plugin for exactly what stamp verification does today.

{
  "valid": true,
  "signaturesValid": true,
  "structureValid": true,
  "signalsConsistent": true,
  "details": {
    "plugin": "proofmode",
    "hashVerified": true,
    "certificateChainValid": true
  }
}

Errors

Errors follow RFC 7807:

{
  "type": "https://astral.global/errors/invalid-input",
  "title": "Invalid Input",
  "status": 400,
  "detail": "stamp.signatures is required"
}

Type	Status	Description
invalid-input	400	Malformed stamp or missing required fields
not-implemented	501	Plugin not supported
internal	500	Internal verification error
rate-limited	429	Too many requests
unauthorized	401	Invalid or missing API key

SDK: Location proofs

See the SDK documentation for client-side usage