1. Orders
GlobKurier
  • Integration via the Globkurier API
    • Introduction (PL)
    • Introduction (EN)
    • Integration Strategy (PL)
    • Integration Strategy (EN)
    • Full Integration (PL)
    • Full Integration (EN)
    • Fast order Integration (PL)
    • Fast order Integration (EN)
    • Pricing Summary before ordering (PL)
    • Pricing Summary before ordering (EN)
    • Shipment search (PL)
    • Shipment search (EN)
    • Crossborder / Points (PL)
    • Crossborder / Points (EN)
    • Labels (PL)
    • Labels (EN)
    • Tracking (PL)
    • Tracking (EN)
    • Get carrier data (PL)
    • Get carrier data (EN)
    • Addon categories (PL)
    • Addon categories (EN)
    • Order with customs (PL)
    • FAQ (PL)
    • FAQ (EN)
    • Przykłady / Examples Crossborder
    • Endpoints
      • Dictionary
        • Addresses
          • Get list of countries
          • Get states for country
          • Get shipment/receiving points
          • Get Polish addresses
          • Get list of cities
        • Carriers
          • Get available carrier list
          • Get shipment/receiving points
        • Finance
          • Get available currency list
        • Orders
          • Get available order content
        • Agreements
          • Get agreements
      • Authentication
        • Generate token
        • Refresh token
        • Remove token
        • Send bot verification code
        • Bot Access validate
      • Fast order
        • Simplified order placement (bestprice)
      • Full integration
        • Get products
        • Get addons for product
        • Get discount code information
        • Get order contents for product
        • Get available courier arrival times to the sender for the shipment
        • Get payments
        • Get bank account numbers
        • Get order price
        • Get custom required fields
        • Get customs config
        • Get customs calculation
        • Create order
        • Partial order validation
        • Create order for courier pick up
        • Get additional product search filters
      • Payments
        • Get list of available methods
        • Generate form data for online order payment
        • Prepaid top-up
        • Changing payment method for online order
      • Orders
        • Get order
          GET
        • Get order list
          GET
        • Delete order
          DELETE
        • Get list of orders for the protocol
          GET
        • Get protocol
          GET
        • Get labels
          GET
        • Get shipment statuses
          GET
        • Get multi-shipment statuses
          GET
        • Get manifest of trade document
          GET
        • Post trade document
          POST
        • Get trade document
          GET
        • Delete trade document
          DELETE
        • Post (sync) trade document
          POST
      • User
        • Get user data
        • Get user coupon data
        • Register user
        • Edit user
        • Get company information
        • Get user invoice list
        • Get invoice
        • Get compressed list of invoices
        • Get invoice email
        • Get account and payment statistics
        • Get list of payment methods
        • Get selected payment method
        • Create selected payment method
        • Remove selected payment method
        • Get order statistics
        • Get list of customs documents for the order
        • Get list of options for saving user preferences
        • Save user preferences
        • Send SMS with a verification code
        • Update SMS-channel agreements
        • Update address data
        • Update EMAIL-channel agreements
        • Update other (no-channel) agreements
        • Update default agreements for orders
        • Update carrier search preferences
        • Correct order
        • Get order correction
        • Get name length restriction
      • Users
        • AddressBook
          • Edit sender contact in address book
          • Add sender contact in address book
          • Delete sender contact from address book
          • Edit receiver contact in address book
          • Add receiver contact in address book
          • Delete receiver contact from address book
          • Get senders contacts from address book
          • Get receiver contacts from address book
          • Import sender contacts to address book
          • Import receiver contacts to address book
        • get company for user
        • Update user currency
        • User return carrier list
        • Manage user return carrier list
      • AddressBook
        • Add sender contact to address book
        • Add receiver contact to address book
        • Get senders address book
        • Get receivers address book
        • Edit sender contact into address book
        • Edit receiver contact into address book
        • Delete sender contact from address book
        • Delete receiver contact from address book Copy
      • Order templates
        • Add template
        • Get tempalate list
        • Edit template
        • Delete template
  • Schemas
    • Schemas
      • VerificationCodeRequestDto
      • UpdatePlatformIntegrationDto
      • UserReturnCarrierRequestDto
      • UpdatePlatformIntegrationResponseDto
      • CreateTokenRequestDto
    • Typy danych
      • Platformy
      • Shipment
      • Currency
      • Pickup
      • UserAddress
      • Address
      • Customs
      • Shipment - BestPrice
      • Address - BestPrice
      • Contact
      • CashOnDelivery
  1. Orders

Get order list

Testing Env
https://test.api.globkurier.pl
Testing Env
https://test.api.globkurier.pl
GET
/v1/orders
Paginated list of the account's orders, newest first. All filters are optional and can be combined.
A sub-account without the company-orders agreement sees only its own orders. filters[numbers][] matches GK order numbers or carrier tracking numbers (exact match); a number that matches nothing returns an empty list, not 400. filters[trackingNumber] and filters[groupId] must exist, otherwise 400.
Use filters[hasCarrierError]=1 to find orders the carrier refused; what can be corrected is returned by Get order correction.

Request

Query Params

Header Params

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --globoff 'https://test.api.globkurier.pl/v1/orders?limit=undefined&offset=undefined&filters[status][]=undefined&filters[statusCrossborder][]=undefined&filters[statusCustoms][]=undefined&filters[isCOD]=undefined&filters[isCustoms]=undefined&filters[hasGroup]=undefined&filters[hasCarrierError]=undefined&filters[transportType]=undefined&filters[carrierNames][]=undefined&filters[dateFrom]=2026-11-01&filters[dateTo]=2026-11-30&filters[receiver]=undefined&filters[sender]=undefined&filters[content]=undefined&filters[numbers][]=GK000000000PL&filters[referenceNumber]=undefined&filters[groupId]=undefined&filters[groupName]=undefined&filters[trackingNumber]=undefined&filters[subUserId]=undefined' \
--header 'X-Auth-Token;' \
--header 'Accept-Language: pl'

Responses

🟢200Success
application/json
Page of orders.
Bodyapplication/json

Example
{
    "limit": 25,
    "offset": 0,
    "total": 1,
    "results": [
        {
            "hash": "6e76c6c8b2227ea1683dcea2f2d36cc0d115cc108f5581186ef4e3ead76b15b3",
            "number": "GK000000000PL",
            "status": "IN_PROGRESS",
            "statusHistory": [
                {
                    "status": "NEW_SHIPMENT",
                    "enteredAt": "2026-11-18 09:12:04"
                },
                {
                    "status": "IN_PROGRESS",
                    "enteredAt": "2026-11-18 14:30:11"
                }
            ],
            "creationDate": "2026-11-18 09:12:04",
            "deliveryDate": null,
            "receiverAddress": {
                "name": "Jan",
                "surname": "Kowalski",
                "street": "Prosta",
                "houseNumber": "12A",
                "apartmentNumber": "5",
                "city": "Kraków",
                "postCode": "30-001",
                "countryId": 1,
                "phone": "500600700",
                "email": "odbiorca@example.com",
                "contactPerson": null,
                "contactPhone": null,
                "nip": null
            },
            "senderAddress": {
                "name": "Firma Przykładowa sp. z o.o.",
                "surname": null,
                "street": "Długa",
                "houseNumber": "1",
                "apartmentNumber": null,
                "city": "Warszawa",
                "postCode": "00-001",
                "countryId": 1,
                "phone": "221234567",
                "email": "nadawca@example.com",
                "contactPerson": "Anna Nowak",
                "contactPhone": "600700800",
                "nip": "1234563218"
            },
            "partner": null,
            "productName": "Standard",
            "carrier": {
                "id": 1,
                "name": "DPD",
                "brandName": "DPD",
                "logo": "https://..."
            },
            "transportType": {
                "code": "Road",
                "name": "Road"
            },
            "group": null,
            "content": "Books",
            "instructions": null,
            "paymentId": 4,
            "paymentStatus": "DEFERRED",
            "pickup": {
                "date": "2026-11-19",
                "timeFrom": "10:00",
                "timeTo": "16:00",
                "availableToRetry": false
            },
            "pricing": {
                "priceNet": 18.5,
                "priceGross": 22.76,
                "vatPercent": 23,
                "currency": "PLN"
            },
            "identifiers": null,
            "protocolAvailable": true,
            "hasCarrierError": false,
            "containsDangerousGoods": false,
            "referenceNumber": "ZAM-1024",
            "trackingNumber": "0000000000000",
            "customDocumentType": null,
            "cashOnDelivery": null,
            "links": [],
            "transportDocuments": [],
            "information": []
        }
    ]
}
🟠400Bad Request
🟠401Unauthorized
Modified at 2026-11-19 14:34:28
Previous
Get order
Next
Delete order
Built with