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)
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
Next Steps