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

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 -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
      }]
    }
  }'

const response = await fetch('https://staging-api.astral.global/verify/v0/stamp', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-API-Key': 'your-api-key'
  },
  body: JSON.stringify({
    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
      }]
    }
  })
});

const result = await response.json();

Response

boolean

required

Overall validity — true only if all checks pass.

boolean

required

Whether all cryptographic signatures verified successfully.

boolean

required

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

boolean

required

Whether internal signals are self-consistent.

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