Skip to main content

Get Order by ID

Retrieve the current status and metadata of a document order previously submitted via POST /document/order.


Method & URL

GET https://api.gbris.com/api/document/order/{order_id}

Example Request

curl -X GET "https://api.gbris.com/api/document/order/d8595ad1e63dc" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN"

Example Response

{
"id": "d8595ad1e63dc",
"status": "COMPLETED",
"created_at": 1713200000,
"finished_at": 1713201800,
"documents": [
{
"entity_persistent_id": "c338d773ad8595ad1e63dc4651854e50",
"product_code": "DE_GMBH_ANNUAL_REPORT_EN",
"year": 2023,
"status": "DELIVERED",
"download_url": "https://api.gbris.com/files/d8595ad1e63dc/YAzH4SwNkpgA0h.pdf"
},
{
"entity_persistent_id": "c338d773ad8595ad1e63dc4651854e50",
"product_code": "DE_ALL_FULL_OFFICIAL_EXTRACT_HISTORICAL_EN",
"status": "NOT_AVAILABLE"
}
]
}

Response Fields

FieldTypeDescription
idstringThe order ID.
statusstringIN_PROGRESS, COMPLETED, or CANCELLED.
created_atnumberUnix timestamp when the order was created.
finished_atnumber | nullUnix timestamp when the order finished processing.
documentsarrayList of documents included in the order.

documents[] fields

FieldTypeDescription
product_codestringThe document product code (matches original order)
yearnumber | nullThe year requested (if applicable)
statusstringDELIVERED or NOT_AVAILABLE
download_urlstring | nullFile URL, included only if status is DELIVERED