OPopenalex
Institutions

Get a single institution

Retrieve a single institution by OpenAlex ID or ROR.

get/institutions/{id}

Request

  • Base URL
    https://api.openalex.org
  • URL
    https://api.openalex.org/institutions/{id}
  • Auth
    API key in query parameter api_key

Path parameters

idstring required

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

Query parameters

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

Response

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.

type'education' | 'healthcare' | 'company' | 'archive' | 'nonprofit' | 'government' | 'facility' | 'other'

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).

Example response

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

Changes

No recorded changes to this operation across all 6 revisions of this API.