support portal

Solution home General Unpaywall FAQ
What do the types of oa_status (green, gold, hybrid, and bronze) mean?Print
Created by: Jason Priem
Modified on: Tue, 8 Jun, 2021 at 8:21 AM
Unpaywall assigns an OA Status to every article, which you can find in the oa_status field of the API and dataset. There are five possible values: closed, green, gold, hybrid, and bronze. These terms are all commonly used in discussions of open access. Unfortunately, however, this is still not universal agreement on how to define them.

When using these terms in the Unpaywall API, we've done our best to follow the most common usage. However, our definitions may not map well to your use case.  That's ok. All the properties we use to determine the oa_status are in the API and datasets. So you don't need to use our oa_status--you can make your own, using the same underlying data.

So, without further ado, here's a flowchart-style description of how we determine the oa_status for each article:
Ok, let's get started. Is the article open access?

You can learn more about these terms and why we selected them in our paper, "The state of OA: a large-scale analysis of the prevalence and impact of Open Access articles," published in the journal PeerJ--particularly the literature review and methods sections.

In the browser extension, with OA Nerd Mode enabled, OA status is indicated by color:

hybrid or bronze

If a full text article is found by the extension - that is, not through our API - the tab color is always Bronze in OA Nerd Mode.
Jason is the author of this solution article.
Did you find it helpful?
Related Articles
What is an OA license?
What do the fields in the API response and snapshot records mean?
Unpaywall Change Notes
How do we decide if a given journal is fully OA?
What does oa_date mean and how is it determined?
What do the host_type values "publisher" and "repository" mean?
How do I use the title search API?
Link Resolver Integrations
How is the best OA location determined?
What counts as an Open Access location?
Home Solutions Cookie policy
Help Desk Software by Freshdesk
HomeSolutions Cookie policy