Publisher & Organization API
Add publications, affiliations, and verifications directly to your researchers' NobleID profiles — with their permission.
Why integrate with NobleID?
For Publishers
- • Write accepted papers to author profiles automatically
- • Verify authorship and reduce identity fraud
- • Link DOIs to permanent ARK identifiers
- • Increase discoverability of your publications
For Institutions
- • Add verified affiliations to researcher profiles
- • Track institutional research output
- • Streamline onboarding for new faculty
- • Generate institutional reports
For Researchers
- • Publications appear automatically on their profile
- • Verified institutional affiliations
- • Single source of truth for their research identity
- • Full control — only with explicit permission
How it works
Register your organization
Create an OAuth application from your developer dashboard. You'll receive a client_id and client_secret.
Request researcher permission
Use OAuth 2.0 authorization code flow to request write access. The researcher sees exactly what permissions you're requesting and must explicitly approve. Request scopes like nobleid:works:write and nobleid:affiliations:write.
Write data to their profile
Use the access token to add publications, update metadata, or add affiliations via our REST API. All writes are attributed to your organization and visible to the researcher.
OAuth Scopes
| Scope | Access | Description |
|---|---|---|
openid | Read | Authenticate user and get their NobleID |
profile | Read | Name, username, avatar, ORCID |
email | Read | Email address and verification status |
nobleid:works:read | Read | List and view the researcher's registered works |
nobleid:works:write | Write | Add publications and update work metadata on the researcher's profile |
nobleid:author:read | Read | View authorship claims and verification status |
nobleid:affiliations:read | Read | View institutional affiliations and education records |
nobleid:affiliations:write | Write | Add or update institutional affiliations and education records |
nobleid:receipts:read | Read | View blockchain provenance receipts |
Write-Back API Endpoints
/api/v1/worksRequires nobleid:works:write{
"work_title": "Quantum Error Correction with Surface Codes",
"work_type": "article",
"authors": "Jane Smith, John Doe, Alice Chen",
"description": "We present a novel approach to quantum error correction...",
"work_url": "https://doi.org/10.1234/example.2026",
"existing_doi": "10.1234/example.2026",
"keywords": "quantum computing, error correction, surface codes",
"language": "en",
"license": "CC-BY-4.0"
}// Response 201 Created
{
"noble_id": "NI0P88W05R71S46",
"ark_identifier": "ark:/48914/NI0P88W05R71S46",
"work_title": "Quantum Error Correction with Surface Codes",
"work_type": "article",
"created_at": "2026-04-17T14:30:00Z"
}/api/v1/works/:ark_identifierRequires nobleid:works:write{
"work_url": "https://doi.org/10.1234/example.2026.v2",
"description": "Updated abstract with revised methodology section..."
}/api/v1/user/affiliationsRequires nobleid:affiliations:write{
"organization": "Massachusetts Institute of Technology",
"role": "Assistant Professor",
"department": "Department of Physics",
"start_year": "2024"
}/api/v1/user/educationRequires nobleid:affiliations:write{
"degree": "Ph.D. in Quantum Physics",
"institution": "Stanford University",
"year": "2023"
}Authentication
# 1. Redirect the researcher to authorize
GET https://api.nobleid.org/api/v1/oauth/authorize?
response_type=code&
client_id=YOUR_CLIENT_ID&
redirect_uri=https://your-journal.com/callback&
scope=nobleid:works:write nobleid:affiliations:write profile&
state=RANDOM_STATE&
code_challenge=PKCE_CHALLENGE&
code_challenge_method=S256
# 2. Exchange code for access token
POST https://api.nobleid.org/api/v1/oauth/token
Content-Type: application/json
{
"grant_type": "authorization_code",
"code": "AUTHORIZATION_CODE",
"redirect_uri": "https://your-journal.com/callback",
"client_id": "YOUR_CLIENT_ID",
"client_secret": "YOUR_CLIENT_SECRET",
"code_verifier": "PKCE_VERIFIER"
}
# 3. Use access token to write data
POST https://api.nobleid.org/api/v1/works
Authorization: Bearer ACCESS_TOKEN
Content-Type: application/json
{
"work_title": "...",
"work_type": "article",
...
}API keys can be created by researchers from their dashboard. When a researcher generates an API key withmint andupdate scopes, your system can use it for automated write-back without requiring per-request authorization.
POST https://api.nobleid.org/api/v1/works
X-API-Key: nb-xxxxxx...
Content-Type: application/json
{
"work_title": "...",
"work_type": "article",
...
}Read Access & Harvesting
Harvest all NobleID records using the Open Archives Initiative Protocol for Metadata Harvesting (OAI-PMH 2.0). Returns Dublin Core metadata.
https://api.nobleid.org/api/v1/oai?verb=ListRecords&metadataPrefix=oai_dcOAI-PMH Guide Read public researcher profiles, works, citations, and resolve ARK identifiers — no API key needed.
GET /api/v1/resolve/ark:/48914/NI0P88W05R71S46API Reference Webhooks (Coming Soon)
Subscribe to events like work.created,work.updated,affiliation.added, andprofile.updated. Webhook delivery will be signed with HMAC-SHA256 for verification.
Feature Comparison
| Feature | NobleID | ORCID |
|---|---|---|
| Free for researchers | ✓ Always free | ✓ |
| Persistent identifier | ✓ ARK | ✓ ORCID iD |
| Publisher write-back | ✓ Free with OAuth | $4,775+/yr membership |
| API key access | ✓ Free | Membership required |
| OAuth 2.0 / OIDC | ✓ Full OIDC + PKCE | ✓ |
| OAI-PMH harvesting | ✓ | ✓ |
| Blockchain provenance | ✓ On-chain receipts | ✗ |
| Tipping / payments | ✓ Multi-chain | ✗ |
| Revenue splits | ✓ Automatic co-author splits | ✗ |
| "Sign in with" button | ✓ Embeddable SDK | ✓ |
| Webhook notifications | Coming soon | Premium only ($9,550+/yr) |
Ready to integrate?
Register your application, get your API credentials, and start writing publications to researcher profiles in minutes.