University of Chicago

University of Chicago Gen3 Peregrine — core metadata API

The core metadata API from University of Chicago — 1 operation(s) for core metadata.

Documentation GitHub OpenAPI

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/university-of-chicago-core-metadata-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no email required.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.0.0
info:
  title: Gen3 Peregrine OpenAPI Specification — core metadata API
  version: 0.1.0
  description: >-
    Peregrine is the Gen3 GraphQL query service, authored by the University of Chicago Center for Translational Data Science.
    Code: https://github.com/uc-cdis/peregrine
  termsOfService: http://cdis.uchicago.edu/terms/
  contact:
    email: cdis@uchicago.edu
  license:
    name: Apache 2.0
    url: http://www.apache.org/licenses/LICENSE-2.0.html
servers:
- url: https://gen3.datacommons.io/
  description: >-
    University of Chicago Center for Translational Data Science (CTDS) reference Gen3 data
    commons. Gen3 is deployable software authored by CTDS (github.com/uc-cdis), so the upstream
    specification ships a placeholder host; this is the base URL of the deployment CTDS itself
    operates. The datacommons.io domain is registered to CDIS, University of Chicago.
  x-operator: institution
  x-verified: '2026-08-19'
  x-verified-evidence: https://gen3.datacommons.io/.well-known/openid-configuration
tags:
- name: core metadata
paths:
  /{object_id}:
    get:
      summary: Get core metadata for an object_id
      tags:
      - core metadata
      parameters:
      - name: object_id
        in: path
        required: true
        schema:
          type: string
      - name: Accept
        in: header
        schema:
          type: string
          enum:
          - application/json (default)
          - x-bibtex
          - application/vnd.schemaorg.ld+json
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
              example:
                object_id: 123
                file_name: my-file.txt
                data_format: TXT
                file_size: 10
            application/vnd.schemaorg.ld+json:
              schema:
                type: object
              example:
                '@context': http://schema.org
                '@type': Dataset
                '@id': https://dataguids.org/index/123
                identifier:
                - '@type': PropertyValue
                  propertyID: dataguid
                  value: '123'
                - '@type': PropertyValue
                  propertyID: md5
                  value: bc575394b5565a1d3fa20abe2b132896
                publisher:
                  '@type': Organization
                  name: my-org
                author:
                  name: my-author
                description: my-description
                additionalType: submitted_aligned_reads
                name: my-file.txt
                datePublished: 2019-01-24 19:40:02.537991+00:00
            x-bibtex:
              schema:
                type: string
              example: '@misc {123, file_name = "my-file.txt", data_format = "TXT", file_size = "10", object_id = "123"}'
        '401':
          description: Authentication error
        '404':
          description: No core metadata was found for this object_id
components:
  securitySchemes:
    OAuth2:
      type: oauth2
      flows:
        authorizationCode:
          authorizationUrl: /oauth/authorize
          tokenUrl: /oauth/token
          scopes:
            user: generic user access