---
title: "List distance matrix jobs"
method: GET
path: "/distance-jobs"
tags: ["distance-jobs"]
---

# List distance matrix jobs

`GET /distance-jobs`

## Request

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

## Query parameters

- `page` integer

## Response `200`

Successful response

- DistanceMatrixJobCollection
  - `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
  - `links` PaginationCursors
    - `first` string
    - `last` string
    - `prev` string, nullable
    - `next` string, nullable
  - `meta` PaginationMeta
    - `current_page` integer
    - `from` integer
    - `last_page` integer
    - `links` PaginationLink[]
      - `url` string, nullable
      - `label` string
      - `page` integer, nullable
      - `active` boolean
    - `path` string
    - `per_page` integer
    - `to` integer
    - `total` integer
  - `_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.

## 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/items/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/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)