Usage notes

Code snippets

curl "https://api.oanor.com/doaj-api/v1/meta" \
  -H "x-oanor-key: oanor_test_..."

await fetch("https://api.oanor.com/doaj-api/v1/meta", {
  headers: { "x-oanor-key": "oanor_test_..." }
});

$ch = curl_init("https://api.oanor.com/doaj-api/v1/meta");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["x-oanor-key: oanor_test_..."]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$out = curl_exec($ch);

import requests
requests.get(
    "https://api.oanor.com/doaj-api/v1/meta",
    headers={"x-oanor-key": "oanor_test_..."}
)

Example response

A real response from this endpoint, captured by the latest health check.

{
    "data": {
        "note": "The Directory of Open Access Journals — the authoritative community-curated index of vetted open-access scholarship (20,000+ journals, 10M+ articles). Search supports Elasticsearch query syntax (field:value, AND/OR, quotes, wildcards), e.g. q=bibjson.subject.term:Physics. /v1/journals?q=open science = search OA journals returning title, ISSNs, publisher, country, subjects, languages, whether article-processing charges (APC) apply, license and the year open access began; /v1/journal?issn=2167-8359 = a journal's full record (subjects with scheme, keywords, licenses, APC prices, fee-waiver policy, peer-review process, plagiarism detection, preservation & deposit policies, homepage); /v1/articles?q=quantum = search OA articles returning title, authors, journal, year, DOI, keywords and a free full-text link; /v1/article?doi=10.7717/peerj.4375 (or id=<DOAJ id>) = an article's full record with abstract, authors and affiliations, journal & ISSNs, pages, subjects and full-text links. Identify a journal by its ISSN and an article by its DOI or DOAJ id (from search). Data from DOAJ (CC BY-SA / CC0 metadata). For DOIs see the Crossref API, the scholarly graph the OpenAlex API, biomedical literature the Europe PMC API.",
        "source": "DOAJ — Directory of Open Access Journals API (doaj.org)",
        "endpoints": [
            "/v1/journals",
            "/v1/journal",
            "/v1/articles",
            "/v1/article",
            "/v1/meta"
        ]
    },
    "meta": {
        "timestamp": "2026-06-01T08:13:20.653Z",
        "request_id": "eb674355-2e5e-4530-a52c-b09c5412c4b9"
    },
    "status": "ok",
    "message": "Meta retrieved",
    "success": true
}