Skip to content
Bookogsend / Developers
Esc
↑↓navigate↵open⌘Jpreview

List available services

Lists available shipping services, package types, and service requirements.

Behavior

  • Availability depends on your account. Use the returned service and package types for shipment requests.

Permission

Any valid Customer API key

See Troubleshooting for authentication, access, rate-limit, and service errors.

GET/services
Authorization
AuthorizationBearer token · headerrequired

Required header: Authorization: Bearer <customer-api-key>. Use a Customer API key with the operation's required permission. Never use a dashboard or webshop token.

Responses
200

Successful result

successanyrequired
messagestringrequired
dataobjectrequired
Show properties
servicesobject[]
Show properties
Array of object
serviceCodestring
namestring
receiverMobileRequiredboolean
receiverPhoneRequiredboolean
receiverEmailRequiredboolean
fieldLimitsobject | null
maxDescriptionLengthnumber
packageTypesServicePackage[]
Show properties
Array of ServicePackage
typestringrequired

Allowed packages[].type for this serviceCode.

unitstringrequired

Pricing unit: by weight or by package count. Package weight is still supplied in kg.

Allowed:KILOGRAMQUANTITY
isPalletbooleanrequired

Whether this package type represents a pallet.

maxWeightnumberrequired

Maximum weight of one package in kg.

maxHeightnumberrequired

Maximum package height in cm.

maxWidthnumberrequired

Maximum package width in cm.

maxLengthnumberrequired

Maximum package length in cm.

requiredPackageFieldsstring[]required

Fields that must be supplied for this package type. International volume-weight pricing can also require length, width, and height.

requestIdstringrequired
400

Invalid input or unsupported operation.

successanyrequired
messagestringrequired
dataanyrequired
requestIdstringrequired
errorCodestringrequired
errorsobject | anyrequired
Show properties
Any of:
object
fieldsobject[]
Show properties
Array of object
pathstringrequired
errorCodestringrequired
messagestringrequired
pricePrice
Show properties
currencystringrequired
baseAmountstringrequired
surchargeAmountstringrequired
palletExchangeAmountstringrequired
taxAmountstringrequired
totalAmountstringrequired
currentStatusstring
retryAfterSecondsinteger
min 1
any
any
404

Resource does not exist or belongs to another account.

successanyrequired
messagestringrequired
dataanyrequired
requestIdstringrequired
errorCodestringrequired
errorsobject | anyrequired
Show properties
Any of:
object
fieldsobject[]
Show properties
Array of object
pathstringrequired
errorCodestringrequired
messagestringrequired
pricePrice
Show properties
currencystringrequired
baseAmountstringrequired
surchargeAmountstringrequired
palletExchangeAmountstringrequired
taxAmountstringrequired
totalAmountstringrequired
currentStatusstring
retryAfterSecondsinteger
min 1
any
any
Request
curl -X GET "https://bookogsend.dk/api/v1/customer/services" \
  -H "Authorization: Bearer YOUR_TOKEN"
Response
{
  "success": true,
  "message": "Available services retrieved.",
  "data": {
    "services": [
      {
        "serviceCode": "BUSINESS_PARCEL",
        "name": "Business Parcel",
        "receiverMobileRequired": false,
        "receiverPhoneRequired": false,
        "receiverEmailRequired": false,
        "fieldLimits": {
          "maxNameLength": 40,
          "maxStreet1Length": 40,
          "maxStreet2Length": 40,
          "maxCityLength": 30,
          "maxContactLength": 40,
          "maxZipCodeLength": 10
        },
        "maxDescriptionLength": 50,
        "packageTypes": [
          {
            "type": "BUSINESS_PARCEL",
            "unit": "KILOGRAM",
            "isPallet": false,
            "maxWeight": 30,
            "maxHeight": 60,
            "maxWidth": 80,
            "maxLength": 200,
            "requiredPackageFields": []
          }
        ]
      },
      {
        "serviceCode": "OTHER",
        "name": "Other Shipment Type",
        "receiverMobileRequired": false,
        "receiverPhoneRequired": false,
        "receiverEmailRequired": false,
        "fieldLimits": null,
        "maxDescriptionLength": 50,
        "packageTypes": []
      }
    ]
  },
  "requestId": "<request-id>"
}