geodata.plus
Under DevelopmentJoin Waitlist
Documentation

API Reference

Complete reference for the geodata.plus REST API — upload, convert, and download geodata programmatically.

Updated April 2026

The geodata.plus REST API lets you convert geodata files programmatically. Available on Pro and Business plans.

Authentication

Pass your API key in the X-API-Key header on every request.

curl -H "X-API-Key: your_api_key" https://api.geodata.plus/v1/conversions/formats/

API keys are generated from your account settings page.

Base URL

https://api.geodata.plus/v1

Endpoints

Upload a file

POST /conversions/upload/

Upload one or more files. Returns a task_id, detected CRS, and layer info.

curl -X POST https://api.geodata.plus/v1/conversions/upload/ \
  -H "X-API-Key: your_api_key" \
  -F "file=@my-data.shp.zip"

Response

{
  "task_id": "abc123",
  "status": "pending",
  "detected_crs": "EPSG:4326",
  "layers": [
    { "name": "roads", "type": "LineString", "feature_count": 1842 }
  ]
}

Start a conversion

POST /conversions/{task_id}/convert/

curl -X POST https://api.geodata.plus/v1/conversions/abc123/convert/ \
  -H "X-API-Key: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{ "output_format": "geojson", "target_crs": "EPSG:4326" }'

Body parameters

| Field | Type | Required | Description | |-------|------|----------|-------------| | output_format | string | Yes | Target format: geojson, shapefile, kml, gpkg, etc. | | target_crs | string | No | EPSG code to reproject to. Omit to preserve source CRS. |

Poll conversion status

GET /conversions/{task_id}/

curl https://api.geodata.plus/v1/conversions/abc123/ \
  -H "X-API-Key: your_api_key"

Response (completed)

{
  "task_id": "abc123",
  "status": "completed",
  "download_url": "https://storage.geodata.plus/outputs/abc123.zip",
  "expires_at": "2026-05-02T12:00:00Z"
}

Task statuses: pending → processing → completed | failed

List supported formats

GET /conversions/formats/

Returns all supported input/output formats and valid conversion pairs.

Search EPSG codes

GET /conversions/epsg-search/?q=NAD83

Search by code, name, or region.

Rate limits

| Plan | Conversions/month | Max file size | |------|-------------------|---------------| | Pro | 200 | 500 MB | | Business | 2,000 | 5 GB |

Exceeding your limit returns a 429 Too Many Requests response.

apirestdevelopers