---
title: "List uploaded spreadsheets"
method: GET
path: "/lists"
tags: ["lists"]
---

# List uploaded spreadsheets

`GET /lists`

## Query parameters

- `page` integer

## Response `200`

Successful response

- ListsCollection
  - `current_page` integer
  - `current_page_url` string
  - `data` ImportJob[]
    - `id` integer
    - `fields` string[]
    - `file` ImportFileMetadata
      - `estimated_rows_count` integer
      - `filename` string
    - `status` ImportJobStatus
      - `state` string
      - `progress` integer
      - `message` string
      - `time_left_description` string, nullable
      - `time_left_seconds` string, nullable
    - `download_url` string
    - `expires_at` string
  - `first_page_url` string
  - `from` integer
  - `next_page_url` string, nullable
  - `path` string
  - `per_page` integer
  - `prev_page_url` string, nullable
  - `to` integer

## Other responses

- `403` — Invalid API key, or feature not available.

---

[API](https://skmtc.net/geocod/apis/geocodio.md) · [All operations](https://skmtc.net/geocod/apis/geocodio/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/geocod/geocodio/revisions/cfb0f76c8af3/schema)