---
title: "Retrieve a held result"
method: GET
path: "/results/{id}"
tags: ["compute"]
---

# Retrieve a held result

`GET /results/{id}`

## Request

- Base URL: `https://api.mapsource.io`
- URL: `https://api.mapsource.io/results/{id}`
- Auth: HTTP bearer

Retrieves a result payload or its metadata: type, version, feature count, size, bounding box, dataset versions, operation hash, and lineage.

When to use: Download a result payload or inspect its metadata before further processing.

When not to use: Pass the handle directly to supported operations when the client does not need the payload.

## Path parameters

- `id` string, required

## Query parameters

- `mode` 'summary'

## Response `200`

Retrieve a held result

- object
  - `schema` string
  - `handle` string
  - `resultId` string: Result identifier; equivalent to handle.
  - `version` integer
  - `type` 'feature_collection' | 'route' | 'isochrone' | 'matrix' | 'analysis' | 'render_input' | 'place_collection'
  - `kind` string
  - `summary` string
  - `count` integer
  - `featureCount` integer
  - `bbox` unknown
  - `bytes` integer
  - `estimatedBytes` integer
  - `createdAt` string
  - `expiresAt` string
  - `lineage` object
    - `operation` string
    - `sources` string[]
  - `sourceVersions` object
  - `operationHash` string
  - `next` string[]
  - `retrieve` string
  - `data` unknown

## Other responses

- `400`: Error with a stable machine code.
- `401`: Error with a stable machine code.
- `429`: Error with a stable machine code.
- `500`: Error with a stable machine code.

---

[API](https://skmtc.dev/mapsource/apis/mapsource-overpass-api.md) · [All operations](https://skmtc.dev/mapsource/apis/mapsource-overpass-api/llms.txt) · [OpenAPI document](https://skmtc.dev/mapsource/apis/mapsource-overpass-api/revisions/8af8c2769e7b?raw)