Postmen logo
Options
  • APC Overnight
  • Aramex
  • Asendia Germany
  • Asendia Hong Kong
  • Australia Post
  • Blue Dart
  • Bonds Couriers
  • Bpost
  • Bpost International
  • Bring
  • Canada Post
  • Canpar
  • Correos Spain
  • Courex
  • Couriers Please
  • Delhivery
  • Deutsche Post DHL
  • DHL Express
  • DHL Global Mail Asia
  • Dotzot
  • DPD Belgium
  • DPD NL
  • DPD UK
  • DPEX
  • DTDC
  • Endicia
  • Fastway Australia
  • FedEx
  • FedEx Smartpost
  • GLS Ireland
  • Grab
  • Hermesworld
  • Hong Kong Post
  • Landmark Global
  • Malaysia Post
  • Mondial Relay
  • New Zealand Post
  • Newgistics
  • Nightline
  • Ninja Van
  • onTrac
  • Pitney Bowes
  • Purolator
  • Quantium
  • S.F. Express
  • S.F. IBS
  • S.F. International
  • S.F. ISP
  • SEKO OmniParcel
  • Sendle
  • SkyNet Worldwide
  • Spanish Seur
  • StarTrack
  • Tai Wan Global Business
  • Taqbin HK
  • TIPSA
  • TNT
  • UPS
  • UPS Mail Innovation
  • USPS
  • Whistl
  • Yamato Japan
  • Yodel
  • API Resources
  • Rates
    • Calculate rates
    • List all rates
    • Retrieve rates
  • Labels
    • Create a label
    • Retrieve a label
    • List all labels
  • Manifests
    • Create a manifest
    • List all manifests
    • Retrieve a manifest
  • Cancel Labels
    • Cancel a label
    • List all cancel labels
    • Retrieve a cancel label
  • Shipper Accounts
    • Create a shipper account
    • Delete a shipper account
    • List all shipper accounts
    • Retrieve a shipper account
    • Update a shipper account credentials
    • Update a shipper account information
    • Update a shipper account
  • Bulk Downloads
    • Create a bulk download
    • List all bulk downloads
    • Retrieve a bulk download
  • Address Validations (Beta)
    • Create an address validation
  • Objects
  • Billing
    • Customs
      • Shipment
        • Address
          • Parcel
            • Item
              • SDKS
              • Node.js
              • PHP
              • Python
              • .NET
              • Java
              • Overview
              • Rate limit
              • Errors
              • Webhooks
              • Security
              • Contact Support

              Response codes - Postmen

              Postmen uses conventional HTTP response codes to indicate success or failure of an API request. In general, codes in the 2xx range indicate success, codes in the 4xx range indicate an error that resulted from the provided information (e.g. a required parameter was missing, a charge failed, etc.), and codes in the 5xx range indicate an error with Postmen's servers.

              Error codes

              Get info about a specific error by using the search.

              Response examples

              Invalid API Key

              {
                "meta": {
                  "code": 4105,
                  "message": "Invalid URL or API key.",
              	"details": [],
              	"retryable": false
                },
                "data": {}
              }

              Server is down

              {
                "meta": {
                  "code": 500,
                  "message": "Something went wrong on AfterShip's end.",
                  "details": [],
                  "retryable": false
                },
                "data": {}
              }