api-ninjas-com University API

openapi: 3.2.0
info:
  title: Ninjas University API
  description: 'Combined OpenAPI specification for every API Ninjas endpoint. Requests go to https://api.api-ninjas.com with an `X-Api-Key` header; get a free key at https://api-ninjas.com/register. Human-readable docs: https://api-ninjas.com/api. Index for LLMs: https://api-ninjas.com/llms.txt.'
  version: 1.0.0
  contact:
    name: API Ninjas
    url: https://api-ninjas.com
  license:
    name: Proprietary
servers:
- url: https://api.api-ninjas.com
  description: API Ninjas Production
security:
- ApiKeyAuth: []
tags:
- name: University
  description: The University API provides information about over 80,000 universities, colleges and other institutions of higher learning in 227 countries and territories, including native-language names, acronyms, websites and email domains. US institutions also include enrollment, tuition, student-faculty ratios and degree types from the U.S. Department of Education. Free users can search by name or country - premium users have access to advanced filters including location, email domain, institution level, enrollment, faculty ratios, and tuition.
paths:
  /v1/university:
    get:
      summary: Get information about universities and colleges worldwide
      description: Returns institutions matching the provided filters, closest name matches first, then by enrollment (largest first). At least one filter parameter (excluding offset/limit) is required. Free users can use name or country; all other filters are premium only. Closed institutions are excluded unless status is set.
      operationId: getUniversities
      tags:
      - University
      parameters:
      - name: name
        in: query
        description: The name of the institution to search for. Partial match, case- and accent-insensitive (e.g., "Harvard" matches "Harvard University"). Also matches native-language names (e.g., 東京大学), acronyms (e.g., UNAM), former names, and the names of schools within a university (e.g., "Harvard Law School" returns Harvard University). At least one filter parameter (excluding offset/limit) must be provided.
        required: false
        schema:
          type: string
      - name: country
        in: query
        description: 'The country to filter by: an English country name or an ISO 3166 two- or three-letter code (e.g., Germany, DE or DEU). Case-insensitive. USA also returns US territories such as Puerto Rico and Guam. At least one filter parameter (excluding offset/limit) must be provided.'
        required: false
        schema:
          type: string
      - name: city
        in: query
        description: The city where the institution is located. Premium only.
        required: false
        schema:
          type: string
      - name: state
        in: query
        description: The state, province or region where the institution is located, as a code (e.g., MA, ON) or a name (e.g., Bavaria). Premium only.
        required: false
        schema:
          type: string
      - name: region
        in: query
        description: Same as state. Premium only.
        required: false
        schema:
          type: string
      - name: domain
        in: query
        description: An email domain or email address (e.g., student.mit.edu or jane@ox.ac.uk). Returns the institutions that use the domain; subdomains are matched to their parent domain. Main institutions are listed before their campuses and affiliated units. Premium only.
        required: false
        schema:
          type: string
      - name: level
        in: query
        description: The type of institution. Premium only.
        required: false
        schema:
          type: string
          enum:
          - university
          - college
          - polytechnic
          - community_college
          - vocational
          - specialized
      - name: control
        in: query
        description: Ownership. private means private with unknown profit status. Premium only.
        required: false
        schema:
          type: string
          enum:
          - public
          - private_nonprofit
          - private_forprofit
          - private
      - name: recognition
        in: query
        description: Set to recognized to return only institutions listed by a national education registry (e.g., IPEDS in the US, AISHE in India). Premium only.
        required: false
        schema:
          type: string
          enum:
          - recognized
      - name: status
        in: query
        description: active (default), closed, or all. Closed institutions have stopped operating or merged into another institution. Premium only.
        required: false
        schema:
          type: string
          enum:
          - active
          - closed
          - all
          default: active
      - name: id
        in: query
        description: Return a single institution by its id (from a previous response). Closed institutions are included. Premium only.
        required: false
        schema:
          type: integer
      - name: min_faculty_ratio
        in: query
        description: Minimum student-to-faculty ratio as a number (e.g., 15 for 15:1 ratio). US institutions only. Premium only.
        required: false
        schema:
          type: number
      - name: max_faculty_ratio
        in: query
        description: Maximum student-to-faculty ratio as a number (e.g., 20 for 20:1 ratio). US institutions only. Premium only.
        required: false
        schema:
          type: number
      - name: min_enrolled
        in: query
        description: Minimum number of enrolled students. Premium only.
        required: false
        schema:
          type: integer
      - name: max_enrolled
        in: query
        description: Maximum number of enrolled students. Premium only.
        required: false
        schema:
          type: integer
      - name: min_tuition
        in: query
        description: Minimum published annual tuition and fees (in USD). US institutions only. Premium only.
        required: false
        schema:
          type: number
      - name: max_tuition
        in: query
        description: Maximum published annual tuition and fees (in USD). US institutions only. Premium only.
        required: false
        schema:
          type: number
      - name: offset
        in: query
        description: The number of results to skip. Must be zero or a positive integer. Default is 0. Premium only.
        required: false
        schema:
          type: integer
          minimum: 0
          default: 0
      - name: limit
        in: query
        description: The maximum number of results to return. Must be between 1 and 30. Default is 10 for premium users, fixed at 5 for free users. Premium only.
        required: false
        schema:
          type: integer
          minimum: 1
          maximum: 30
          default: 10
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/University'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UniversityOpenapi_Error'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UniversityOpenapi_Error'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UniversityOpenapi_Error'
      security:
      - ApiKeyAuth: []
components:
  schemas:
    University:
      type: object
      description: An institution of higher learning.
      properties:
        name:
          type: string
          example: Harvard University
          description: The full name of the institution, in English.
        degree_types:
          type: array
          items:
            type: string
          example:
          - Associate's degree
          - Bachelor's degree
          - Postbaccalaureate certificate
          - Master's degree
          - Post-master's certificate
          - Doctor's degree - research/scholarship
          description: Degree types offered. US institutions only.
        address:
          type: string
          example: Massachusetts Hall
          description: The street address of the institution.
        city:
          type: string
          example: Cambridge
          description: The city where the institution is located.
        state:
          type: string
          example: MA
          description: 'State, province or region: a code for US and Canadian institutions (e.g., MA), the name elsewhere (e.g., Bavaria).'
        postal_code:
          type: string
          example: 02138
          description: The postal/zip code of the institution.
        country:
          type: string
          example: USA
          description: USA for the US and its territories, CANADA for Canada, and the English country name elsewhere (e.g., Germany).
        county:
          type: string
          example: Middlesex
          description: The county where the institution is located. US institutions only.
        timezone:
          type: string
          example: EST
          description: Timezone abbreviation for US and Canadian institutions. See timezone_iana for all institutions.
        latitude:
          type: string
          example: '42.374471'
          description: Latitude of the institution, as a string.
        longitude:
          type: string
          example: '-71.118313'
          description: Longitude of the institution, as a string.
        phone:
          type: string
          example: (617) 495-1000
          description: Contact phone number.
        email:
          type: string
          example: info@scbt.ca
          description: Contact email address.
        website:
          type: string
          example: https://www.harvard.edu/
          description: The official website URL.
        institution_type:
          type: string
          example: Private (Not For Profit)
          description: Public, Private (Not For Profit) or Private (For Profit). Canadian institutions show a category such as University, College or Career College.
        years:
          type: string
          example: 4 Years
          description: 4 Years, 2 Years or Under 2 Years. US institutions only.
        enrollment:
          type: string
          example: '30259'
          description: Number of enrolled students, as a string. See enrollment_year.
        student_faculty_ratio:
          type: string
          example: 7 to 1
          description: Student-to-faculty ratio. US institutions only.
        tuition:
          type: number
          example: 61676
          description: Published in-state tuition and fees for the latest academic year, in USD. US institutions only.
        id:
          type: integer
          example: 9157
          description: Unique API Ninjas institution ID. Stays the same across data updates; pass it as the id parameter to fetch the institution again.
        country_code:
          type: string
          example: US
          description: ISO 3166-1 two-letter country code.
        region_code:
          type: string
          example: MA
          description: ISO 3166-2 code of the state, province or region, without the country prefix.
        native_name:
          type: string
          example: Technische Universität München
          description: The name in the local language, when it differs from name.
        aliases:
          type: array
          items:
            type: string
          example:
          - Harvard U.
          - Harvard Univ.
          - University of Harvard
          description: 'Other names: official and translated names, former names and common short forms.'
        acronym:
          type: string
          example: TUM
          description: The common acronym.
        domains:
          type: array
          items:
            type: string
          example:
          - harvard.edu
          description: Web and email domains used by the institution.
        founded:
          type: integer
          example: 1636
          description: The year the institution was founded.
        level:
          type: string
          enum:
          - university
          - college
          - polytechnic
          - community_college
          - vocational
          - specialized
          example: university
          description: The type of institution.
        control:
          type: string
          enum:
          - public
          - private_nonprofit
          - private_forprofit
          - private
          example: private_nonprofit
          description: Ownership. private means private with unknown profit status.
        recognition:
          type: string
          enum:
          - recognized
          example: recognized
          description: Recognition status in a national education registry.
        status:
          type: string
          enum:
          - active
          - closed
          example: active
          description: closed for institutions that have stopped operating or merged into another institution.
        parent_id:
          type: integer
          example: 9157
          description: The id of the parent institution, for branch campuses and constituent or affiliated colleges.
        timezone_iana:
          type: string
          example: America/New_York
          description: The IANA timezone of the institution.
        enrollment_year:
          type: integer
          example: 2024
          description: The year the enrollment figure refers to.
        tuition_in_state:
          type: integer
          example: 61676
          description: Published in-state tuition and fees for the latest academic year, in USD. US institutions only.
        tuition_out_of_state:
          type: integer
          example: 61676
          description: Published out-of-state tuition and fees for the latest academic year, in USD. US institutions only.
        ror_id:
          type: string
          example: 03vek6s52
          description: Research Organization Registry ID.
        wikidata_id:
          type: string
          example: Q13371
          description: Wikidata item ID.
        research_output:
          type: integer
          example: 1113844
          description: Number of scholarly works affiliated with the institution, from OpenAlex.
    UniversityOpenapi_Error:
      type: object
      properties:
        message:
          type: string
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-Api-Key
externalDocs:
  description: API Ninjas documentation
  url: https://api-ninjas.com/api