Job Management

Get result

Download the GeoJSON result of a completed detection job.

GET /api/v1/jobs/{job_id}/result.geojson

Download the GeoJSON FeatureCollection produced by a completed job. The response is a 302 redirect to a pre-signed S3 URL. Follow redirects (most HTTP clients do automatically).

Request

curl -L https://api.spcsft.com/api/v1/jobs/351e635d-7c25-4ae8-a2a5-60c01a6f434c/result.geojson \
  -H "Authorization: Bearer sk_live_xxxxx" \
  -o result.geojson

The -L flag tells curl to follow the redirect.

Response

A standard GeoJSON FeatureCollection in EPSG:4326:

{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "geometry": {
        "type": "Polygon",
        "coordinates": [[[139.65, 35.67], [139.66, 35.67], [139.66, 35.68], [139.65, 35.68], [139.65, 35.67]]]
      },
      "properties": {
        "class": "ship",
        "area_sqm": 2500
      }
    }
  ],
  "crs": {
    "type": "name",
    "properties": { "name": "EPSG:4326" }
  }
}

When no detections are found:

{
  "type": "FeatureCollection",
  "features": [],
  "crs": {
    "type": "name",
    "properties": { "name": "EPSG:4326" }
  }
}

Retention

Results are available for 30 days after completion. Afterwards the endpoint returns:

HTTP/1.1 410 Gone
{
  "error": {
    "code": "GONE",
    "message": "Result is no longer available (retained for 30 days after completion)"
  }
}

Job metadata (status, timestamps) remains accessible via Get job status indefinitely. Clients should detect error.code === "GONE" and surface a dedicated message.

Download and archive results you need to retain beyond 30 days. There is currently no option to extend retention per job.

Next steps

On this page