Documentation

Start here

Choose your path

Identifier format

ORI:institution/year.number

Resolution and public API

Addresses and endpoints

Open data, no key needed. The public API answers JSON and allows 120 requests per minute per address.

• https://oriregistry.org/ORI-7K4M9Q2XT8RBPublic page of the record (HTML), with metadata, citations and history.
• https://oriregistry.org/ORI-7K4M9Q2XT8RB?redirect=1Redirects to the article on the journal website.
• https://oriregistry.org/ORI-7K4M9Q2XT8RB?format=jsonRecord download: format=json, format=bibtex or format=ris.
• https://oriregistry.org/wp-json/ori/v1/resolve/ORI-7K4M9Q2XT8RBResolution: identifier, status, record URL, article URL and DOI.
• https://oriregistry.org/wp-json/ori/v1/records/ORI-7K4M9Q2XT8RBComplete public record as JSON.
• https://oriregistry.org/wp-json/ori/v1/search?q=sleep&journal=1&per_page=20Search with filters (journal, year, status, language, type) and sorting.
• https://oriregistry.org/wp-json/ori/v1/journalsParticipating journals.
• https://oriregistry.org/oai?verb=ListRecords&metadataPrefix=oai_dcOAI-PMH harvesting (Dublin Core), with sets per journal and type.

curl https://oriregistry.org/wp-json/ori/v1/resolve/ORI-7K4M9Q2XT8RB

{
  "identifier": "ORI-7K4M9Q2XT8RB",
  "status": "published",
  "record_url": "https://oriregistry.org/ORI-7K4M9Q2XT8RB",
  "article_url": "https://journal.example.org/article/1",
  "doi": null
}

Write API

For journals and their systems

Authenticated with a journal credential (Authorization: Bearer …) issued in the dashboard, with scopes. Every call is validated and audited, and issuing identifiers follows the plan of the organization.

• POST/wp-json/ori/v1/recordsCreate a record (draft, reserved or published).
• PATCH/wp-json/ori/v1/records/{ORI}Update metadata (If-Match with the version).
• POST/wp-json/ori/v1/records/{ORI}/statusChange status (reserve or publish); withdrawals and retractions are made in the dashboard.
• POST/wp-json/ori/v1/records/{ORI}/filesDeposit the full text (PDF) in the repository.
• POST/wp-json/ori/v1/registrationsRegistration request (Idempotency-Key header).
• GET/wp-json/ori/v1/meThe credential: journal, scopes and plan entitlement.

Module APIs

Available on this registry

• GET/wp-json/ori-citation/v1/record/{ORI}?style=chicagoCitation in Chicago, Harvard, MLA, IEEE or CSL-JSON (ORI Citation Studio).
• GET/wp-json/ori-discover/v1/related/{ORI}Related reading across journals (ORI Discover).
• GET/wp-json/ori-graph/v1/record/{ORI}Connections: researchers, institutions, funders, topics, citations (ORI Research Graph).
• GET/wp-json/ori-integrity/v1/record/{ORI}Integrity notices of a record (ORI Integrity).

Module data is available for records of organizations whose plan includes the module.

Policies and service

The rules behind every record

• Registration policyWho can register and what is required.
• Persistence policyIdentifiers are never changed, deleted or reused.
• Metadata updatesHow records are updated and versioned.
• Retractions and correctionsWithdrawals, retractions and notices.
• SecurityCredentials, audit and infrastructure.
• Privacy and data protectionPersonal data and LGPD.
• System statusLive checks of the registry services.