Quickstart

Mint → Resolve → Update → Verify in 10 minutes.

Create an API key

Get authenticated access to the NOBLEID API

# 1. Go to /dashboard/api-keys
# 2. Click "Create API key"
# 3. Set name and scopes
# 4. Copy the key

Create API Key

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"
  }'

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

Add version

Create v2 when you have updates

curl -X POST https://api.nobleid.org/v1/work/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"
  }'

Add update badge

Let readers know when new versions are available

<script
  src="https://cdn.nobleid.org/widget/update-checker/v1.js"
  integrity="sha384-oqVuAfXRKap7fdgcCY5uykM6+R9GqQ8K/uxy9rx7HNQlGYl1kPzQho1wx4JwY8wC"
  crossorigin="anonymous"
  data-ark="ark:/nobleid/20092025/7X9K2Q"
  async>
</script>

Fetch receipt

Get cryptographic proof of publication

curl https://api.nobleid.org/v1/receipts/ark:/nobleid/20092025/7X9K2Q/v1

Fetch proofs

Verify integrity and provenance

curl https://api.nobleid.org/v1/proofs/ark:/nobleid/20092025/7X9K2Q/v1

Next Steps

Open Postman collection View Full API Docs