Old OpenAlex API documentation
  • Overview
  • Quickstart tutorial
  • API Entities
    • Entities overview
    • 📄Works
      • Work object
        • Authorship object
        • Location object
      • Get a single work
      • Get lists of works
      • Filter works
      • Search works
      • Group works
      • Get N-grams
    • 👩Authors
      • Author object
      • Get a single author
      • Get lists of authors
      • Filter authors
      • Search authors
      • Group authors
      • Limitations
      • Author disambiguation
    • 📚Sources
      • Source object
      • Get a single source
      • Get lists of sources
      • Filter sources
      • Search sources
      • Group sources
    • 🏫Institutions
      • Institution object
      • Get a single institution
      • Get lists of institutions
      • Filter institutions
      • Search institutions
      • Group institutions
    • 💡Topics
      • Topic object
      • Get a single topic
      • Get lists of topics
      • Filter topics
      • Search topics
      • Group topics
    • 🗝️Keywords
    • 🏢Publishers
      • Publisher object
      • Get a single publisher
      • Get lists of publishers
      • Filter publishers
      • Search publishers
      • Group publishers
    • 💰Funders
      • Funder object
      • Get a single funder
      • Get lists of funders
      • Filter funders
      • Search funders
      • Group funders
    • 🌎Geo
      • Continents
      • Regions
    • 💡Concepts
      • Concept object
      • Get a single concept
      • Get lists of concepts
      • Filter concepts
      • Search concepts
      • Group concepts
    • Aboutness endpoint (/text)
  • How to use the API
    • API Overview
    • Get single entities
      • Random result
      • Select fields
    • Get lists of entities
      • Paging
      • Filter entity lists
      • Search entities
      • Sort entity lists
      • Select fields
      • Sample entity lists
      • Autocomplete entities
    • Get groups of entities
    • Rate limits and authentication
  • Download all data
    • OpenAlex snapshot
    • Snapshot data format
    • Download to your machine
    • Upload to your database
      • Load to a data warehouse
      • Load to a relational database
        • Postgres schema diagram
  • Additional Help
    • Tutorials
    • Report bugs
    • FAQ
Powered by GitBook
On this page
  • External IDs
  • Select fields
  1. API Entities
  2. Institutions

Get a single institution

PreviousInstitution objectNextGet lists of institutions

Last updated 1 year ago

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

  • Get the institution with the I27837315:

That will return an 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
}

You can make up to 50 of these queries at once by .

External IDs

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

  • Get the institution with ROR ID 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 .

Display only the id and display_name for an institution object

🏫
here
https://api.openalex.org/institutions/I27837315?select=id,display_name
https://api.openalex.org/institutions/I27837315
Institution
ROR ID
https://api.openalex.org/institutions/ror:https://ror.org/00cvxb145
OpenAlex ID
requesting a list of entities and filtering on IDs using OR syntax