Quickstart

Mint → Resolve → Update → Verify in 10 minutes.

1
Create an API key
Get authenticated access to the NOBLEID API
# 1. Go to /app/api-keys # 2. Click "Create API key" # 3. Set name and scopes # 4. Copy the key (shown only once)
Create API Key
2
POST /generate
Mint your first identifier
curl -X POST https://api.nobleid.org/v1/works \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "title": "My Research Paper", "type": "Article", "authors": [{"name": "Dr. Jane Smith"}], "abstract": "This paper explores...", "content_url": "https://example.org/paper.pdf" }'
3
Resolve latest
Access your work via browser or API
# Browser https://nobleid.org/20092025/7X9K2Q # cURL (JSON) curl -H "Accept: application/json" \ https://api.nobleid.org/v1/resolve/ark:/nobleid/20092025/7X9K2Q
4
Add version
Create v2 when you have updates
curl -X POST https://api.nobleid.org/v1/works/ark:/nobleid/20092025/7X9K2Q/versions \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "change_notes": "Updated methodology section", "content_url": "https://example.org/paper-v2.pdf" }'
5
Add update badge
Let readers know when new versions are available
<script src="https://cdn.nobleblocks.org/widget/update-checker/v1.js" integrity="sha384-oqVuAfXRKap7fdgcCY5uykM6+R9GqQ8K/uxy9rx7HNQlGYl1kPzQho1wx4JwY8wC" crossorigin="anonymous" data-ark="ark:/nobleid/20092025/7X9K2Q" async> </script>
6
Fetch receipt
Get cryptographic proof of publication
curl https://api.nobleid.org/v1/receipts/ark:/nobleid/20092025/7X9K2Q/v1
7
Fetch proofs
Verify integrity and provenance
curl https://api.nobleid.org/v1/proofs/ark:/nobleid/20092025/7X9K2Q/v1