# Schedule Pickup Pickups endpoint allows you to schedule pickups with USPS, DHL Express, UPS and FedEx carriers for eligible shipments. The pickup schedule scope is determined by what you provide in the request: - If pickupSummary is provided: a pickup is scheduled for the packages described in the summary. - If shipmentIds are provided: a pickup is scheduled for the specified shipments. - If both pickupSummary and shipmentIds are provided: a pickup is scheduled for all shipments including by both inputs. - If neither is provided: a pickup is scheduled for all shipments created on the given carrier account by that time of the day. - carrierAccountId handling: carrierAccountId is required to schedule a pickup. Either provide carrierAccountId in the request payload, or provide X-PB-LocationId with a location that has only one carrier account configured for the selected carrier. > Note: The sender's first name and last name are required for USPS. For example: "name": "John Doe" Endpoint: POST /api/v1/pickups Version: 1.0.0 Security: bearerAuth ## Header parameters: - `X-PB-Developer-Partner-Id` (string) This is the Developer Partner ID. When the developer is the only partner, this field is not required. - `X-PB-LocationId` (string) The X-PB-LocationId header identifies the enterprise, division, or partner location under which a shipment is processed and billed. If this header is not provided, the system automatically uses the enterprise-level location that was created during developer account onboarding. This default location is then used for shipment processing, carrier selection, and billing. Selection Rules ------------------------ - If X-PB-LocationId is provided and the location has one carrier with one account: - carrier is optional - carrierAccountId is optional - The available carrier account is selected and the manifest is created. - If X-PB-LocationId is not provided and the default location has one carrier with one account: - carrier is optional - carrierAccountId is optional - The available carrier account is selected and the manifest is created. ------------------------ - If X-PB-LocationId is provided and the location has one carrier with multiple accounts: - carrier is optional - carrierAccountId is required - The specified carrierAccountId is selected and the manifest is created. - If X-PB-LocationId is not provided and the default location has one carrier with multiple accounts: - carrier is optional - carrierAccountId is required - The specified carrierAccountId is selected and the manifest is created. --------------------------- - If X-PB-LocationId is provided and the location has multiple carriers with one account each: - carrier is required - carrierAccountId is optional - The specified carrier and its associated account are selected and the manifest is created. - If X-PB-LocationId is not provided and the default location has multiple carriers with one account each: - carrier is required - carrierAccountId is optional - The specified carrier and its associated account are selected and the manifest is created. ---------------------------- - If X-PB-LocationId is provided and the location has multiple carriers with multiple accounts: - carrier is optional - carrierAccountId is required - The specified carrierAccountId is selected and the manifest is created. - If X-PB-LocationId is not provided and the default location has multiple carriers with multiple accounts: - carrier is optional - carrierAccountId is required - The specified carrierAccountId is selected and the manifest is created. ----------------------------- ## Request fields (application/json): - `body` (DHLExpress (object) or USPS (object) or UPS (object) or FedEx (object) or Purolator (object) or CPC (object) or Freight Carriers (object), required) — one of: - DHLExpress: - `packageLocation` (string, required) The location where the parcel will be available for pickup at the specified pickup address. Enum: "Front", "Back", "Reception", "Loading Dock" - `carrierAccountId` (string) The unique identifier of the carrier account being used to process the pickup. Example: "wgjYXvYjD0V4" - `pickupAddress` (object, required) Example: {"name":"Test","addressLine1":"27 Waterview Dr","cityTown":"Shelton","stateProvince":"CT","postalCode":"06484-4301","countryCode":"US","phone":"1234567890","company":"PB","email":"ankita.chaurasia@pb.com"} - `pickupAddress.name` (string, required) The name of the person or entity at the pickup address. Example: "Test" - `pickupAddress.addressLine1` (string, required) First line of the address where the pickup will occur. Example: "27 Waterview Dr" - `pickupAddress.cityTown` (string) The city or town where the pickup address is located. Example: "Shelton" - `pickupAddress.stateProvince` (string) The state or province of the pickup address. For a US or Canadian address, it is the 2-letter state or province code. Example: "CT" - `pickupAddress.postalCode` (string, required) The postal or ZIP code for the pickup address. For US addresses, use either the 5-digit or 9-digit ZIP Code in one of the following formats: '12345' or '12345-6789'. If you use a different format, such as 12345- or 123451234, will receive an error. Example: "06484-4301" - `pickupAddress.countryCode` (string, required) The two-letter country code for the pickup address. Example: "US" - `pickupAddress.phone` (string, required) The contact phone number for the pickup location. Example: "1234567890" - `pickupAddress.company` (string) The name of the company at the pickup address, if the recipient address is not residential. Example: "PB" - `pickupAddress.email` (string) The email address associated with the pickup location. Example: "ankita.chaurasia@pb.com" - `pickupSummary` (array) An array of the pickup details, including the number of packages, total weight, and carrier service information and package details. Example: [{"serviceId":"NDA","packageCount":1,"totalWeight":15,"weightUnit":"OZ","packageDetails":[{"width":1,"height":15,"length":10,"dimUnit":"IN","weightUnit":"OZ","weight":15}],"currencyCode":"USD","totalCustomsDeclaredValue":5}] - `pickupSummary.serviceId` (string) The abbreviated name of the carrier-specific service. Example: "NDA" - `pickupSummary.packageCount` (number) The total number of packages being picked up. Example: 2 - `pickupSummary.totalWeight` (number) The total weight of all packages to be picked up, measured in units supported by the carrier in the origin country. The value is a decimal with up to 2 decimal places. Example: 15 - `pickupSummary.weightUnit` (string) The unit of measurement for the total package weight. Example: "OZ" - `pickupSummary.currencyCode` (string) The currency code (e.g., 'USD') for the cost of the pickup service, if applicable. Example: "USD" - `pickupSummary.totalCustomsDeclaredValue` (number) Total customs declared value - `pickupSummary.packageDetails` (array) Details of each package being picked up, including package dimensions and weight. - `pickupSummary.packageDetails.width` (number) The width of the package in the unit specified by dimUnit. Example: 1 - `pickupSummary.packageDetails.height` (number) The height of the package in the unit specified by dimUnit. Example: 15 - `pickupSummary.packageDetails.length` (number) The length of the package in the unit specified by dimUnit. Example: 10 - `pickupSummary.packageDetails.dimUnit` (string) The unit of measurement for the package dimensions. Example: "IN" - `pickupSummary.packageDetails.weightUnit` (string) The unit of measurement for the package weight. Example: "OZ" - `pickupSummary.packageDetails.weight` (number) The weight of the package in the unit specified by weightUnit. Example: 1 - `additionalnotes` (string) Additional instructions or notes for the carrier regarding the pickup. Example: "Call before pickup" - `reference` (string) An optional Reference related to the pickup. Example: "reference" - `shipmentIds` (array) List of shipment IDs for which pickup needs to be scheduled. Example: ["DHLEXP2201736600235437","DHLEXP2201736600264906"] - `pickupOptions` (object, required) Example: {"pickupStartDateTime":"2025-09-29T09:05:05Z","pickupEndDateTime":"2025-09-29T18:30:00Z","carrierType":"EXPRESS","overweight":2} - `pickupOptions.pickupStartDateTime` (string) The start date and time for the pickup in ISO 8601 format. This indicates when the pickup window begins. Example: "2025-09-29T09:05:05Z" - `pickupOptions.pickupEndDateTime` (string) The end date and time for the pickup in ISO 8601 format. This indicates when the pickup window closes. Example: "2025-09-29T18:30:00Z" - `pickupOptions.overweight` (integer) The number of overweight packages in the pickup. This represents the number of packages that exceed the carrier's weight limit. Example: 2 - `pickupOptions.carrierType` (string) The type of carrier used for the pickup. Enum: "EXPRESS", "GROUND" - USPS: - `packageLocation` (string, required) The location where the parcel will be available for pickup at the specified pickup address. Enum: "Front Door", "Back Door", "Side Door", "Knock on Door/Ring Bell", "Mail Room", "Office", "Reception", "In/At Mailbox", "Other" - `carrierAccountId` (string) The unique identifier of the carrier account being used to process the pickup. Example: "En9jM8bB8eAZ" - `pickupAddress` (object, required) Example: {"addressLine1":"27 Waterview Dr","cityTown":"Shelton","company":"PB","countryCode":"US","email":"sender@email.com","name":"Test","phone":"2124567890","postalCode":"06484-4301","stateProvince":"CT"} - `pickupAddress.name` (string, required) The name of the person or entity at the pickup address. Example: "Test" - `pickupAddress.addressLine1` (string, required) First line of the address where the pickup will occur. Example: "27 Waterview Dr" - `pickupAddress.cityTown` (string) The city or town where the pickup address is located. Example: "Shelton" - `pickupAddress.stateProvince` (string) The state or province of the pickup address. For a US or Canadian address, it is the 2-letter state or province code. Example: "CT" - `pickupAddress.postalCode` (string, required) The postal or ZIP code for the pickup address. For US addresses, use either the 5-digit or 9-digit ZIP Code in one of the following formats: '12345' or '12345-6789'. If you use a different format, such as 12345- or 123451234, will receive an error. Example: "06484-4301" - `pickupAddress.countryCode` (string, required) The two-letter country code for the pickup address. Example: "US" - `pickupAddress.phone` (string, required) The contact phone number for the pickup location. Example: "2124567890" - `pickupAddress.company` (string) The name of the company at the pickup address, if the recipient address is not residential. Example: "PB" - `pickupAddress.email` (string) The email address associated with the pickup location. Example: "sender@email.com" - `pickupSummary` (array) An array of the pickup details, including the number of packages, total weight, and carrier service information. Example: [{"packageCount":111,"serviceId":"EM","totalWeight":45435,"weightUnit":"GM"}] - `pickupSummary.serviceId` (string) The abbreviated name of the carrier-specific service. Example: "NDA" - `pickupSummary.packageCount` (number) The total number of packages being picked up. Example: 2 - `pickupSummary.totalWeight` (number) The total weight of all packages to be picked up, measured in units supported by the carrier in the origin country. The value is a decimal with up to 2 decimal places. Example: 15 - `pickupSummary.weightUnit` (string) The unit of measurement for the total package weight. Example: "OZ" - `additionalnotes` (string) Additional instructions or notes for the carrier regarding the pickup. Value is required when packageLocation is set to other. Example: "notes" - `reference` (string) An optional Reference related to the pickup. Example: "reference" - `shipmentIds` (array) A comma-separated list of shipment IDs associated with the pickup request. Example: ["USPS2201674200253944"] - `pickupOptions` (object) - `pickupOptions.pickupStartDateTime` (string) The start date and time for the pickup in ISO 8601 format. This indicates when the pickup window begins. Example: "2024-10-10T17:03:05Z" - `pickupOptions.pickupEndDateTime` (string) The end date and time for the pickup in ISO 8601 format. This indicates when the pickup window closes. Example: "2024-10-10T17:05:05Z" - `pickupOptions.overweight` (integer) The number of overweight packages in the pickup. This represents the number of packages that exceed the carrier's weight limit. Example: 2 - UPS: - `packageLocation` (string, required) The location where the parcel will be available for pickup at the specified pickup address. Enum: "Front Door", "Back Door", "Side Door", "Knock on Door/Ring Bell", "Mail Room", "Office", "Reception", "In/At Mailbox", "Other", "Garage", "Downstairs", "Third Party", "Warehouse" - `carrierAccountId` (string) The unique identifier of the carrier account being used to process the pickup. Example: "j4pqLKjQ5dn" - `pickupAddress` (object, required) - `pickupAddress.name` (string, required) The name of the person or entity at the pickup address. Example: "Test" - `pickupAddress.addressLine1` (string, required) First line of the address where the pickup will occur. Example: "27 Waterview Dr" - `pickupAddress.cityTown` (string) The city or town where the pickup address is located. Example: "Shelton" - `pickupAddress.stateProvince` (string) The state or province of the pickup address. For a US or Canadian address, it is the 2-letter state or province code. Example: "CT" - `pickupAddress.postalCode` (string, required) The postal or ZIP code for the pickup address. For US addresses, use either the 5-digit or 9-digit ZIP Code in one of the following formats: '12345' or '12345-6789'. If you use a different format, such as 12345- or 123451234, will receive an error. Example: "06484-4301" - `pickupAddress.countryCode` (string, required) The two-letter country code for the pickup address. Example: "US" - `pickupAddress.phone` (string, required) The contact phone number for the pickup location. Example: "1234567890" - `pickupAddress.company` (string) The name of the company at the pickup address, if the recipient address is not residential. Example: "PB" - `pickupAddress.email` (string) The email address associated with the pickup location. Example: "ankita.chaurasia@pb.com" - `pickupSummary` (array) An array of the pickup details, including the number of packages, total weight, and carrier service information. - `pickupSummary.serviceId` (string) The abbreviated name of the carrier-specific service. Example: "NDA" - `pickupSummary.packageCount` (number) The total number of packages being picked up. Example: 2 - `pickupSummary.totalWeight` (number) The total weight of all packages to be picked up, measured in units supported by the carrier in the origin country. The value is a decimal with up to 2 decimal places. Example: 15 - `pickupSummary.weightUnit` (string) The unit of measurement for the total package weight. Example: "OZ" - `pickupSummary.parcelType` (string) Parcel Type is required for creating a shipment while rating a parcel, which varies as per Carrier selection. Here, it reflects as per the defined ParcelType Rules. ParcelType have categories like Package, Envelopes, Paks, Boxes, Tube, etc. Example: "PKG" - `pickupSummary.toAddressCountryCode` (string) The two-letter country code of the destination country for the shipment. Example: "US" - `additionalnotes` (string) Additional instructions or notes for the carrier regarding the pickup. Value is required when packageLocation is set to other. Example: "Call before pickup" - `reference` (string) An optional Reference related to the pickup. Example: "zscsdc" - `pickupOptions` (object, required) - `pickupOptions.pickupStartDateTime` (string) The start date and time for the pickup in ISO 8601 format. This indicates when the pickup window begins. Example: "2024-10-10T17:03:05Z" - `pickupOptions.pickupEndDateTime` (string) The end date and time for the pickup in ISO 8601 format. This indicates when the pickup window closes. Example: "2024-10-10T17:05:05Z" - `pickupOptions.overweight` (integer) The number of overweight packages in the pickup. This represents the number of packages that exceed the carrier's weight limit. Example: 2 - FedEx: - `packageLocation` (string, required) The location where the parcel will be available for pickup at the specified pickup address. Enum: "Front", "None", "Side", "REAR" - `carrierAccountId` (string) The unique identifier of the carrier account being used to process the pickup. Example: "OVJMdgGYNvrx" - `pickupAddress` (object, required) Example: {"name":"Test","addressLine1":"27 Waterview Dr","cityTown":"Shelton","stateProvince":"CT","postalCode":"06484-4301","countryCode":"US","phone":"1234567890","company":"PB","email":"sender@email.com"} - `pickupAddress.name` (string, required) The name of the person or entity at the pickup address. Example: "Test" - `pickupAddress.addressLine1` (string, required) First line of the address where the pickup will occur. Example: "27 Waterview Dr" - `pickupAddress.cityTown` (string) The city or town where the pickup address is located. Example: "Shelton" - `pickupAddress.stateProvince` (string) The state or province of the pickup address. For a US or Canadian address, it is the 2-letter state or province code. Example: "CT" - `pickupAddress.postalCode` (string, required) The postal or ZIP code for the pickup address. For US addresses, use either the 5-digit or 9-digit ZIP Code in one of the following formats: '12345' or '12345-6789'. If you use a different format, such as 12345- or 123451234, will receive an error. Example: "06484-4301" - `pickupAddress.countryCode` (string, required) The two-letter country code for the pickup address. Example: "US" - `pickupAddress.phone` (string, required) The contact phone number for the pickup location. Example: "1234567890" - `pickupAddress.company` (string) The name of the company at the pickup address, if the recipient address is not residential. Example: "PB" - `pickupAddress.email` (string) The email address associated with the pickup location. Example: "sender@email.com" - `pickupSummary` (array) An array of the pickup details, including the number of packages, total weight, and carrier service information. Example: [{"serviceId":"2DA","packageCount":1,"totalWeight":15,"weightUnit":"OZ","totalCustomsDeclaredValue":5}] - `pickupSummary.serviceId` (string) The abbreviated name of the carrier-specific service. Example: "NDA" - `pickupSummary.packageCount` (number) The total number of packages being picked up. Example: 2 - `pickupSummary.totalWeight` (number) The total weight of all packages to be picked up, measured in units supported by the carrier in the origin country. The value is a decimal with up to 2 decimal places. Example: 15 - `pickupSummary.weightUnit` (string) The unit of measurement for the total package weight. Example: "OZ" - `pickupSummary.parcelType` (string) Parcel Type is required for creating a shipment while rating a parcel, which varies as per Carrier selection. Here, it reflects as per the defined ParcelType Rules. ParcelType have categories like Package, Envelopes, Paks, Boxes, Tube, etc. Example: "PKG" - `additionalnotes` (string) Additional instructions or notes for the carrier regarding the pickup. Value is required when packageLocation is set to other. Example: "notes" - `reference` (string) An optional Reference related to the pickup. Example: "reference" - `pickupOptions` (object, required) Pickup window options Example: {"pickupStartDateTime":"2025-09-29T12:04:05Z","pickupEndDateTime":"2025-09-29T18:30:00Z","overweight":1,"carrierType":"EXPRESS"} - `pickupOptions.pickupStartDateTime` (string, required) The start date and time for the pickup in ISO 8601 format. This indicates when the pickup window begins. Example: "2025-09-29T12:04:05Z" - `pickupOptions.pickupEndDateTime` (string, required) The end date and time for the pickup in ISO 8601 format. This indicates when the pickup window closes. Example: "2025-09-29T18:30:00Z" - `pickupOptions.overweight` (integer) The number of overweight packages in the pickup. This represents the number of packages that exceed the carrier's weight limit. Example: 1 - `pickupOptions.carrierType` (string, required) The type of carrier used for the pickup. Example: "EXPRESS" - Purolator: - `packageLocation` (string, required) The location where the shipment will be available for pickup at the specified pickup address. Enum: "NONE", "Front Door", "Back Door", "Side Door", "Shipping", "Receiving", "Mail Room", "Garage", "Office", "Reception", "In/At Mailbox", "Warehouse", "Basement", "Between Doors", "Counter", "Desk", "Front Desk", "Front Porch", "Gate House", "Kiosk", "Lab", "Loading Dock", "Lobby", "Mailbox", "Outside Door", "Parts Department", "Pharmacy", "Pro Shop", "Security", "Service Counter", "Switchboard", "Vault" - `carrierAccountId` (string) The unique identifier of the carrier account being used to process the pickup. Example: "worba68A1zDr" - `pickupAddress` (object, required) - `pickupAddress.name` (string, required) The name of the person or entity at the pickup address. Example: "Paul Wright" - `pickupAddress.addressLine1` (string, required) First line of the address where the pickup will occur. Example: "638 Manitoba Ave1" - `pickupAddress.cityTown` (string) The city or town where the pickup address is located. Example: "Winnipeg" - `pickupAddress.stateProvince` (string) The state or province of the pickup address. For a US or Canadian address, use the 2-letter state or province code. Example: "MB" - `pickupAddress.postalCode` (string, required) The postal or ZIP code for the pickup address. For US addresses, use either the 5-digit or 9-digit ZIP Code in one of the following formats: '12345' or '12345-6789'. If you use a different format, such as 12345- or 123451234, an error is returned. Example: "R2W 2H2" - `pickupAddress.countryCode` (string, required) The two-letter country code for the pickup address. Example: "CA" - `pickupAddress.phone` (string, required) The contact phone number for the pickup location. Example: "203-555-1213" - `pickupAddress.company` (string) The company name at the pickup address, if applicable. Example: "PB" - `pickupAddress.email` (string) The email address associated with the pickup location. Example: "sender@email.com" - `pickupSummary` (array) An array of the pickup details, including the number of packages, total weight, and carrier service information. - `pickupSummary.serviceId` (string) The abbreviated name of the carrier-specific service. Example: "NDA_AM" - `pickupSummary.packageCount` (number) The total number of packages being picked up. Example: 12 - `pickupSummary.totalWeight` (number) The total weight of all packages to be picked up, measured in units supported by the carrier in the origin country. The value is a decimal with up to 2 decimal places. Example: 320 - `pickupSummary.weightUnit` (string) The unit of measurement for the total package weight. Example: "GM" - `pickupSummary.parcelType` (string) The type of parcel used for the shipment, as defined by the carrier. Common values include 'PKG' for package, 'ENVELOPE', 'BOX', etc. Example: "PKG" - `pickupSummary.toAddressCountryCode` (string) Destination country code. Example: "CA" - `reference` (string) An optional Reference related to the pickup. Example: "reference" - `pickupOptions` (object, required) Pickup window and freight-specific pickup details. - `pickupOptions.pickupStartDateTime` (string, required) The start date and time for the pickup in ISO 8601 format. Example: "2026-05-07T14:04:05Z" - `pickupOptions.pickupEndDateTime` (string, required) The end date and time for the pickup in ISO 8601 format. Example: "2026-05-07T16:30:00Z" - CPC: - `packageLocation` (string) The location where the shipment will be available for pickup at the specified pickup address. Enum: "NONE", "Front Door", "Back Door", "Side Door", "Shipping", "Receiving", "Knock on Door/Ring Bell", "Mail Room", "Garage", "Office", "Downstairs", "Reception", "In/At Mailbox", "Third Party", "Warehouse", "Other" - `carrierAccountId` (string) The unique identifier of the carrier account being used to process the pickup. Example: "wljXGR2pRqyB" - `pickupAddress` (object, required) - `pickupAddress.addressLine1` (string, required) First line of the address where the pickup will occur. Example: "638 Manitoba Ave1" - `pickupAddress.cityTown` (string) The city or town where the pickup address is located. Example: "Winnipeg" - `pickupAddress.company` (string) The name of the company at the pickup address, if the recipient address is not residential. Example: "PB & Company" - `pickupAddress.countryCode` (string, required) The two-letter country code for the pickup address. Example: "CA" - `pickupAddress.email` (string) The email address associated with the pickup location. Example: "sender@email.com" - `pickupAddress.name` (string, required) The name of the person or entity at the pickup address. Example: "Paul Wright" - `pickupAddress.phone` (string, required) The contact phone number for the pickup location. Example: "203-555-1213" - `pickupAddress.postalCode` (string, required) The postal or ZIP code for the pickup address. Example: "R2W2H2" - `pickupAddress.stateProvince` (string) The state or province of the pickup address. For a US or Canadian address, it is the 2-letter state or province code. Example: "MB" - `shipmentIds` (array) An array of shipment identifiers associated with the pickup request. Example: ["CPC2202644757662548"] - `pickupSummary` (array) An array of the pickup details, including the number of packages, total weight, and carrier service information. - `pickupSummary.serviceId` (string) The abbreviated name of the carrier-specific service. Example: "NDA" - `pickupSummary.packageCount` (number) The total number of packages being picked up. Example: 5 - `pickupSummary.totalWeight` (number) The total weight of all packages to be picked up, measured in units supported by the carrier in the origin country. The value is a decimal with up to 2 decimal places. Example: 320 - `pickupSummary.weightUnit` (string) The unit of measurement for the total package weight. Example: "GM" - `pickupSummary.parcelType` (string) The type of parcel used for the shipment, as defined by the carrier. Common values include 'PKG' for package, 'ENVELOPE', 'BOX', etc. Example: "PKG" - `additionalNotes` (string, required) Additional instructions or notes for the carrier regarding the pickup. Example: "notes" - `reference` (string) An optional Reference related to the pickup. Example: "reference" - `pickupOptions` (object, required) Pickup window and freight-specific pickup details. - `pickupOptions.pickupStartDateTime` (string, required) The start date and time for the pickup in ISO 8601 format. Example: "2026-05-07T14:00:00Z" - `pickupOptions.pickupEndDateTime` (string, required) The end date and time for the pickup in ISO 8601 format. Example: "2026-05-07T15:00:00Z" - Freight Carriers: - `packageLocation` (string, required) The location where the shipment will be available for pickup at the specified pickup address. Example: "NONE" - `carrierAccountId` (string, required) The unique identifier of the carrier account being used to process the pickup. Example: "GkYM3AdrM8nE7P5" - `pickupAddress` (object, required) - `pickupAddress.name` (string, required) The name of the person or entity at the pickup address. Example: "Test" - `pickupAddress.addressLine1` (string, required) First line of the address where the pickup will occur. Example: "27 Waterview Dr" - `pickupAddress.cityTown` (string) The city or town where the pickup address is located. Example: "Shelton" - `pickupAddress.stateProvince` (string) The state or province of the pickup address. For a US or Canadian address, use the 2-letter state or province code. Example: "CT" - `pickupAddress.postalCode` (string, required) The postal or ZIP code for the pickup address. For US addresses, use either the 5-digit or 9-digit ZIP Code in one of the following formats: '12345' or '12345-6789'. If you use a different format, such as 12345- or 123451234, an error is returned. Example: "06484-4301" - `pickupAddress.countryCode` (string, required) The two-letter country code for the pickup address. Example: "US" - `pickupAddress.phone` (string, required) The contact phone number for the pickup location. Example: "2124567890" - `pickupAddress.company` (string) The company name at the pickup address, if applicable. Example: "PB" - `pickupAddress.email` (string) The email address associated with the pickup location. Example: "sender@email.com" - `shipmentIds` (array, required) The list of shipment IDs included in the pickup request. Example: ["794797605985"] - `pickupOptions` (object, required) Pickup window and freight-specific pickup details. - `pickupOptions.pickupStartDateTime` (string, required) The start date and time for the pickup in ISO 8601 format. Example: "2026-04-01T09:00:00Z" - `pickupOptions.pickupEndDateTime` (string, required) The end date and time for the pickup in ISO 8601 format. Example: "2026-04-01T17:00:00Z" - `pickupOptions.overweight` (integer) The number of overweight packages in the pickup. Example: 2 - `pickupOptions.directDetailType` (string) The direct detail type for the freight pickup. > directDetailType is required for carrier FedEx Freight. Example: "BASIC" - `pickupOptions.directDetailTransportationType` (string) The transportation type for the freight pickup. > directDetailTransportationType is required for carrier FedEx Freight. Example: "PICKUP" - `pickupOptions.directDetailEmail` (string) Email address of the contact person available at the pickup location. > directDetailEmail is required for carrier FedEx Freight. Example: "ritesh.pawar@pb.com" - `pickupOptions.directDetailPhoneNumberType` (string) Type of phone number provided for the pickup contact. > directDetailPhoneNumberType is required for carrier FedEx Freight. Example: "MOBILE" - `pickupOptions.directDetailPhone` (string) Phone number of the contact person available at the pickup location. > directDetailPhone is required for carrier FedEx Freight. Example: "4406539321" ## Response 200 fields (application/json): - `body` (DHLExpress (object) or USPS (object) or UPS (object) or Purolator (object) or CPC (object) or FedEx (object)) — one of: - DHLExpress: - `packageLocation` (string) The location where the parcel will be available for pickup at the specified pickup address. Enum: same as `packageLocation` in "DHLExpress" (4 values) - `pickupConfirmationNumber` (string) The confirmation number generated when the pickup request is successfully processed. Example: "AME250929000197" - `pickupId` (string) A unique identifier for the scheduled pickup. Example: "DHLEXP09261758885311045" - `carrier` (string) The carrier being used for the pickup. Example: "dhlexp" - `carrierAccountId` (string) The unique identifier of the carrier account being used to process the pickup. Example: "wgjYXvYjD0V4" - `pickupAddress` (object) Example: {"addressLine1":"27 Waterview Dr","cityTown":"Shelton","company":"PB","countryCode":"US","email":"ankita.chaurasia@pb.com","name":"Test","phone":"1234567890","postalCode":"06484-4301","residential":false,"stateProvince":"CT"} - `pickupAddress.name` (string) The name of the person or entity at the pickup address. Example: "Test" - `pickupAddress.addressLine1` (string) First line of the address where the pickup will occur. Example: "27 Waterview Dr" - `pickupAddress.cityTown` (string) The city or town where the pickup address is located. Example: "Shelton" - `pickupAddress.stateProvince` (string) The state or province of the pickup address. For a US or Canadian address, it is the 2-letter state or province code. Example: "CT" - `pickupAddress.postalCode` (string) The postal or ZIP code for the pickup address. For US addresses, use either the 5-digit or 9-digit ZIP Code in one of the following formats: '12345' or '12345-6789'. If you use a different format, such as 12345- or 123451234, will receive an error. Example: "06484-4301" - `pickupAddress.countryCode` (string) The two-letter country code for the pickup address. Example: "US" - `pickupAddress.phone` (string) The contact phone number for the pickup location. Example: "1234567890" - `pickupAddress.company` (string) The name of the company at the pickup address, if the recipient address is not residential. Example: "PB" - `pickupAddress.email` (string) The email address associated with the pickup location. Example: "ankita.chaurasia@pb.com" - `pickupAddress.residential` (boolean) Indicates whether the pickup address is a residential location. Set to 'false' for commercial addresses. - `pickupSummary` (array) An array of the pickup details, including the number of packages, total weight, and carrier service information. Example: [{"serviceId":"NDA","packageCount":1,"totalWeight":15,"weightUnit":"OZ","totalCustomsDeclaredValue":5,"currencyCode":"USD"},{"serviceId":"NDA","packageCount":2,"totalWeight":20,"weightUnit":"OZ"}] - `pickupSummary.serviceId` (string) The abbreviated name of the carrier-specific service. Example: "NDA" - `pickupSummary.packageCount` (number) The total number of packages being picked up. Example: 2 - `pickupSummary.totalWeight` (number) The total weight of all packages to be picked up, measured in units supported by the carrier in the origin country. The value is a decimal with up to 2 decimal places. Example: 15 - `pickupSummary.weightUnit` (string) The unit of measurement for the total package weight. Example: "OZ" - `pickupSummary.currencyCode` (string) The currency code (e.g., 'USD') for the cost of the pickup service, if applicable. Example: "USD" - `additionalNotes` (string) Additional instructions or notes for the carrier regarding the pickup. Example: "absdhda" - `pickupDateTime` (string) The sdate and time of the pickup window. Example: "2025-09-29T09:05:00Z" - `pickupTotalWeight` (number) The total weight of all packages being picked up. Example: 35 - `pickupTotalWeightUnit` (string) The unit of measurement for the total package weight. Example: "OZ" - `reference` (string) An optional Reference related to the pickup. Example: "reference" - `pickupOptions` (object) Example: {"pickupStartDateTime":"2025-09-29T09:05:05Z","pickupEndDateTime":"2025-09-29T18:30:00Z","overweight":2,"carrierType":"EXPRESS"} - `pickupOptions.pickupStartDateTime` (string) The start date and time for the pickup in ISO 8601 format. This indicates when the pickup window begins. Example: "2025-09-29T09:05:05Z" - `pickupOptions.pickupEndDateTime` (string) The end date and time for the pickup in ISO 8601 format. This indicates when the pickup window closes. Example: "2025-09-29T18:30:00Z" - `pickupOptions.overweight` (integer) The number of overweight packages in the pickup. This represents the number of packages that exceed the carrier's weight limit. Example: 2 - `pickupOptions.carrierType` (integer) The type of carrier is being used for pickup. Example: "EXPRESS" - USPS: - `packageLocation` (string) The location where the parcel will be available for pickup at the specified pickup address. Example: "Back Door" - `carrierAccountId` (string) The unique identifier of the carrier account being used to process the pickup. Example: "En9jM8bB8eAZ" - `pickupConfirmationNumber` (string) The confirmation number generated when the pickup request is successfully processed. Example: "WTC65273674" - `pickupId` (string) A unique identifier for the scheduled pickup. Example: "USPSSKV539D3F8Z8" - `carrier` (string) The carrier being used for the pickup. Example: "usps" - `pickupAddress` (object) Example: {"addressLine1":"27 WATERVIEW DR","cityTown":"SHELTON","company":"PB","countryCode":"US","email":"sender@email.com","name":"Test","phone":"2124567890","postalCode":"06484","residential":false,"stateProvince":"CT"} - `pickupAddress.name` (string) The name of the person or entity at the pickup address. Example: "Test" - `pickupAddress.addressLine1` (string) First line of the address where the pickup will occur. Example: "27 WATERVIEW DR" - `pickupAddress.cityTown` (string) The city or town where the pickup address is located. Example: "SHELTON" - `pickupAddress.stateProvince` (string) The state or province of the pickup address. For a US or Canadian address, it is the 2-letter state or province code. Example: "CT" - `pickupAddress.postalCode` (string) The postal or ZIP code for the pickup address. For US addresses, use either the 5-digit or 9-digit ZIP Code in one of the following formats: '12345' or '12345-6789'. If you use a different format, such as 12345- or 123451234, will receive an error. Example: "06484" - `pickupAddress.countryCode` (string) The two-letter country code for the pickup address. Example: "US" - `pickupAddress.phone` (string) The contact phone number for the pickup location. Example: "2124567890" - `pickupAddress.company` (string) The name of the company at the pickup address, if the recipient address is not residential. Example: "PB" - `pickupAddress.email` (string) The email address associated with the pickup location. Example: "sender@email.com" - `pickupAddress.residential` (boolean) Indicates whether the pickup address is a residential location. Set to 'false' for commercial addresses. - `pickupSummary` (array) An array of the pickup details, including the number of packages, total weight, and carrier service information. Example: [{"serviceId":"EM","packageCount":111,"totalWeight":45435,"weightUnit":"GM"}] - `pickupSummary.serviceId` (string) The abbreviated name of the carrier-specific service. Example: "EM" - `pickupSummary.packageCount` (number) The total number of packages being picked up. Example: 2 - `pickupSummary.totalWeight` (number) The total weight of all packages to be picked up, measured in units supported by the carrier in the origin country. The value is a decimal with up to 2 decimal places. Example: 15 - `pickupSummary.weightUnit` (string) The unit of measurement for the total package weight. Example: "OZ" - `additionalNotes` (string) Additional instructions or notes for the carrier regarding the pickup. Example: "notes" - `reference` (string) An optional Reference related to the pickup. Example: "reference" - `shipmentIds` (array) A comma-separated list of shipment IDs. Example: ["USPS2201674200253944"] - `pickupDateTime` (string) The date and time of the pickup. Example: "09/20/2025" - `pickupTotalWeight` (number) The total weight of all packages being picked up. Example: 45559.35 - `pickupTotalWeightUnit` (string) The unit of measurement for the total package weight. Example: "GM" - UPS: - `packageLocation` (string) The location where the parcel will be available for pickup at the specified pickup address. Example: "None" - `pickupConfirmationNumber` (string) The confirmation number generated when the pickup request is successfully processed. Example: "2929602E9CP" - `pickupId` (string) A unique identifier for the scheduled pickup. Example: "UPS10191697701340901" - `carrier` (string) The carrier being used for the pickup. Example: "ups" - `carrierAccountId` (string) The unique identifier of the carrier account being used to process the pickup. Example: "j4pqLKjQ5dn" - `pickupAddress` (object) - `pickupAddress.name` (string) The name of the person or entity at the pickup address. Example: "Test" - `pickupAddress.addressLine1` (string) First line of the address where the pickup will occur. Example: "27 Waterview Dr" - `pickupAddress.cityTown` (string) The city or town where the pickup address is located. Example: "Shelton" - `pickupAddress.stateProvince` (string) The state or province of the pickup address. For a US or Canadian address, it is the 2-letter state or province code. Example: "CT" - `pickupAddress.postalCode` (string) The postal or ZIP code for the pickup address. For US addresses, use either the 5-digit or 9-digit ZIP Code in one of the following formats: '12345' or '12345-6789'. If you use a different format, such as 12345- or 123451234, will receive an error. Example: "06484-4301" - `pickupAddress.countryCode` (string) The two-letter country code for the pickup address. Example: "US" - `pickupAddress.phone` (string) The contact phone number for the pickup location. Example: "1234567890" - `pickupAddress.company` (string) The name of the company at the pickup address, if the recipient address is not residential. Example: "PB" - `pickupAddress.email` (string) The email address associated with the pickup location. Example: "ankita.chaurasia@pb.com" - `pickupAddress.residential` (boolean) Indicates whether the pickup address is a residential location. Set to 'false' for commercial addresses. - `pickupSummary` (array) An array of the pickup details, including the number of packages, total weight, and carrier service information. - `pickupSummary.serviceId` (string) The abbreviated name of the carrier-specific service. Example: "NDA" - `pickupSummary.packageCount` (number) The total number of packages being picked up. Example: 2 - `pickupSummary.totalWeight` (number) The total weight of all packages to be picked up, measured in units supported by the carrier in the origin country. The value is a decimal with up to 2 decimal places. Example: 15 - `pickupSummary.weightUnit` (string) The unit of measurement for the total package weight. Example: "OZ" - `pickupSummary.toAddressCountryCode` (string) The two-letter country code of the destination country for the shipment. Example: "US" - `pickupSummary.parcelType` (string) description Example: "PKG" - `additionalnotes` (string) Additional instructions or notes for the carrier regarding the pickup. Value is required when packageLocation is set to other. Example: "Call before pickup" - `reference` (string) An optional Reference related to the pickup. Example: "zscsdc" - `pickupDateTime` (string) The date and time of the pickup. Example: "2024-10-10T17:05:05Z" - `pickupTotalWeight` (number) The total weight of all packages being picked up. Example: 16 - `pickupTotalWeightUnit` (string) The unit of measurement for the total package weight. Example: "OZ" - `pickupOptions` (object) - `pickupOptions.pickupStartDateTime` (string) The start date and time for the pickup in ISO 8601 format. This indicates when the pickup window begins. Example: "2024-10-10T17:03:05Z" - `pickupOptions.pickupEndDateTime` (string) The end date and time for the pickup in ISO 8601 format. This indicates when the pickup window closes. Example: "2024-10-10T17:05:05Z" - `pickupOptions.overweight` (integer) The number of overweight packages in the pickup. This represents the number of packages that exceed the carrier's weight limit. Example: 2 - Purolator: - `carrierAccountId` (string) The unique identifier of the carrier account being used to process the pickup. Example: "worba68A1zDr" - `carrier` (string) The carrier being used for the pickup. Example: "PUROLATOR" - `pickupAddress` (object) - `pickupAddress.addressLine1` (string) First line of the address where the pickup will occur. Example: "638 Manitoba Ave" - `pickupAddress.cityTown` (string) The city or town where the pickup address is located. Example: "Winnipeg" - `pickupAddress.company` (string) The name of the company at the pickup address, if the recipient address is not residential. Example: "PB & Company" - `pickupAddress.countryCode` (string) The two-letter country code for the pickup address. Example: "CA" - `pickupAddress.email` (string) The email address associated with the pickup location. Example: "sender@email.com" - `pickupAddress.name` (string) The name of the person or entity at the pickup address. Example: "Paul Wright" - `pickupAddress.phone` (string) The contact phone number for the pickup location. Example: "203-555-1213" - `pickupAddress.postalCode` (string) The postal or ZIP code for the pickup address. Example: "R2W2H2" - `pickupAddress.residential` (boolean) Indicates whether the pickup address is a residential location. Set to 'false' for commercial addresses. - `pickupAddress.stateProvince` (string) The state or province of the pickup address. For a US or Canadian address, it is the 2-letter state or province code. Example: "MB" - `packageLocation` (string) The location where the parcel will be available for pickup at the specified pickup address. Example: "NONE" - `shipmentIds` (array) An array of shipment identifiers associated with the pickup request. Example: ["PUROLATOR2202644757566914"] - `pickupSummary` (array) An array of the pickup details, including the number of packages, total weight, and carrier service information. - `pickupSummary.serviceId` (string) The abbreviated name of the carrier-specific service. Example: "NDA_AM" - `pickupSummary.packageCount` (number) The total number of packages being picked up. Example: 12 - `pickupSummary.totalWeight` (number) The total weight of all packages to be picked up, measured in units supported by the carrier in the origin country. The value is a decimal with up to 2 decimal places. Example: 320 - `pickupSummary.weightUnit` (string) The unit of measurement for the total package weight. Example: "GM" - `pickupSummary.toAddressCountryCode` (string) The destination country code for the shipment associated with the pickup. Example: "CA" - `pickupSummary.parcelType` (string) The type of parcel used for the shipment, as defined by the carrier. Common values include 'PKG' for package, 'ENVELOPE', 'BOX', etc. Example: "PKG" - `reference` (string) An optional Reference related to the pickup. Example: "reference" - `pickupDateTime` (string) The date and time of the pickup in ISO 8601 format. Example: "2026-05-07T14:04:05Z" - `pickupConfirmationNumber` (string) The confirmation number generated when the pickup request is successfully processed. Example: "00006293" - `pickupId` (string) A unique identifier for the scheduled pickup. Example: "PUROLATOR05071778149208326" - `pickupOptions` (object) - `pickupOptions.pickupStartDateTime` (string) The start date and time for the pickup in ISO 8601 format. This indicates when the pickup window begins. Example: "2026-05-07T14:04:05Z" - `pickupOptions.pickupEndDateTime` (string) The end date and time for the pickup in ISO 8601 format. This indicates when the pickup window closes. Example: "2026-05-07T16:30:00Z" - `pickupTotalWeight` (number) The total weight of all packages being picked up. Example: 420 - `pickupTotalWeightUnit` (string) The unit of measurement for the total package weight. Example: "GM" - CPC: - `carrierAccountId` (string) The unique identifier of the carrier account being used to process the pickup. Example: "wljXGR2pRqyB" - `carrier` (string) The carrier being used for the pickup. Example: "CPC" - `pickupAddress` (object) - `pickupAddress.addressLine1` (string) First line of the address where the pickup will occur. Example: "638 Manitoba Ave1" - `pickupAddress.cityTown` (string) The city or town where the pickup address is located. Example: "Winnipeg" - `pickupAddress.company` (string) The name of the company at the pickup address, if the recipient address is not residential. Example: "PB & Company" - `pickupAddress.countryCode` (string) The two-letter country code for the pickup address. Example: "CA" - `pickupAddress.email` (string) The email address associated with the pickup location. Example: "sender@email.com" - `pickupAddress.name` (string) The name of the person or entity at the pickup address. Example: "Paul Wright" - `pickupAddress.phone` (string) The contact phone number for the pickup location. Example: "203-555-1213" - `pickupAddress.postalCode` (string) The postal or ZIP code for the pickup address. Example: "R2W2H2" - `pickupAddress.residential` (boolean) Indicates whether the pickup address is a residential location. Set to 'false' for commercial addresses. - `pickupAddress.stateProvince` (string) The state or province of the pickup address. For a US or Canadian address, it is the 2-letter state or province code. Example: "MB" - `packageLocation` (string) The location where the parcel will be available for pickup at the specified pickup address. Example: "Front Door" - `shipmentIds` (array) An array of shipment identifiers associated with the pickup request. Example: ["CPC2202644757662548"] - `pickupSummary` (array) An array of the pickup details, including the number of packages, total weight, and carrier service information. - `pickupSummary.serviceId` (string) The abbreviated name of the carrier-specific service. Example: "NDA" - `pickupSummary.packageCount` (number) The total number of packages being picked up. Example: 5 - `pickupSummary.totalWeight` (number) The total weight of all packages to be picked up, measured in units supported by the carrier in the origin country. The value is a decimal with up to 2 decimal places. Example: 320 - `pickupSummary.weightUnit` (string) The unit of measurement for the total package weight. Example: "GM" - `pickupSummary.parcelType` (string) The type of parcel used for the shipment, as defined by the carrier. Common values include 'PKG' for package, 'ENVELOPE', 'BOX', etc. Example: "PKG" - `additionalNotes` (string) Additional instructions or notes for the carrier regarding the pickup. Example: "notes" - `reference` (string) An optional Reference related to the pickup. Example: "reference" - `pickupDateTime` (string) The date and time of the pickup in ISO 8601 format. Example: "2026-05-07T14:00:00Z" - `pickupConfirmationNumber` (string) The confirmation number generated when the pickup request is successfully processed. Example: "27241" - `pickupId` (string) A unique identifier for the scheduled pickup. Example: "CPC05071778149330531" - `pickupOptions` (object) - `pickupOptions.pickupStartDateTime` (string) The start date and time for the pickup in ISO 8601 format. This indicates when the pickup window begins. Example: "2026-05-07T14:00:00Z" - `pickupOptions.pickupEndDateTime` (string) The end date and time for the pickup in ISO 8601 format. This indicates when the pickup window closes. Example: "2026-05-07T15:00:00Z" - `pickupRate` (object) The pickup rate details returned for the scheduled pickup. - `pickupRate.baseCharge` (number) The base pickup charge applied by the carrier. Example: 1.7 - `pickupRate.pickupTaxes` (array) An array of taxes applied to the pickup charge. - `pickupRate.pickupTaxes.name` (string) The name of the tax applied to the pickup. Example: "GST" - `pickupRate.pickupTaxes.taxAmount` (number) The tax amount applied for the specified tax type. Example: 0.13 - `pickupRate.totalCarrierCharge` (number) The total pickup charge including all applicable taxes. Example: 2.53 - `pickupTotalWeight` (number) The total weight of all packages being picked up. Example: 420 - `pickupTotalWeightUnit` (string) The unit of measurement for the total package weight. Example: "GM" - FedEx: - `packageLocation` (string) The location where the parcel will be available for pickup at the specified pickup address. Example: "SIDE" - `carrierAccountId` (string) The unique identifier of the carrier account being used to process the pickup. Example: "OVJMdgGYNvrx" - `pickupConfirmationNumber` (string) The confirmation number generated when the pickup request is successfully processed. Example: "CPU0068152722" - `pickupId` (string) A unique identifier for the scheduled pickup. Example: "FEDEX09261758885130715" - `carrier` (string) The carrier being used for the pickup. Example: "fedex" - `pickupAddress` (object) Example: {"addressLine1":"27 Waterview Dr","cityTown":"Shelton","company":"PB","countryCode":"US","email":"sender@email.com","name":"Test","phone":"1234567890","postalCode":"06484-4301","residential":false,"stateProvince":"CT"} - `pickupAddress.name` (string) The name of the person or entity at the pickup address. Example: "Test" - `pickupAddress.addressLine1` (string) First line of the address where the pickup will occur. Example: "27 Waterview Dr" - `pickupAddress.cityTown` (string) The city or town where the pickup address is located. Example: "Shelton" - `pickupAddress.stateProvince` (string) The state or province of the pickup address. For a US or Canadian address, it is the 2-letter state or province code. Example: "CT" - `pickupAddress.postalCode` (string) The postal or ZIP code for the pickup address. For US addresses, use either the 5-digit or 9-digit ZIP Code in one of the following formats: '12345' or '12345-6789'. If you use a different format, such as 12345- or 123451234, will receive an error. Example: "06484-4301" - `pickupAddress.countryCode` (string) The two-letter country code for the pickup address. Example: "US" - `pickupAddress.phone` (string) The contact phone number for the pickup location. Example: "1234567890" - `pickupAddress.company` (string) The name of the company at the pickup address, if the recipient address is not residential. Example: "PB" - `pickupAddress.email` (string) The email address associated with the pickup location. Example: "sender@email.com" - `pickupAddress.residential` (boolean) Indicates whether the pickup address is a residential location. Set to 'false' for commercial addresses. - `pickupSummary` (array) An array of the pickup details, including the number of packages, total weight, and carrier service information. Example: [{"serviceId":"2DA","packageCount":1,"totalWeight":15,"weightUnit":"OZ","totalCustomsDeclaredValue":5},{"serviceId":"3DA","packageCount":2,"totalWeight":4,"weightUnit":"OZ"}] - `pickupSummary.serviceId` (string) The abbreviated name of the carrier-specific service. Example: "NDA" - `pickupSummary.packageCount` (number) The total number of packages being picked up. Example: 2 - `pickupSummary.totalWeight` (number) The total weight of all packages to be picked up, measured in units supported by the carrier in the origin country. The value is a decimal with up to 2 decimal places. Example: 15 - `pickupSummary.weightUnit` (string) The unit of measurement for the total package weight. Example: "OZ" - `pickupSummary.parcelType` (string) The type of parcel used for the shipment, as defined by the carrier. Common values include 'PKG' for package, 'ENVELOPE', 'BOX', etc. Example: "PKG" - `additionalNotes` (string) Additional instructions or notes for the carrier regarding the pickup. Example: "notes" - `reference` (string) An optional Reference related to the pickup. Example: "reference" - `pickupDateTime` (string) The date and time of the pickup in ISO 8601 format. Example: "2025-09-29T12:04:00Z" - `pickupTotalWeight` (number) The total weight of all packages being picked up. Example: 19 - `pickupTotalWeightUnit` (string) The unit of measurement for the total package weight. Example: "OZ" - `pickupOptions` (object) Example: {"pickupStartDateTime":"2025-09-29T12:04:05Z","pickupEndDateTime":"2025-09-29T18:30:00Z","overweight":1,"carrierType":"EXPRESS"} - `pickupOptions.pickupStartDateTime` (string) The start date and time for the pickup in ISO 8601 format. This indicates when the pickup window begins. Example: "2025-09-29T12:04:05Z" - `pickupOptions.pickupEndDateTime` (string) The end date and time for the pickup in ISO 8601 format. This indicates when the pickup window closes. Example: "2025-09-29T18:30:00Z" - `pickupOptions.overweight` (integer) The number of overweight packages in the pickup. This represents the number of packages that exceed the carrier's weight limit. Example: 1 - `pickupOptions.carrierType` (string) The type of carrier used for the pickup. Example: "EXPRESS" ## Response 400 fields (application/json): - `errorCode` (string) Error code(s) that appear due to HTTP 400- Invalid or Bad Request, e.g., validation-error. Example: "validation_error" - `errorDescription` (string) The HTTP 400 Bad Request response status code indicates that the server cannot process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing). Example: "string" - `additionalCode` (string) A unique identifier for the error, for example 1101055, 0100008, or 1021126. - `additionalInfo` (string) This is an additional information about the error. This error 'Invalid Request' might appear due to invalid dimension, weight, or serviceID, or if the information is missing. - `additionalParameters` (array) ## Response 401 fields (application/json): - `message` (string, required) This is HTTP 401 Unauthorized response status code, which indicates that the client request has not been completed because it lacks valid authentication credentials for the requested resource. ## Response 500 fields (application/json): - `message` (string, required) This is HTTP 500 Internal Server Error response status code, which indicates that the server encountered an unexpected condition that prevented it from fulfilling the request.