CUGIR — Cornell University Geospatial Information Repository API

openapi: 3.0.3
info:
  title: CUGIR — Cornell University Geospatial Information Repository API
  version: '1.0'
  description: >-
    Machine-readable search and item metadata for CUGIR, the Cornell University Geospatial
    Information Repository operated by Cornell University Library. CUGIR runs GeoBlacklight,
    which answers every catalog route in JSON:API form when `.json` is appended. There is no
    Cornell-published API reference; this document was derived from live probes of the running
    service. Item records carry Aardvark/GeoBlacklight metadata fields (dct_creator_sm,
    dct_spatial_sm, and so on).
  termsOfService: https://cugir.library.cornell.edu/
  contact:
    name: Cornell University Library
    url: https://cugir.library.cornell.edu/
  x-operator: institution
  x-operator-evidence: >-
    cugir.library.cornell.edu is under Cornell's own registrable domain and CNAMEs to
    cugir-app-1492036709.us-east-1.elb.amazonaws.com — an AWS load balancer in Cornell University
    Library's own account, not a vendor platform. CUGIR is Cornell University Library's own
    GeoBlacklight deployment.
  x-provenance:
    generated: '2026-08-19'
    method: derived
    source: >-
      Live probes 2026-08-19: https://cugir.library.cornell.edu/catalog.json?q=ithaca 200
      application/json; .../catalog.json?q=soil&page=2&per_page=5 200;
      https://cugir.library.cornell.edu/catalog/cugir-map-5063364.json 200 application/json
      (JSON:API `data.attributes`); https://cugir.library.cornell.edu/oai?verb=Identify 404 —
      CUGIR exposes no OAI-PMH endpoint at that path.
servers:
- url: https://cugir.library.cornell.edu
  description: CUGIR (production)
tags:
- name: cugir
  description: Search and retrieve Cornell geospatial datasets and historical maps.
paths:
  /catalog.json:
    get:
      tags: [cugir]
      summary: Search CUGIR
      description: GeoBlacklight search returning a JSON:API envelope with links, meta and data[].
      operationId: searchCugir
      parameters:
      - name: q
        in: query
        required: false
        schema: {type: string}
      - name: page
        in: query
        required: false
        schema: {type: integer, minimum: 1}
      - name: per_page
        in: query
        required: false
        schema: {type: integer, minimum: 1}
      responses:
        '200':
          description: JSON:API search response.
          content:
            application/json:
              schema:
                type: object
                properties:
                  links: {type: object, description: self / next / last page links}
                  meta: {type: object, description: result counts and page metadata}
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        id: {type: string, example: cugir-map-5063364}
                        attributes: {type: object, description: Aardvark/GeoBlacklight metadata fields}
                  included: {type: array, items: {}}
  /catalog/{id}.json:
    get:
      tags: [cugir]
      summary: Get one CUGIR record
      description: Returns a single dataset or map record as JSON:API. Verified live 2026-08-19.
      operationId: getCugirRecord
      parameters:
      - name: id
        in: path
        required: true
        description: CUGIR record identifier, e.g. cugir-map-5063364.
        schema: {type: string}
      responses:
        '200':
          description: One record.
          content:
            application/json:
              schema:
                type: object
                properties:
                  links: {type: object}
                  data:
                    type: object
                    properties:
                      id: {type: string}
                      attributes: {type: object}
        '404':
          description: No such record.