How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Project Tycho API

Project Tycho is an open-access repository for global health surveillance data, built and run at the University of Pittsburgh and served from www.tycho.pitt.edu. It holds case counts for 78 notifiable conditions in the United States, dengue for 100 countries and COVID-19 for 237 countries, standardized into the Project Tycho Pre-compiled Data Format version 1.0. The API is fourteen GET endpoints returning CSV: thirteen listings that enumerate the controlled values of each variable in that format, and /query, which returns the surveillance rows filtered on any of them. Every call carries a free API key in the query string. The site is maintained for Project Tycho by the MIDAS Coordination Center under NIH/NIGMS grant R24GM153920 and is copyright University of Pittsburgh. Pitt publishes no machine-readable contract for it; the OpenAPI in this repository was written by API Evangelist from Pitt's own published reference.

Project Tycho API is one of 6 APIs that University of Pittsburgh publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

This API exposes 1 JSON Schema definition.

Tagged areas include Research Data, Health, Epidemiology, Public Health, and Surveillance. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, and 1 JSON Schema.

This API exposes 14 operations across 14 paths, organized into 2 resource areas, and defines 7 schemas. It is described by OpenAPI 3.2.0, at version 1.0.

Requests are made against a single base URL, https://www.tycho.pitt.edu/api.

14 operations 14 paths 7 schemas 14 GET

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
1.0
Base URL
https://www.tycho.pitt.edu/api
Authentication
API Key
Terms of Service
Resource Areas
2

Authentication & Security 1

Project Tycho API declares 1 security scheme for authenticating requests. An API key is passed in the query as apikey (ProjectTychoApiKey). By default, every request must be authenticated.

  • ProjectTychoApiKey — A free API key, obtained from the Profile page after registering an account at https://www.tycho.pitt.edu. The key travels in the query string on every request…

Paths & Operations 14

Across 14 paths, the API surfaces 14 operations — 14 GET. They span 2 resource areas: variables, data. Each is listed below with its method, path, parameters, and response codes.

variables 13

Listings of the controlled values available for each variable of the Project Tycho Pre-compiled Data Format version 1.0, except PeriodStartDate and PeriodEndDate.

GET
/condition
List conditions
listConditions 3 params → 200
GET
/country
List countries
listCountries 3 params → 200
GET
/admin1
List first-level administrative divisions
listAdmin1 5 params → 200
GET
/admin2
List second-level administrative divisions
listAdmin2 6 params → 200
GET
/city
List cities
listCities 7 params → 200
GET
/pathogen
List pathogens
listPathogens 3 params → 200
GET
/agerange
List age ranges
listAgeRanges 1 param → 200
GET
/subpopulation
List subpopulations
listSubpopulations 1 param → 200
GET
/fatalities
List fatality flag values
listFatalities 1 param → 200
GET
/cumulative
List cumulative-series flag values
listCumulative 1 param → 200
GET
/diagnosiscertainty
List diagnosis-certainty values
listDiagnosisCertainty 1 param → 200
GET
/placeofacquisition
List place-of-acquisition values
listPlaceOfAcquisition 1 param → 200
GET
/sourcename
List source names
listSourceNames 1 param → 200
data 1

Filtered retrieval of Project Tycho surveillance rows.

GET
/query
Query surveillance data
querySurveillanceData 16 params → 200

Schemas 7

The contract defines 7 schemas that model the data the API accepts and returns. The most detailed are TychoDataRow (19 properties), CityRow (6 properties), Admin2Row (5 properties), Admin1Row (4 properties). Each schema is shown below with its type and property counts.

ConditionRow
object
One row of the /condition listing.
2 properties
CountryRow
object
One row of the /country listing.
2 properties
Admin1Row
object
One row of the /admin1 listing.
4 properties
Admin2Row
object
One row of the /admin2 listing.
5 properties
CityRow
object
One row of the /city listing.
6 properties
PathogenRow
object
One row of the /pathogen listing.
2 properties
TychoDataRow
object
One surveillance row in the Project Tycho Pre-compiled Data Format version 1.0. The columns below are those the published API reference names explicitly as fil…
19 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

university-of-pittsburgh-project-tycho-api-openapi.yml Raw ↑

Other APIs University of Pittsburgh publishes across the network.

Western Pennsylvania Regional Data Center (WPRDC) CKAN API
ULS E-Journal Publishing — OAI-PMH 2.0 providers
Pitt Passport (Shibboleth SAML 2.0 Identity Provider)
D-Scholarship@Pitt Institutional Repository (Hyku Commons) — tenant
PittAPI (Pitt Computer Science Club) — student-built
Where this information came from

This is an independent, third-party profile of Project Tycho API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.