---
title: "Get dataset details"
method: GET
path: "/v1/datasets/{datasetId}"
tags: ["Datasets"]
---

# Get dataset details

`GET /v1/datasets/{datasetId}`

## Request

- Base URL: `https://api.terranode.co`
- URL: `https://api.terranode.co/v1/datasets/{datasetId}`
- Auth: API key in header `x-api-key`

Returns full metadata for a dataset including processing status, attribute schema, validation results, and version history.

## Path parameters

- `datasetId` string, uuid, required

## Query parameters

- `version` integer

## Response `200`

Dataset details.

- DatasetDetail
  - `datasetId` string, uuid, required
  - `slug` string
  - `name` string, required
  - `description` string
  - `summary` string
  - `version` integer, required
  - `status` 'pending' | 'processing' | 'ready' | 'error', required
  - `source` DatasetSource
    - `authority` string, required: Who published this data (e.g., "US Census Bureau").
    - `updateCycle` string: How often the source is updated (e.g., "annual").
    - `url` string: Source URL.
    - `license` string: License or terms.
  - `features` integer: Feature count (present when status is "ready").
  - `bbox` number[]: Bounding box [west, south, east, north].
  - `geometryType` string: GeoJSON geometry type (e.g., "Polygon", "MultiPolygon", "Point").
  - `createdAt` string, date-time
  - `updatedAt` string, date-time
  - `partitioned` boolean
  - `partitions` string[]: H3 cell IDs when partitioned.
  - `sourceResolution` string: Source data resolution (e.g., "20m", "500k", "original").
  - `lastIngested` string, date-time
  - `attributeSchema` object: Schema of feature properties with types and metadata.
  - `validation` ValidationCounts
    - `total` integer, required
    - `valid` integer, required
    - `repaired` integer, required
    - `rejected` integer, required
  - `filename` string: Original upload filename.
  - `error` string: Error message when status is "error".

## Other responses

- `400`: Invalid request parameters or body.
- `401`: Missing or invalid API key.
- `404`: Resource not found.
- `500`: Internal server error.

---

[API](https://skmtc.dev/terranode/apis/terranode-geospatial-api.md) · [All operations](https://skmtc.dev/terranode/apis/terranode-geospatial-api/llms.txt) · [OpenAPI document](https://skmtc.dev/terranode/apis/terranode-geospatial-api/revisions/bdd80613bc7a?raw)