GET /orders/:id/documents/:doc_id

Returns a document attached to an order, including a pre-signed download URL.

Base URL: https://api.geocerta.io

Sandbox URL: https://api-staging.geocerta.io

Authentication required. Include your API key in the api-key header. See Authentication.

Endpoint

GET /orders/:id/documents/:doc_id

Path Parameters

Parameter Type Description
id string The order ID
doc_id string The document ID

Response

200 OK — returns the document with a pre-signed download URL.

Response fields

Field Type Description
_id string Document ID
filename string Original filename
key string S3 object key
size number File size in bytes
type string Document type: reports or plans
product string Associated product ID (if any)
created_at string ISO 8601 upload timestamp
download string Pre-signed URL to download the file

Errors

Status Message Cause
401 Unauthorized Missing or invalid API key
403 Forbidden Access denied to this order
404 Not Found Order or document not found

Example

curl "https://api.geocerta.io/orders/66f3a1b2c4e5d8f9a1b2c4e5/documents/66f3a1b2c4e5d8f9a1b2c4e7" \
  -H "api-key: YOUR_API_KEY"