Get Job Status

GET/api/geoconvert/convert/jobs/{jobId}/status

Get job status and download URL (if ready).

Headers

  • X-API-Key (required for authentication)

Response 200

jobId string

Identifier you supplied when uploading the file.

originalFileName string

Name of the uploaded input file (GeoJSON or a zipped Shapefile).

status string

Job status: Pending, Processing, Completed, Failed, or Expired (the job completed but its download link has passed the plan's retention; the output is gone and downloadUrl is absent).

downloadUrl string

Presigned URL for the converted output. Directory formats (Shapefile, MapInfo, File Geodatabase) arrive as a .zip; single-file formats use the format's own extension.

downloadExpiresAt string

Download link expiry timestamp (ISO 8601).

featureCount number

Feature count detected by GDAL.

geometryType string

Dominant geometry type of the processed features.

inputSizeBytes number

Size of the uploaded input file.

outputSizeBytes number

Size of the generated output.

processingTimeMs number

Processing time in milliseconds.

createdAt string

Timestamp when the job was created.

completedAt string

Timestamp when the job finished.

Example request
curl -X GET https://cadshift.com/api/geoconvert/convert/jobs/00000000-0000-0000-0000-000000000000/status   -H "X-API-Key: $API_KEY"
Response 200
{
  "jobId": "00000000-0000-0000-0000-000000000000",
  "status": "Completed",
  "originalFileName": "roads.geojson",
  "inputSizeBytes": 12345,
  "outputSizeBytes": 6789,
  "processingTimeMs": 2500,
  "featureCount": 120,
  "geometryType": "LineString",
  "downloadUrl": "https://...",
  "downloadExpiresAt": "2025-01-01T00:00:00Z",
  "createdAt": "2025-01-01T00:00:00Z",
  "completedAt": "2025-01-01T00:00:02Z"
}
CADshift

Start typing to search the documentation

↑↓ to navigate Enter to select