---
title: "Get distance"
method: GET
path: "/getDistance"
tags: ["Distance Retriever"]
---

# Get distance

`GET /getDistance`

Find the distance and general drive time between two points.

## Query parameters

- `id` string, password, required
- `opt` string
- `t` string
- `units` 'mi' | 'km'
- `endLatitude` number, float, required
- `endLongitude` number, float, required
- `startLatitude` number, float, required
- `startLongitude` number, float, required

## Headers

- `Accept` 'application/json' | '*/*', required
- `Content-Type` 'application/json' | 'application/xml', required

## Response `200`

Default response from a GET request

- GETResponse
  - `Results` string — Comma delimited status, error codes, and change codes for the record. For more information, see [Street Route Result Codes](https://docs.melissa.com/cloud-api/street-route/result-codes.html).
  - `Units` string — This is a string value that is the set unit of measurement for the TotalDrivingDistance field.
  - `TransmissionResults` string — Lists error codes from any errors caused by the most recent request as a whole. For more information, see [Street Route Result Codes](https://docs.melissa.com/cloud-api/street-route/result-codes.html).
  - `TravelTime` string — This is a string value of the travel time for the record in the format `hh:mm:ss`.
  - `TotalDrivingDistance` string — This is a string value with the total driving distance. Refer to the Units field to know what unit of measurement it is.
  - `TransmissionReference` string — A pass-through of the input TransmissionReference field.
  - `Version` string — The current service version number.

## Other responses

- `400` — Bad Request

---

[API](https://skmtc.net/melissa/apis/street-route.md) · [All operations](https://skmtc.net/melissa/apis/street-route/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/melissa/street-route/versions/5c7395095ce3/schema)
