Skip to main content

Ingest Location

POST 
/api/v1/v1/locations

Ingest a single location point.

This endpoint accepts location updates from external systems and queues them for asynchronous processing with GPS jitter reduction filters.

Authentication: API Key (Bearer token) Rate Limit: 1000 requests/minute per API key

PRD Reference: §3.4 Public Ingest API

Returns: 202 Accepted: Location queued for processing 400 Bad Request: Invalid location data 401 Unauthorized: Missing or invalid API key 429 Too Many Requests: Rate limit exceeded

Example:

curl -X POST https://api.spatialflow.io/api/v1/locations \
  -H "Authorization: Bearer sf_live_abc123..." \
  -H "Content-Type: application/json" \
  -d '\{
    "device_id": "truck-005",
    "lat": 40.7589,
    "lon": -73.9851,
    "ts": "2025-10-01T14:30:00Z",
    "accuracy": 8.5
  \}'

Request​

Responses​

Accepted