DOI Validation in Node.js — Digital Object Identifier Lookup

1. What is a DOI?

DOI stands for Digital Object Identifier. It is a persistent, unique identifier assigned to scholarly articles, research datasets, software packages, and other digital objects. DOIs are managed by the International DOI Foundation (IDF) and resolved through the Handle System.

Unlike URLs, which can break when a publisher restructures their website, a DOI is permanent. The identifier 10.1038/nature12373 will always resolve to the correct resource, even if the underlying URL changes. This makes DOIs the backbone of modern citation systems.

DOIs are used by publishers (Elsevier, Springer Nature, Wiley), preprint servers (arXiv, bioRxiv), data repositories (Zenodo, Figshare, Dryad), and software archives (e.g. DOIs minted by Zenodo for GitHub releases).

2. DOI structure

A DOI consists of two parts separated by a forward slash: a prefix and a suffix. The prefix identifies the registrant (publisher or organisation), while the suffix identifies the specific resource.

3. Why DOI validation matters

DOIs are critical infrastructure for academic publishing and data management. Invalid or malformed DOIs cause real problems in production systems:

4. Basic validation vs metadata lookup

The IsValid DOI API offers two modes of validation. Basic validation checks the DOI format, extracts the prefix, suffix, and registrant information, and returns the resolved URL. Metadata lookup goes further and retrieves the full bibliographic record from the DOI registry.

5. The right solution

The IsValid DOI API handles format validation, prefix parsing, registrant identification, URL resolution, and optional metadata retrieval in a single call.

Full parameter reference and response schema: DOI Validation API docs →

6. Node.js code example

import { createClient } from '@isvalid-dev/sdk';

const iv = createClient({ apiKey: process.env.ISVALID_API_KEY });

// ── Basic validation ────────────────────────────────────────────────────────

const result = await iv.doi('10.1038/nature12373');

console.log(result.valid);          // true
console.log(result.prefix);         // '10.1038'
console.log(result.registrant);     // 'Springer Nature'

// ── With metadata lookup ────────────────────────────────────────────────────

const lookup = await iv.doi('10.1038/nature12373', { lookup: true });

console.log(lookup.metadata.title);     // 'Genomic....'
console.log(lookup.metadata.publisher); // 'Springer Science...'

// Validate DOIs before inserting into a citation database
async function importReferences(rows) {
  const results = [];

  for (const row of rows) {
    if (!row.doi) {
      results.push({ ...row, doiStatus: 'missing' });
      continue;
    }

    const check = await iv.doi(row.doi, { lookup: true });

    if (!check.valid) {
      results.push({ ...row, doiStatus: 'invalid' });
      continue;
    }

    results.push({
      ...row,
      doi: check.doi,
      title: check.metadata?.title,
      authors: check.metadata?.authors,
      publisher: check.metadata?.publisher,
      doiStatus: 'valid',
    });
  }

  return results;
}

7. cURL example

Basic DOI validation:

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.isvalid.dev/v0/doi?value=10.1038/nature12373"

With metadata lookup:

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.isvalid.dev/v0/doi?value=10.1038/nature12373&lookup=true"

DOI with special characters (URL-encoded):

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.isvalid.dev/v0/doi?value=10.1002/(SICI)1097-0258(19980815)17:15%3C1661::AID-SIM968%3E3.0.CO;2-2"

Invalid DOI:

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.isvalid.dev/v0/doi?value=11.1234/invalid"

8. Understanding the response

Basic validation (valid DOI):

{
  "valid": true,
  "doi": "10.1038/nature12373",
  "prefix": "10.1038",
  "suffix": "nature12373",
  "registrantCode": "1038",
  "registrant": "Springer Nature",
  "url": "https://doi.org/10.1038/nature12373"
}

With metadata lookup:

{
  "valid": true,
  "doi": "10.1038/nature12373",
  "prefix": "10.1038",
  "suffix": "nature12373",
  "registrantCode": "1038",
  "registrant": "Springer Nature",
  "url": "https://doi.org/10.1038/nature12373",
  "metadata": {
    "title": "Genomic...",
    "authors": ["Author A", "Author B"],
    "publisher": "Springer Science and Business Media LLC",
    "type": "journal-article",
    "issued": "2013-09-01"
  }
}

Invalid DOI:

{
  "valid": false
}

9. Edge cases

// DOI with special characters
const result = await iv.doi('10.1002/(SICI)1097-0258(19980815)17:15<1661::AID-SIM968>3.0.CO;2-2');
console.log(result.valid); // true

// Strip common prefixes before validation
function normaliseDoi(raw) {
  return raw
    .replace(/^https?:\/\/(dx\.)?doi\.org\//i, '')
    .replace(/^doi:/i, '')
    .trim();
}

const doi = normaliseDoi('https://doi.org/10.1038/nature12373');
const result = await iv.doi(doi);
console.log(result.valid); // true

10. Summary