Layrs API

Overview

The Layrs API lets you verify creative work, retrieve proof scores, and embed verification badges. All endpoints return JSON and use standard HTTP status codes.

Authentication

Pass your API key via the X-Layrs-Key header. Public endpoints (verify by project ID, badge) don't require authentication.

curl "https://layrs.org/api/v1/verify?hash=abc..." \
  -H "X-Layrs-Key: lk_live_your_key_here"

Verify a Project

curl "https://layrs.org/api/v1/verify?project=abc123"

{
  "verified": true,
  "project": {
    "id": "abc123",
    "title": "Brand Campaign Hero",
    "proof_score": 82,
    "proof_tier": "assisted"
  },
  "verification": {
    "process_score": 30,
    "verification_score": 25,
    "consistency_score": 17,
    "chain_length": 47,
    "hardware_signed": true
  },
  "creator": {
    "username": "designstudio",
    "profile_url": "https://layrs.org/designstudio"
  }
}

Verify by File Upload

Upload a file directly to check if it matches any verified project. The file is hashed server-side and compared against all known assets.

curl -X POST "https://layrs.org/api/v1/verify" \
  -F "file=@design.png"

Embeddable Badge

Returns an SVG badge showing the proof score and tier. Embed it anywhere — portfolio sites, marketplaces, social profiles.

<img src="https://layrs.org/api/v1/badge/PROJECT_ID"
     alt="Layrs Verified" />

![Layrs Score](https://layrs.org/api/v1/badge/PROJECT_ID)

Rate Limits

Errors

All errors return a JSON object with an error field.

{
  "error": "Project not found",
  "code": "NOT_FOUND",
  "status": 404
}

SDKs

Official SDKs are coming soon. In the meantime, the REST API works with any HTTP client.