---
title: "Get distance matrix job status"
method: GET
path: "/distance-jobs/{identifier}"
tags: ["distance-jobs"]
---

# Get distance matrix job status

`GET /distance-jobs/{identifier}`

## Request

- Base URL: `https://api.geocod.io/v2`
- URL: `https://api.geocod.io/v2/distance-jobs/{identifier}`
- Auth: API key in query parameter `api_key`

## Path parameters

- `identifier` string, required

## Response `200`

Successful response

- DistanceMatrixJob
  - `data` DistanceMatrixJobDetails
    - `identifier` string
    - `name` string
    - `created_at` string
    - `origins_type` string
    - `origins_count` integer
    - `destinations_type` string
    - `destinations_count` integer
    - `distance_mode` string
    - `calculation_type` string
    - `status` string
    - `download_url` string, nullable
    - `total_calculations` integer
    - `calculations_completed` integer
    - `progress` integer
    - `status_message` string
    - `time_left` string, nullable
    - `is_expired` boolean
  - `_warnings` string[]: Non-fatal advisories about the request — an unrecognized parameter or field name, a superseded API version, or an append that was skipped. Present only when at least one warning was raised.

## Other responses

- `403`: Invalid API key, or feature not available.
- `404`: Resource not found.

## Changes

- **2026-10-02** `05b3bef45842`: 1 info
  - added the optional property `_warnings` to the response with the `200` status
- **2026-09-23** `70b050988e01`: 1 info
  - added the optional property `data/calculation_type` to the response with the `200` status
- **2026-06-10** `c8640e701064`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/geocod/apis/geocodio/changes/distance-jobs/:identifier/get.md)

---

[API](https://skmtc.dev/geocod/apis/geocodio.md) - [All operations](https://skmtc.dev/geocod/apis/geocodio/llms.txt) - [OpenAPI document](https://skmtc.dev/geocod/apis/geocodio/revisions/a76143f69a6d?raw)