v2

latestOpenAPI 3.1.0CC02026-07-264460181.4 KB

Institutions

Get a single institution

Retrieve a single institution by OpenAlex ID or ROR.

get/institutions/{id}

idstring required

OpenAlex ID (e.g., I27837315) or ROR

selectstring

Comma-separated list of fields to return. Reduces response size. Example: select=id,display_name,cited_by_count

api_keystring required

Your OpenAlex API key (required). Get a free key at https://openalex.org/settings/api

Successful response

idstring

The OpenAlex ID for this institution.

rorstring nullable

The ROR ID for this institution. This is the Canonical External ID for institutions.

display_namestring

The primary name of the institution.

country_codestring nullable

ISO two-letter country code where this institution is located.

The institution's primary type (ROR vocabulary): Education, Healthcare, Company, Archive, Nonprofit, Government, Facility, Other.

homepage_urlstring nullable

URL for the institution's primary homepage.

image_urlstring nullable

URL for an image representing this institution (usually from Wikimedia).

image_thumbnail_urlstring nullable

Smaller version of image_url.

display_name_acronymsstring[]

Acronyms or initialisms for this institution.

display_name_alternativesstring[]

Other names people may use for this institution.

works_countinteger

The number of works created by authors affiliated with this institution.

cited_by_countinteger

Total citations to works from authors affiliated with this institution.

lineagestring[]

OpenAlex IDs including this institution and any parent institutions.

works_api_urlstring

A URL that will get you a list of all works affiliated with this institution.

created_datestring date

When this institution was added to OpenAlex (ISO 8601 date).

updated_datestring date-time

When this institution was last updated (ISO 8601 datetime).

{
  "id": "https://openalex.org/I27837315"
}