---
title: "Get a Data Reference"
method: GET
path: "/references/{referenceId}"
tags: ["Manage Data References"]
---

# Get a Data Reference

`GET /references/{referenceId}`

Gets a single Data Reference

## Path parameters

- `referenceId` string, uuid, required

## Response `200`

A Data Reference

- DataReference — Reference to a dataset stored in an external system
  - `id` string, uuid — Unique identifier. If not provided, it will be generated automatically.
  - `entityId` string, required — HERE entity identifier (HRN format)
  - `isPatch` boolean, required — Indicates whether this reference represents a patch dataset
  - `startVersion` integer — Starting version of data (optional)
  - `endVersion` integer, required — Ending version of data
  - `objectType` string, required — Type of stored objects
  - `contentType` string, required — MIME type of stored content
  - `location` string, required — Storage location URI
  - `sourceSystem` string, required — Source system name
  - `targetSystem` string, required — Target system name

## Other responses

- `404` — Not found.

## Changes

- **2026-02-11** `5f3024e244fa` — 1 info
  - endpoint added
- **2023-07-03** `fb8e107462aa` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/here/apis/here-xyz-hub/changes/references/:referenceId/get.md)

---

[API](https://skmtc.dev/here/apis/here-xyz-hub.md) · [All operations](https://skmtc.dev/here/apis/here-xyz-hub/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/here/here-xyz-hub/revisions/1c6c6a2bcac9/schema)