STAC Catalog Details

This section explains how to retrieve metadata and navigation links for a specific STAC Catalog using the /public/stac/catalogs/{catalogId} endpoint.

A STAC Catalog represents a logical grouping of geospatial data and acts as an entry point to collections, items, and other catalogs. Each catalog contains links to child elements and supporting metadata, making it easy to access the catalog hierarchy and discover available data assets.

For illustration purposes, we will explore the BlackSky collection.

Endpoint

GET /public/stac/catalogs/{catalogId}

Include the following header:

x-api-key: YOUR_API_KEY

Example Request (cURL)**

curl -H "x-api-key: YOUR_API_KEY" "https://giq.ae/public/stac/catalogs/abe3ed5f-55a4-99be-5c6e-41a4506737d8"

Example Response (Sample):

{
  "id": "abe3ed5f-55a4-99be-5c6e-41a4506737d8",
  "title": "Space42 Catalogs",
  "type": "Catalog",
  "description": "Welcome to Space42’s STAC Catalogs...",
  "stac_version": "1.0.0",
  "conformsTo": [
    "https://api.stacspec.org/v1.0.0/core",
    "https://api.stacspec.org/v1.0.0/collections",
    "https://api.stacspec.org/v1.0.0/item-search",
    "https://api.stacspec.org/v1.0.0/item-search#fields",
    "https://api.stacspec.org/v1.0.0/item-search#sort",
    "http://www.opengis.net/spec/cql2/1.0/conf/cql2-json",
    "http://www.opengis.net/spec/ogcapi-features-1/1.0/conf/core",
    "http://www.opengis.net/spec/ogcapi-features-1/1.0/conf/oas30",
    "http://www.opengis.net/spec/ogcapi-features-1/1.0/conf/geojson"
  ],
  "links": [
    {
      "rel": "self",
      "href": "https://giq.ae/public/stac/catalogs/abe3ed5f-55a4-99be-5c6e-41a4506737d8",
      "type": "application/json",
      "title": "Current Catalog"
    },
    {
      "rel": "root",
      "href": "https://giq.ae/public/stac/",
      "type": "application/json",
      "title": "Root Catalog"
    },
    {
      "rel": "search",
      "href": "https://giq.ae/public/stac/search",
      "type": "application/geo+json",
      "title": "STAC Search"
    },
    {
      "rel": "child",
      "href": "https://giq.ae/public/stac/catalogs/bae06009-98f7-e6bf-a8c3-3237b3268d2c",
      "type": "application/json",
      "title": "Child Catalog"
    },
    {
      "rel": "preview",
      "href": "https://i.imghippo.com/files/xKsJ9115CQg.jpg",
      "type": "image/jpeg",
      "title": "Preview Image"
    },
    {
      "rel": "about",
      "href": "https://space42.ai/",
      "type": "text/html",
      "title": "About Space42"
    }
  ]
}

Response Overview

Returns a STAC Catalog object that includes:

• Unique identifier and metadata for the catalog
• Supported STAC/OGC conformance classes
• Array of navigable links including child catalogs and search endpoint

Response Fields

Field	Description
id	Unique identifier for the catalog
title	Human-readable title of the catalog
type	STAC object type (e.g., Catalog)
description	Description of the catalog's contents and purpose
stac_version	Version of STAC specification used
conformsTo	List of supported STAC and OGC conformance classes
links	Array of navigation links related to this catalog (detailed below)

Response Links

Rel	Description	Type	URL
self	URL to the current catalog	application/json	.../public/stac/catalogs/abe3ed5f-55a4-99be-5c6e-41a4506737d8
root	URL to the root catalog	application/json	.../public/stac/
search	URL to the STAC search endpoint	application/geo+json	.../public/stac/search
child	URL to a child catalog	application/json	.../public/stac/catalogs/bae06009-98f7-e6bf-a8c3-3237b3268d2c
preview	Link to a preview image	image/jpeg	https://i.imghippo.com/files/xKsJ9115CQg.jpg
about	Link to external documentation	text/html	https://space42.ai/

Assets

This response does not include a separate assets field. For assets, refer to /collections/{collectionId}/items and /items/{itemId} endpoints.

Use Cases

• Retrieve metadata and capabilities of a specific STAC catalog
• Discover child catalogs and available endpoints
• Validate conformance to STAC/OGC standards