GeoInsight

GeoInsight Collections API

The Collections API from GeoInsight — 1 operation(s) for collections.

Documentation GitHub OpenAPI

Operations 3

GET /collections Utoipa doc #

GET /collections/{collection_id}/queryables Queryables utoipa doc #

GET /collections/{collection_id}/schema Schema utoipa doc #

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/geoinsight:geoinsight-collections-api"

All apis

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

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

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

OpenAPI Specification

openapi: 3.2.0
info:
  title: GeoInsight OGC API - DGGS Collections API
  description: DGGS data retrieval per OGC 21-038r1. Admin endpoints (/admin/*) are localhost-only and intentionally undocumented here.
  license:
    name: ''
  version: 0.1.2
tags:
- name: Collections
paths:
  /collections:
    get:
      tags:
      - Collections
      operationId: utoipa_doc
      responses:
        '200':
          description: Get Collections
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CollectionsResponse'
            text/html:
              schema:
                type: string
      summary: Utoipa doc
      x-summary-source: derived
  /collections/{collection_id}/queryables:
    get:
      tags:
      - Collections
      operationId: queryables_utoipa_doc
      parameters:
      - name: collection_id
        in: path
        description: Collection identifier
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Queryables of the collection
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SchemaResponse'
        '404':
          description: Collection not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiError'
      summary: Queryables utoipa doc
      x-summary-source: derived
  /collections/{collection_id}/schema:
    get:
      tags:
      - Collections
      operationId: schema_utoipa_doc
      parameters:
      - name: collection_id
        in: path
        description: Collection identifier
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Logical schema of the collection
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SchemaResponse'
        '404':
          description: Collection not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiError'
      summary: Schema utoipa doc
      x-summary-source: derived
components:
  schemas:
    CollectionsResponse:
      type: object
      required:
      - links
      - collections
      properties:
        collections:
          type: array
          items:
            $ref: '#/components/schemas/CollectionId'
        links:
          type: array
          items:
            $ref: '#/components/schemas/Link'
    CollectionId:
      type: object
      required:
      - id
      - links
      properties:
        attribution:
          type:
          - string
          - 'null'
        crs:
          type:
          - array
          - 'null'
          items:
            type: string
        description:
          type:
          - string
          - 'null'
        extent:
          oneOf:
          - type: 'null'
          - $ref: '#/components/schemas/Extent'
        id:
          type: string
        item_type:
          type:
          - string
          - 'null'
        links:
          type: array
          items:
            $ref: '#/components/schemas/Link'
        title:
          type:
          - string
          - 'null'
    Spatial:
      type: object
      properties:
        bbox:
          type:
          - array
          - 'null'
          items:
            type: array
            items:
              type: number
              format: double
        crs:
          type:
          - string
          - 'null'
    Link:
      type: object
      required:
      - href
      - rel
      properties:
        href:
          type: string
        hreflang:
          type:
          - string
          - 'null'
        length:
          type:
          - integer
          - 'null'
          format: int64
        rel:
          type: string
        title:
          type:
          - string
          - 'null'
        type:
          type:
          - string
          - 'null'
    Temporal:
      type: object
      properties:
        interval:
          type:
          - array
          - 'null'
          items:
            type: array
            items:
              type: string
        trs:
          type:
          - string
          - 'null'
    SchemaProperty:
      type: object
      description: A single property in JSON Schema format, per OGC API - Features Part 3 §7.3.
      required:
      - title
      - type
      properties:
        description:
          type:
          - string
          - 'null'
        enum:
          type:
          - array
          - 'null'
          items:
            type: string
        format:
          type:
          - string
          - 'null'
        gi_band_index:
          type:
          - integer
          - 'null'
          format: int32
        gi_data_type:
          type:
          - string
          - 'null'
        gi_dggs_stat:
          type:
          - string
          - 'null'
        gi_gsd:
          type:
          - number
          - 'null'
          format: double
        gi_unit:
          type:
          - string
          - 'null'
        maxLength:
          type:
          - integer
          - 'null'
          format: int32
        maximum:
          type:
          - number
          - 'null'
          format: double
        minLength:
          type:
          - integer
          - 'null'
          format: int32
        minimum:
          type:
          - number
          - 'null'
          format: double
        pattern:
          type:
          - string
          - 'null'
        title:
          type: string
        type:
          type: string
    ApiError:
      type: object
      description: API error response body for JSON error messages.
      required:
      - code
      - message
      properties:
        code:
          type: integer
          format: int32
          description: HTTP status code
          example: 422
          minimum: 0
        hint:
          type:
          - string
          - 'null'
          description: Optional hint to help client fix the request
          example: Parameter `parent-zone-level` is required when `parent-zone` is provided
        message:
          type: string
          description: Fixed message describing the error
          example: Validation Failed
    Extent:
      type: object
      properties:
        spatial:
          oneOf:
          - type: 'null'
          - $ref: '#/components/schemas/Spatial'
        temporal:
          oneOf:
          - type: 'null'
          - $ref: '#/components/schemas/Temporal'
    SchemaResponse:
      type: object
      description: OGC JSON Schema response used by both `/schema` and `/queryables`.
      required:
      - $schema
      - $id
      - type
      - title
      - properties
      - additionalProperties
      properties:
        $id:
          type: string
        $schema:
          type: string
        additionalProperties:
          type: boolean
        description:
          type:
          - string
          - 'null'
        properties:
          type: object
          additionalProperties:
            $ref: '#/components/schemas/SchemaProperty'
          propertyNames:
            type: string
        title:
          type: string
        type:
          type: string
x-provenance:
  method: harvested
  publisher: GeoInsight
  source: https://api.geoinsight.ai/api/openapi.json
  note: split by refine-openapis from the provider's own published document, verified by fetch (openapi/_original/*.fetch.json);
    stamped by stamp-openapi-provenance.py (roadmap#793)