Skip to main content
GET
/
v1
/
consumer
/
protections
List Consumer Protections
curl --request GET \
  --url https://api.truthlocks.com/v1/consumer/protections \
  --header 'X-API-Key: <api-key>'
{
  "protections": [
    {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "attestation_id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
      "title": "My Photograph",
      "description": "Sunset photo taken in Big Sur, CA",
      "content_type": "image",
      "file_name": "sunset-bigsur.jpg",
      "file_size": 4521984,
      "content_hash": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
      "visibility": "public",
      "category": "photography",
      "verification_count": 12,
      "created_at": "2026-03-12T10:30:00Z",
      "updated_at": "2026-03-12T10:30:00Z"
    }
  ]
}
List all content protections for the authenticated consumer. Returns protections sorted by creation date (newest first), including attestation IDs, metadata, visibility status, and verification counts.

​
Parameters

​
Responses

{
  "protections": [
    {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "attestation_id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
      "title": "My Photograph",
      "description": "Sunset photo taken in Big Sur, CA",
      "content_type": "image",
      "file_name": "sunset-bigsur.jpg",
      "file_size": 4521984,
      "content_hash": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
      "visibility": "public",
      "category": "photography",
      "verification_count": 12,
      "created_at": "2026-03-12T10:30:00Z",
      "updated_at": "2026-03-12T10:30:00Z"
    }
  ]
}

Authorizations

​
X-API-Key
string
header
required

API key for machine-to-machine authentication

Response

200 - application/json

List of protections

​
items
object[]
​
total
integer