Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Johns Hopkins University Codes API

Reference code lists (schools, terms, departments).

Johns Hopkins University Codes API is one of 4 APIs that Johns Hopkins University publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

This API exposes 2 JSON Schema definitions.

Tagged areas include Codes. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and 2 JSON Schemas.

This API exposes 3 operations across 3 paths, and defines 1 schema. It is described by OpenAPI 3.0.3, at version 1.0.0.

Requests are made against a single base URL, https://sis.jhu.edu/api.

3 operations 3 paths 1 schemas 3 GET

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.3
API Version
1.0.0
Base URL
https://api.hub.jhu.edu
Authentication
API Key
Resource Areas
1

Authentication & Security 1

Johns Hopkins University Codes API declares 1 security scheme for authenticating requests. An API key is passed in the query as key (apiKey). By default, every request must be authenticated.

Paths & Operations 3

Across 3 paths, the API surfaces 3 operations — 3 GET. Each is listed below with its method, path, parameters, and response codes.

Codes 3

Reference code lists (schools, terms, departments).

GET
/classes/codes/schools
List all available schools
listSchools 1 param → 200401
GET
/classes/codes/terms
List available academic terms
listTerms 1 param → 200401
GET
/classes/codes/departments/{school}
List departments for a school
listDepartments 2 params → 200401

Schemas 1

The contract defines 1 schema that model the data the API accepts and returns. The most detailed is CodeValue (2 properties). Each schema is shown below with its type and property counts.

CodeValue
object
A reference code/value pair (school, term, or department).
2 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

johns-hopkins-university-codes-api-openapi.yml Raw ↑

Other APIs Johns Hopkins University publishes across the network.

JHU Hub API
JHU API Portal (MuleSoft Anypoint)
Johns Hopkins University Classes API