get-a-single-institution.md

Get a single institution

It's easy to get an institution from from the API with: /institutions/<entity_id>. Here's an example:

• Get the institution with the OpenAlex ID I27837315:
  https://api.openalex.org/institutions/I27837315

That will return an Institution object, describing everything OpenAlex knows about the institution with that ID:

{
    "id": "https://openalex.org/I27837315",
    "ror": "https://ror.org/00jmfr291",
    "display_name": "University of Michigan–Ann Arbor",
    "country_code": "US",
    "type": "education",
    // other fields removed for brevity
}

{% hint style="info" %} You can make up to 50 of these queries at once by requesting a list of entities and filtering on IDs using OR syntax. {% endhint %}

External IDs

You can look up institutions using external IDs such as a ROR ID:

• Get the institution with ROR ID https://ror.org/00cvxb145:
  https://api.openalex.org/institutions/ror:https://ror.org/00cvxb145

Available external IDs for institutions are:

External ID	URN
ROR	ror
Microsoft Academic Graph (MAG)	mag
Wikidata	wikidata

Select fields

You can use select to limit the fields that are returned in an institution object. More details are here.

• Display only the id and display_name for an institution object
  https://api.openalex.org/institutions/I27837315?select=id,display_name