Struct Institution 

pub struct Institution {

    pub id: String,
    pub ror: Option<String>,
    pub display_name: Option<String>,
    pub country_code: Option<String>,
    pub type: Option<String>,
    pub type_id: Option<String>,
    pub lineage: Option<Vec<String>>,
    pub homepage_url: Option<String>,
    pub image_url: Option<String>,
    pub image_thumbnail_url: Option<String>,
    pub display_name_acronyms: Option<Vec<String>>,
    pub display_name_alternatives: Option<Vec<String>>,
    pub international: Option<Value>,
    pub repositories: Option<Vec<Value>>,
    pub works_count: Option<i64>,
    pub cited_by_count: Option<i64>,
    pub summary_stats: Option<SummaryStats>,
    pub ids: Option<InstitutionIds>,
    pub geo: Option<Geo>,
    pub associated_institutions: Option<Vec<AssociatedInstitution>>,
    pub counts_by_year: Option<Vec<CountsByYear>>,
    pub roles: Option<Vec<Role>>,
    pub topics: Option<Vec<TopicWithScore>>,
    pub topic_share: Option<Vec<TopicShare>>,
    pub is_super_system: Option<bool>,
    pub works_api_url: Option<String>,
    pub updated_date: Option<String>,
    pub created_date: Option<String>,
}

A research institution: university, hospital, company, government agency, or other research organization.

Linked to ROR identifiers. Includes geographic location, parent/child relationships, affiliated repositories, and research output metrics.

Example

{
  "id": "https://openalex.org/I136199984",
  "ror": "https://ror.org/03vek6s52",
  "display_name": "Harvard University",
  "country_code": "US",
  "type": "education",
  "geo": {"city": "Cambridge", "country": "United States", "latitude": 42.3751, ...},
  "works_count": 800000,
  "cited_by_count": 40000000
}

ID formats

Institutions can be retrieved by OpenAlex ID (I...) or ROR.

Fields

id: String

OpenAlex ID URI (e.g. "https://openalex.org/I136199984").

ror: Option<String>

ROR identifier URL (e.g. "https://ror.org/03vek6s52").

display_name: Option<String>

Human-readable institution name (e.g. "Harvard University").

country_code: Option<String>

ISO 3166-1 alpha-2 country code (e.g. "US").

type: Option<String>

Institution type from the ROR vocabulary: "Education", "Healthcare", "Company", "Archive", "Nonprofit", "Government", "Facility", or "Other".

type_id: Option<String>

Machine-readable ROR type identifier.

lineage: Option<Vec<String>>

OpenAlex IDs of this institution and its parent organizations in the hierarchy.

homepage_url: Option<String>

URL of the institution’s homepage.

image_url: Option<String>

URL of the institution’s logo or image.

image_thumbnail_url: Option<String>

URL of a thumbnail version of the institution’s image.

display_name_acronyms: Option<Vec<String>>

Acronyms for the institution name (e.g. ["MIT"]).

display_name_alternatives: Option<Vec<String>>

Alternative names for the institution (translations, historical names).

international: Option<Value>

Internationalized display names (structure varies by locale).

repositories: Option<Vec<Value>>

Repositories hosted by this institution (structure varies).

works_count: Option<i64>

Total number of works affiliated with this institution.

cited_by_count: Option<i64>

Total number of citations received by works from this institution.

summary_stats: Option<SummaryStats>

Impact metrics: h-index, i10-index, and 2-year mean citedness.

ids: Option<InstitutionIds>

External identifiers (OpenAlex, ROR, GRID, MAG, Wikipedia, Wikidata).

geo: Option<Geo>

Geographic location: city, region, country, and coordinates.

associated_institutions: Option<Vec<AssociatedInstitution>>

Related institutions (parent, child, and affiliated organizations).

counts_by_year: Option<Vec<CountsByYear>>

Publication and citation counts broken down by year.

roles: Option<Vec<Role>>

Roles this organization plays in the research ecosystem (institution, funder, publisher).

topics: Option<Vec<TopicWithScore>>

Top research topics for this institution, ranked by relevance or work count.

topic_share: Option<Vec<TopicShare>>

Research topics as a share of this institution’s total works.

is_super_system: Option<bool>

Whether this institution is a “super system” (top-level umbrella organization).

works_api_url: Option<String>

API URL to retrieve this institution’s works.

updated_date: Option<String>

ISO 8601 timestamp of the last update to this record.

created_date: Option<String>

ISO 8601 date when this record was first created.

Trait Implementations

impl Clone for Institution

fn clone(&self) -> Institution

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Institution

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Institution

fn deserialize<__D>( __deserializer: __D, ) -> Result<Institution, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl From<Institution> for InstitutionSummary

fn from(i: Institution) -> Self

Converts to this type from the input type.

impl Serialize for Institution

fn serialize<__S>( &self, __serializer: __S, ) -> Result<<__S as Serializer>::Ok, <__S as Serializer>::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.