Create order

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 '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

Bodyapplication/json

Example

{
    "number": "GK260520647801",
    "hash": "908f3f1e30acca77376c47cf45f05f1f799f9dc02b4a75bb78b9b89afea41492",
    "price": {
        "currency": "PLN",
        "taxType": "VAT23",
        "vatPercent": 23,
        "totalGrossPrice": 12.56,
        "totalNetPrice": 10.21,
        "netPriceWithoutFuelSurcharge": 9.79,
        "productNetPrice": 0.96,
        "productsNetPrice": 0.96,
        "productsGrossPrice": 1.18,
        "productsStockNetPrice": 0.96,
        "productsStockGrossPrice": 1.18,
        "fuelSurchargeNetPrice": 0.42,
        "fuelSurchargeGrossPrice": 0.52,
        "fuelSurcharge": 0.52,
        "fuelSurchargeStockNetPrice": 0.42,
        "fuelSurchargeStockGrossPrice": 0.52,
        "addonsNetPrice": 8.83,
        "addonsGrossPrice": 10.86,
        "discountNetPrice": 0,
        "packages": [
            {
                "productPrice": 1.18,
                "fuelSurchargePrice": 0.52,
                "fuelSurchargePercent": 44,
                "discountPrice": 0,
                "discountPercent": 0
            }
        ],
        "addons": [
            {
                "value": 1000,
                "valueCurrency": "PLN",
                "id": 1578,
                "addonName": "Ubezpieczenie DPD PICKUP do 1000 PLN",
                "category": "INSURANCE",
                "price": 0.84,
                "priceGross": 1.03,
                "currency": "PLN",
                "quantity": 1,
                "fields": null,
                "inPrice": true
            },
            {
                "value": 500,
                "valueCurrency": "PLN",
                "bankAccountNumber": "PL52102051387825000705064082",
                "swiftCode": "CCFRFRPP",
                "name": "Name",
                "addressLine1": "Address line 1",
                "addressLine2": null,
                "id": 632,
                "addonName": "Za pobraniem (COD) do 3.000 zł w 7 dni",
                "category": "CASH_ON_DELIVERY",
                "price": 7.99,
                "priceGross": 9.83,
                "currency": "PLN",
                "quantity": 1,
                "fields": null,
                "inPrice": true
            }
        ]
    }
}

Modified at 2026-05-20 07:46:28

Get customs config

Partial order validation