Attestia API

Introduction

The Attestia v1 HTTP API lets attesters query open media and submitters register assets using signed requests (access key + timestamp + HMAC). Public routes are available without signing. An optional WebSocket feed may be available for the same data when your deployment exposes it. Attester integrations should treat that realtime feed as the trigger that new media is ready for review.

Base URL (v1)

All versioned REST routes are under https://attestiaprotocol.xyz/api/v1. Use your production or staging hostname in place of the one shown here.

General

General information

Ping, server time, content types, HTTP conventions.

Security

Request signing

Access key, timestamp, HMAC-SHA256, and request examples.

REST

REST endpoints

Methods, parameters, and response shapes.

WebSocket

WebSocket API

Auth message, events, and multi-language examples.

Operations

Limits & errors

Rate limits, HTTP status codes, error body shape.