Create order

Developing

Testing Env

https://test.api.globkurier.pl

POST

/v1/order

In response, we receive the number, the hash of the placed order and information about the valuation of the placed order or a list of validation errors.

Request

Header Params

Body Params application/json

Example

{
    "shipment": {
        "length": 1,
        "width": 1,
        "height": 1,
        "weight": 1,
        "quantity": 1,
        "productId": 2000
    },
    "senderAddress": {
        "name": "Testowy Nadawca",
        "city": "Testowe Miasto",
        "street": "Testowa Ulica",
        "houseNumber": "1x",
        "apartmentNumber": "2a",
        "postCode": "01-001",
        "countryId": 1,
        "pointId": "Test-123",
        "phone": "123123123",
        "email": "testowy.nadawca@testowy.nadawca.pl",
        "contactPerson": "Testowa Osoba"
    },
    "receiverAddress": {
        "name": "Testowy Odbiorca",
        "city": "Testowe Miasto",
        "street": "Testowa Ulica",
        "houseNumber": "1x",
        "apartmentNumber": "2a",
        "postCode": "01-001",
        "countryId": 1,
        "pointId": "Test-123",
        "phone": "123123123",
        "email": "testowy.odbiorca@testowy.odbiorca.pl",
        "contactPerson": "Testowa Osoba"
    },
    "content": "Książki",
    "paymentId": 2,
    "agreements": {
        "receiveElectronicBills": true,
        "processingPersonalData": true
    },
    "addons": [
        {
            "id": 1578,
            "value": 1000
        },
        {
            "id": 632,
            "value": 500,
            "bankAccountNumber": "PL52102051387825000705064082",
            "name": "Name",
            "addressLine1": "Address line 1",
            "swiftCode": "CCFRFRPP"
        }
    ],
    "purpose": "SOLD",
    "collectionType": "POINT",
    "referenceNumber": "TEST/1234"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://test.api.globkurier.pl/v1/order' \
--header 'Accept-Language: pl' \
--header 'X-Auth-Token;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "shipment": {
        "length": 1,
        "width": 1,
        "height": 1,
        "weight": 1,
        "quantity": 1,
        "productId": 2000
    },
    "senderAddress": {
        "name": "Testowy Nadawca",
        "city": "Testowe Miasto",
        "street": "Testowa Ulica",
        "houseNumber": "1x",
        "apartmentNumber": "2a",
        "postCode": "01-001",
        "countryId": 1,
        "pointId": "Test-123",
        "phone": "123123123",
        "email": "testowy.nadawca@testowy.nadawca.pl",
        "contactPerson": "Testowa Osoba"
    },
    "receiverAddress": {
        "name": "Testowy Odbiorca",
        "city": "Testowe Miasto",
        "street": "Testowa Ulica",
        "houseNumber": "1x",
        "apartmentNumber": "2a",
        "postCode": "01-001",
        "countryId": 1,
        "pointId": "Test-123",
        "phone": "123123123",
        "email": "testowy.odbiorca@testowy.odbiorca.pl",
        "contactPerson": "Testowa Osoba"
    },
    "content": "Książki",
    "paymentId": 2,
    "agreements": {
        "receiveElectronicBills": true,
        "processingPersonalData": true
    },
    "addons": [
        {
            "id": 1578,
            "value": 1000
        },
        {
            "id": 632,
            "value": 500,
            "bankAccountNumber": "PL52102051387825000705064082",
            "name": "Name",
            "addressLine1": "Address line 1",
            "swiftCode": "CCFRFRPP"
        }
    ],
    "purpose": "SOLD",
    "collectionType": "POINT",
    "referenceNumber": "TEST/1234"
}'

Responses

🟢201Created

application/json

Body

Example

{}

Modified at 2025-08-11 08:10:55

Get custom required fields

Partial order validation