/api/v1/orders

POST

https://api-test.spotgo.eu/api/v1/orders

Request

Body Params application/json; x-api-version=1.0

Examples

Responses

🟢200OK

application/json; x-api-version=1.0

Body

🟠400Bad Request

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api-test.spotgo.eu/api/v1/orders' \
--header 'Content-Type: application/json; x-api-version=1.0' \
--data '{
    "orderNumber": "string",
    "carrier": {
        "name": "string",
        "email": "string",
        "vatCode": "string"
    },
    "internalComments": "string",
    "requiredDocumentTypes": "cmr",
    "details": {
        "weight": 0,
        "licensePlates": [
            "string"
        ]
    },
    "locations": [
        {
            "sequence": 0,
            "type": "Loading",
            "startDate": "2019-08-24T14:15:22.123Z",
            "endDate": "2019-08-24T14:15:22.123Z",
            "name": "string",
            "countryCode": "st",
            "postalCode": "string",
            "city": "string",
            "street": "string",
            "position": {
                "latitude": 0,
                "longitude": 0
            }
        }
    ]
}'

Response Example

200 - Example 1

{
  "created": true,
  "updated": false,
  "linkChanged": true,
  "order": {
    "orderId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "status": 0,
    "orderNumber": "ORD-2026-001",
    "createdAt": "2026-07-20T07:00:00Z",
    "carrier": {
      "name": "Acme Transport GmbH",
      "email": "ops@acme-transport.de",
      "vatCode": "DE123456789"
    },
    "manager": {
      "fullName": "Jonas Example",
      "email": "jonas@example.com"
    },
    "requiredDocumentTypes": ["cmr", "proofOfDelivery"],
    "internalComments": "Handle with care",
    "details": {
      "licensePlates": ["ABC-123", "XYZ-999"]
    },
    "locations": [
      {
        "sequence": 1,
        "type": 1,
        "internalId": "LOC-LOAD-1",
        "startDate": "2026-07-21T08:00:00Z",
        "endDate": "2026-07-21T12:00:00Z",
        "name": null,
        "countryCode": "DE",
        "postalCode": "10115",
        "city": "Berlin",
        "street": "Invalidenstraße 1",
        "details": { "weight": 24000 },
        "position": { "latitude": 52.531, "longitude": 13.384 },
        "requiredDocumentTypes": ["cmr"]
      },
      {
        "sequence": 2,
        "type": 2,
        "internalId": "LOC-UNLOAD-1",
        "startDate": "2026-07-22T09:00:00Z",
        "endDate": null,
        "name": null,
        "countryCode": "PL",
        "postalCode": "00-001",
        "city": "Warsaw",
        "street": "Marszałkowska 1",
        "details": { "weight": 24000 },
        "position": { "latitude": 52.229, "longitude": 21.012 },
        "requiredDocumentTypes": ["proofOfDelivery"]
      }
    ],
    "documents": [],
    "share": {
      "shareUrl": "https://carrier.example.com/share/abc123"
    }
  }
}

Modified at 2026-07-20 07:04:45

Document Upload

/api/v1/orders/{orderId}