---
agentTools:
  projectIndex: https://worldbox-api.readme.io/llms.txt
---

# Get Order

Get the order with the order items

**Response**
The order with an array of order items including their current status and the binary if already available.

[block:code]
{
  "codes": [
    {
      "code": "{\n    \"ordernumber\": 4009874433,\n    \"orderitems\": [\n        {\n            \"company\": \"Ascom (Schweiz) AG\",\n            \"reference\": 123456,\n            \"name\": \"Credit Report online\",\n            \"language\": \"DE\",\n            \"filesize\": 42047,\n            \"format\": \"PDF\",\n            \"binary\": \"JVBERi0xLjUNCiW1tbW1DQoxIDAgb2JqDQo8PC9UeXBlL0NhdGFsb2cvUGFnZXMgMiAwIFIvTGFuZyhkZS1DSCkgL1N0cnVjdFRyZWVSb290IDIxIDAgUi9NYXJrSW5mbzw8L01hcmtlZCB0cnVlPj4+Pg0KZW5kb2J...\",\n            \"productcode\": \"DLF150\",\n            \"itemnumber\": \"1409B0083\",\n            \"comment\": \"some comment\"\n        },\n        {\n            \"company\": \"Ascom (Schweiz) AG\",\n            \"reference\": 123456,\n            \"name\": \"Financial Report online\",\n            \"language\": \"DE\",\n            \"filesize\": 33967,\n            \"format\": \"PDF\",\n            \"binary\": \"JVBERi0xLjUNCiW1tbW1DQoxIDAgb2JqDQo8PC9UeXBlL0NhdGFsb2cvUGFnZXMgMiAwIFIvTGFuZyhkZS1DSCkgL1N0cnVjdFRyZWVSb290IDE5IDAgUi9NYXJrSW5mbzw8L01hcmtlZCB0cnVlPj4+Pg0KZW5...\",\n            \"statuscode\": 6,\n            \"status\": \"available\",\n            \"productcode\": \"DLF110\",\n            \"itemnumber\": \"1409B0084\",\n            \"comment\": \"some comment\"\n        }\n    ],\n    \"date\": \"2014-09-05T12:24:21Z\"\n}",
      "language": "json"
    }
  ]
}
[/block]

The "orderitem.binary" contains the report as base64 encoded JSON-string. Please decode it to a real binary with your preferred programming language.

The attributes **filesize** and **datecreated** are only available if the binary is included.

Example:

[block:code]
{
  "codes": [
    {
      "code": "$.get('https://api.worldbox.ch/v1/order/6225223617?binary=false', function(data) {\n    console.log(data);\n});",
      "language": "javascript"
    }
  ]
}
[/block]

[block:api-header]
{
  "type": "basic",
  "title": "Negative Reports & Cancellation Code"
}
[/block]

When we have certainty that the request cannot be completed we call it a “Negative Report” (a report indicating that no companies have been found for the provided criteria).

The status returned will be "canceled" with the "statuscode" 9 and a field  "comment" and "cancellationcode" will be added to the response structure containing further information.

[block:code]
{
  "codes": [
    {
      "code": "{\n  \"ordernumber\": \"7115443784\",\n  \"orderitems\": [\n    {\n      \"company\": \"Sonangol - Sociedade Nacional de Combustíveis de Angola E.P\",\n      \"name\": \"Credit/Investigation report normal (offline)\",\n      \"language\": \"EN\",\n      \"productcode\": \"REO110\",\n      \"estimated production time\": \"\",\n      \"charge\": \"0.00\",\n      \"productid\": \"650\",\n      \"reference\": \"1234\",\n      \"format\": \"XML\",\n      \"statuscode\": 9,\n      \"status\": \"canceled\",\n      \"comment\": \"NEGATIVE REPORT. We could not find the company you requested\",\n      \"cancellationcode\" : \"001\",\n      \"datecreated\": \"\",\n      \"itemnumber\": \"1601B0114\"\n    }\n  ],\n  \"date\": \"2016-01-27T14:10:26Z\",\n  \"charge\": \"0.00\"\n}",
      "language": "json",
      "name": "Negative Reports Response"
    }
  ]
}
[/block]

* Check the appendix page [Status Codes](https://worldbox-api.readme.io/docs/appendix) for a full list of the cancellation codes