Evidence API

Read-only access to scan evidence and compliance data

Base URL

https://preconsent.io/api/v1

Read-Only

All endpoints are GET. No writes, no scan triggers, no mutations.

API Key Auth

Authenticate with a hashed API key. Keys are managed in Settings.

Pro & Agency

Available on Pro and Agency plans. Upgrade from Settings.

The Evidence API is designed for legal teams, internal audit, and enterprise integrations. It provides structured access to scan results -- violations, fingerprinting evidence, pre-consent timelines, geographic data flows, and jurisdiction-specific legal references. No scan triggering is exposed by design.

Authentication

All requests must include your API key in the X-Api-Key header.

Example Request

curl -H "X-Api-Key: pce_YOUR_API_KEY" \
  https://preconsent.io/api/v1/scans/{scan_id}/evidence

How to get your API key

1Go to Settings in your dashboard
2Scroll to the Evidence API section and click Create Key
3Copy the key immediately -- it will not be shown again

API keys are hashed before storage. If you lose your key, revoke it and create a new one.

Endpoints

All endpoints follow the pattern /scans/{id}/{resource}. Replace {id} with the scan UUID from your dashboard.

Error Codes

All errors return a JSON object with an error field.

Status	Message	Cause
401	Missing X-Api-Key header	No API key provided in the request
401	Invalid API key	The key does not match any active key
401	API key has been revoked	The key was revoked from Settings
403	Evidence API requires an active Pro or Agency plan	Account is on Free or Starter plan, or subscription is not active
404	Scan not found or access denied	Scan ID does not exist or belongs to another user
405	Method not allowed	Used a method other than GET
422	Scan is not yet completed	Scan is still pending or processing
429	Rate limit exceeded	Per-minute or daily request limit exceeded. Check Retry-After header

Error Response Format

{
  "error": "Scan not found or access denied"
}

Rate Limits

The Evidence API is subject to fair-use rate limits.

Plan	Requests / Minute	Requests / Day
Pro	60	5,000
Agency	120	20,000

If you exceed these limits, you will receive a 429 response. Wait and retry with exponential backoff.