Comment on page

Funder object

These are the fields in a funder object. When you use the API to get a single funder or lists of funders, this is what's returned.


List: A list of alternate titles for this funder.
alternate_titles: [
"US National Institutes of Health",
"Institutos Nacionales de la Salud",


Integer: The total number Works that cite a work linked to this funder.
cited_by_count: 7823467


String: The country where this funder is located, represented as an ISO two-letter country code.
country_code: "US"


List: The values of works_count and cited_by_count for each of the last ten years, binned by year. To put it another way: for every listed year, you can see how many new works are linked to this funder, and how many times any work linked to this funder was cited.
Years with zero citations and zero works have been removed so you will need to add those back in if you need them.
counts_by_year: [
year: 2021,
works_count: 4211,
cited_by_count: 120939
year: 2020,
works_count: 4363,
cited_by_count: 119531
// and so forth


String: The date this Funder object was created in the OpenAlex dataset, expressed as an ISO 8601 date string.
created_date: "2023-02-13"


String: A short description of this funder, taken from Wikidata.
description: "medical research organization in the United States"


String: The primary name of the funder.
display_name: "National Institutes of Health"


Integer: The number of grants linked to this funder.
grants_count: 7109


String: The URL for this funder's primary homepage.
homepage_url: ""


String: The OpenAlex ID for this funder.
id: ""


Object: All the external identifiers that we know about for this funder. IDs are expressed as URIs whenever possible. Possible ID types:
  • crossref String: this funder's Crossref ID
  • doi String: this funder's DOI
  • openalex String: this funder's OpenAlex ID
  • ror String: this funder's ROR ID
  • wikidata String: this funder's Wikidata ID
ids: {
openalex: "",
ror: "",
wikidata: "",
crossref: "100000002",
doi: ""


String: Same as image_url, but it's a smaller image.
This is usually a hotlink to a wikimedia image. You can change the width=300 parameter in the URL if you want a different thumbnail size.
image_thumbnail_url: " 2013 logo vertical.svg&width=300"


String: URL where you can get an image representing this funder. Usually this a hotlink to a Wikimedia image, and usually it's a seal or logo.
image_url: " 2013 logo vertical.svg"


List: List of role objects, which include the role (one of institution, funder, or publisher), the id (OpenAlex ID), and the works_count.
In many cases, a single organization does not fit neatly into one role. For example, Yale University is a single organization that is a research university, funds research studies, and publishes an academic journal. The roles property links the OpenAlex entities together for a single organization, and includes counts for the works associated with each role.
The roles list of an entity (Funder, Publisher, or Institution) always includes itself. In the case where an organization only has one role, the roles will be a list of length one, with itself as the only item.
roles: [
role: "funder",
id: "",
works_count: 1004,
role: "publisher",
id: "",
works_count: 13986,
role: "institution",
id: "",
works_count: 250031,


Object: Citation metrics for this funder
  • 2yr_mean_citedness Float: The 2-year mean citedness for this source. Also known as impact factor. We use the year prior to the current year for the citations (the numerator) and the two years prior to that for the citation-receiving publications (the denominator).
  • h_index Integer: The h-index for this funder.
  • i10_index Integer: The i-10 index for this funder.
While the h-index and the i-10 index are normally author-level metrics and the 2-year mean citedness is normally a journal-level metric, they can be calculated for any set of papers, so we include them for funders.
summary_stats: {
2yr_mean_citedness: 5.065784263815827,
h_index: 985,
i10_index: 176682


String: The last time anything in this funder object changed, expressed as an ISO 8601 date string. This date is updated for any change at all, including increases in various counts.
updated_date: "2023-04-21T16:54:19.012138"


Integer: The number of works linked to this funder.
works_count: 260210