---
title: "Upload spreadsheet for geocoding"
method: POST
path: "/lists"
tags: ["lists"]
---

# Upload spreadsheet for geocoding

`POST /lists`

## Query parameters

- `fields` string[]

## Request body

- object
  - `file` string, required — Inline file contents as a string
  - `filename` string, required — Filename for the inline content
  - `direction` 'forward' | 'reverse', required
  - `format` string, required — Column format template, e.g. "{{A}} {{B}} {{C}}"
  - `callback` string, uri

## Response `200`

Successful response

- ImportJobCreated
  - `id` integer
  - `file` File
    - `headers` string[]
    - `estimated_rows_count` integer
    - `filename` string

## Other responses

- `400` — Invalid request.
- `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/versions/cfb0f76c8af3/schema)