S
SIO®
Register an Object

SIO API™

REST API Reference

Authenticate with a bearer API key issued from your dashboard. All responses are JSON.

Manage API keys

Authentication

curl https://socialidentityofobjects.com/api/v1/objects \
  -H "Authorization: Bearer sio_live_..."
POST/api/v1/objectsAPI key

Register a new object and mint a permanent SIO identifier.

{
  "name": "Mosaic Mermaid Garden Statue",
  "category": "Artwork",
  "description": "Hand-set glass mosaic, 1.4m",
  "visibility": "public",
  "attributes": { "material": "glass mosaic" }
}
GET/api/v1/objectsAPI key

List objects owned by the authenticated key holder.

GET/api/v1/objects/{sio_id}API key

Retrieve a full identity record including provenance, lifecycle events and transfers.

POST/api/v1/objects/{sio_id}/evidenceAPI key (write)

Attach an evidence document (max 10 MB) to a record you own. Send the file base64-encoded.

{
  "label": "Certificate of authenticity",
  "file_name": "certificate.pdf",
  "content_type": "application/pdf",
  "data": "<base64-encoded file>"
}
GET/api/v1/objects/{sio_id}/evidenceAPI key

List evidence attached to a record you own, with short-lived signed download URLs.

GET/api/v1/verify/{sio_id}Public

Verify a publicly listed SIO identifier and its verification status.

Data guarantees

  • SIO identifiers are permanent and immutable once issued.
  • Provenance and lifecycle events are append-only — entries can never be edited or deleted.
  • Ownership changes are always recorded as transfers before they take effect.
  • Every API call is written to an immutable audit log.