GET /orders/:id/documents/:doc_id

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

URL: GET https://api.geocerta.io/orders/:id/documents/:doc_id

Sandbox URL: GET https://api-staging.geocerta.io/orders/:id/documents/:doc_id

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

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"