- Authentication, Environments
- Endpoints Overview
- Scenarios And Workflows
- All API Endpoints
- Parcels
- Create or update single parcel.PUT
- Create or update up to 200 parcels in a single request.POST
- Get parcel details by parcel Id.GET
- Get up to 100 parcels details by parcel Ids.GET
- Get parcel details by parcel number (tracking number).GET
- Get up to 100 parcels details by parcel numbers (tracking numbers).GET
- Get parcel details by sender reference number.GET
- Get up to 100 parcel details by sender reference numbers.GET
- Query up to 500 parcels.GET
- Delete parcel by Id.DELETE
- Delete up to 100 parcels by Ids.DELETE
- Get print details and contents by print Id.GET
- Get up to 100 parcel print details and contents by print Ids.GET
- Get pickup point details by Id.GET
- Query pickup points.GET
- Group parcels into bags and link to a shipment (update parcel references).
When AllowPartialSuccess is true, valid parcels are updated and invalid ones returned in FailedParcels.POST
- Get parcel details by manifest reference numbers.GET
- Get up to 100 parcel details by manifest reference numbers.GET
- Get parcel details by carrier reference numbers.GET
- Get up to 100 parcel details by carrier reference numbers.GET
- Create or update single parcel.
- Shipments
- Cancel erroneous parcels in a shipment.
- Delete shipment manifest file.
- Create new shipment.
- Create new bag level shipment.
- Update bag level shipment.
- Link parcels with specified bag numbers to a shipment.
- Validate and prepare shipment for submitting.
- Submit and lock shipment and it's parcels.
- Group parcels into bags and link to a shipment, then prepare and submit shipment in one transaction.
- Delete shipment.
- Update shipment.
- Get shipment details by shipment id.
- Query up to 500 shipments.
- Upload shipment manifest file.
- Upload shipment document.
- Get shipment details by shipment number.
- Documents
- Download manifest file.
- Download shipment documents in archive file.
- Download shipment document file by Id.
- Download parcel label by Id.
- Generate and download generic bag labels.
- Generate and download bag label.
- Download resulting (processed) manifest file.
- Generate and download shipment parcel labels.
- Generate and download parcel commercial invoices.
- Download resulting (processed) shipment file.
- Tracking
- Fetch up to 500 tracking events in cursor fashion.
- Get event codes and other metadata.
- Get tracking events by the list of parcel numbers, up to 50, comma separated.
- Get tracking events by the list of sender reference numbers, up to 50, comma separated.
- Get tracking events by the list of parcel numbers or sender reference numbers, up to 50, comma separated.
- Get bag tracking events by the list of bag numbers, up to 50, comma separated.
- Get bag tracking events by the list of bag numbers or shipment numbers, up to 50, comma separated.
- Upload tracking events file.
- Accounts
- Integrations
- Schemas
- Schemas
- AccountInfo
- CreateAndClosePostalDispatchByShipmentRequest
- CreateMailTransitConsignmentByShipmentRequest
- CreateTrackingIntegrationEventsRequest
- DataSource
- DeleteManifestFileRequest
- DeleteManyParcelsRequest
- DeleteShipmentRequest
- DownloadResultingManifestFileRequest
- DownloadResultingShipmentFileRequest
- GenerateShipmentParcelPrintsRequest
- GetAccountDetailsRequest
- GetEventsBatchRequest
- GetManyEventsByBagNrsRequest
- GetManyEventsByParcelNrsRequest
- GetManyEventsBySenderParcelNrsRequest
- GetManyParcelPrintsRequest
- GetManyParcelsByCarrierParcelNrsRequest
- GetManyParcelsByIdsRequest
- GetManyParcelsByManifestParcelNrsRequest
- GetManyParcelsByParcelNrsRequest
- GetManyParcelsBySenderParcelNrsRequest
- GetParcelByIdRequest
- GetParcelByCarrierParcelNrRequest
- GetParcelByParcelNrRequest
- GetParcelBySenderParcelNrRequest
- GetParcelByManifestParcelNrRequest
- GetParcelPrintRequest
- GetPostalConsignmentDetailsRequest
- GetPostalConsignmentDetailsResponse
- GetPostalDispatchDetailsRequest
- GetPostalDispatchDetailsResponse
- GetShipmentDetailsRequest
- PostalConsignmentInfo
- PostalConsignmentStatus
- PostalDespatchReceptacleStatus
- PostalDespatchStatus
- PostalDispatchInfo
- PostalDocumentCategory
- PostalDocumentInfo
- PostalDocumentStatus
- PostalDocumentType
- PostalReceptacleInfo
- PostalReceptacleOutboundBagInfo
- PostalReceptacleParcelInfo
- PostalRouteInfo
- QueryAccountsRequest
- QueryAccountsResponse
- QueryParcelsRequest
- QueryPickupPointsRequest
- QueryPostalConsignmentsRequest
- QueryPostalConsignmentsResponse
- QueryPostalDispatchesRequest
- QueryPostalDispatchesResponse
- QueryShipmentsRequest
- ResolveHsCodesByDescriptionsRequest
- SearchManyBagEventsRequest
- SearchManyParcelEventsRequest
- TransportModeType
- UploadManifestFileRequest
- AccountAddressType
- AccountCommonSettings
- AccountSettingsAddressInfo
- AddressInfo
- AddTrackingEventsRequest
- BagEventsResponse
- BagPrintInfo
- BagPrintType
- BagStatus
- BagTrackingEventInfo
- BagViewInfo
- CancelShipmentParcelsWithErrorsRequest
- ContainerType
- CreateBagLevelShipmentRequest
- CreateIntegrationEventsRequest
- CreateOrUpdateManyParcelsRequest
- CreateOrUpdateParcelAdditionalInfo
- IncludePrintSizes
- CreateOrUpdateParcelIdentifiers
- LabelSize
- CreateOrUpdateParcelInfo
- CreateOrUpdateParcelItemInfo
- CreateOrUpdateParcelReceiverInfo
- CreateOrUpdateParcelReferences
- CreateOrUpdateParcelRequest
- CreateOrUpdateParcelSenderInfo
- CreateOrUpdateParcelStatusInfo
- CreateOrUpdateSingleParcelRequest
- CreateShipmentRequest
- CustomsSettings
- DeleteParcelRequest
- DownloadBagPrintRequest
- DownloadManifestFileRequest
- DownloadParcelPrintRequest
- DownloadShipmentDocumentRequest
- DownloadShipmentDocumentsRequest
- EmaiNotificationsInfo
- EmaiNotificationsSettings
- EventCodeInfo
- FileFormat
- FileStatus
- GenerateBagPrintsRequest
- GenerateParcelCommercialInvoicesRequest
- GenerateParcelCommercialInvoicesResponse
- ParcelLinkResultInfo
- ParcelValidationSettings
- GenerateShipmentParcelPrintsResponse
- GetAccountDetailsResponse
- GetCurrentAccountDetailsRequest
- GetEventsBatchResponse
- GetManyParcelPrintsResponse
- GetPickupPointDetailsRequest
- GetPickupPointDetailsResponse
- GetShipmentDetailsResponse
- LabelsSettings
- LeanMileSettings
- LinkBagsToShipmentRequest
- MailType
- ManifestAndSubmitShipmentParcelInfo
- ManifestAndSubmitShipmentRequest
- ManifestAndSubmitShipmentResponse
- ManifestFileType
- ManifestFileViewInfo
- ManyParcelsDetailsResponse
- NewIntegrationEvent
- NewTrackingEvent
- ParcelAdditionalInfo
- ParcelAndTrackingEventInfo
- ParcelCommercialInvoiceInfo
- ParcelDetailsResponse
- ParcelDocument
- ParcelDocumentType
- LinkBagsToShipmentResponse
- ParcelEventsResponse
- ParcelIdentifiers
- ParcelInfo
- ParcelItemInfo
- ParcelNrSequenceInfo
- ParcelNrType
- ParcelPrintFormat
- ParcelPrintInfo
- UpdateManyParcelReferencesResponse
- ParcelPrintType
- ParcelReceiverInfo
- ParcelReferences
- ParcelSenderInfo
- ParcelStatus
- ParcelStatusInfo
- ParcelTransactionType
- PickupPointInfo
- PickupPointType
- PostalLabelSettings
- PostalSettings
- PrepareShipmentRequest
- PrepareShipmentResponse
- QstepSettings
- QueryParcelsResponse
- QueryPickupPointsResponse
- QueryShipmentsResponse
- RateManagementSettings
- SearchBagEventsResponse
- ResendOrRelabelParcelRequest
- SearchParcelEventsResponse
- ShipmentArrivalInfo
- ShipmentArrivalViewInfo
- ShipmentDocumentType
- ShipmentDocumentViewInfo
- ShipmentManifestLevel
- ShipmentManifestSettings
- ShipmentStatus
- ShipmentStatusInfo
- ShipmentTerminalInfo
- ShipmentType
- ShipmentViewInfo
- SubmitShipmentRequest
- TaxType
- TelemetrySettings
- TrackingEventInfo
- TrackingParcelInfo
- UpdateBagLevelShipmentRequest
- UpdateManyParcelReferencesRequest
- UpdateShipmentRequest
- UploadManifestFileResponse
- UploadShipmentDocumentResponse
- UploadTrackingEventsFileResponse
- UpsertBagRequest
- X7TradeSettings
- Schemas
Group parcels into bags and link to a shipment (update parcel references). When AllowPartialSuccess is true, valid parcels are updated and invalid ones returned in FailedParcels.
POST
https://api.test.post-plus.io/api/v1/parcels/update-references-many
Request
Authorization
API Key
Add parameter in header
X-API-KEY
Example:
X-API-KEY: ********************or
Header Params
Body Params application/json-patch+json
Example
{
"ids": "string",
"parcelNrs": "string",
"senderParcelNrs": "string",
"updateBagNr": "string",
"linkShipmentId": 0,
"allowPartialSuccess": true
}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 --request POST 'https://api.test.post-plus.io/api/v1/parcels/update-references-many' \
--header 'Accept: application/json' \
--header 'X-API-KEY: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
"ids": "string",
"parcelNrs": "string",
"senderParcelNrs": "string",
"updateBagNr": "string",
"linkShipmentId": 0,
"allowPartialSuccess": true
}'Responses
🟢200OK
application/json
Body
Example
{
"successParcelsCount": 5,
"failedParcelsCount": 1,
"parcels": [
{
"identifiers": {
"id": 1234,
"parcelNr": "RS12345678US",
"senderParcelNr": "client-id-123"
},
"references": {
"shipmentId": 0,
"shipmentNr": "123-000000123",
"bagNr": "bag-001",
"carrier": "string",
"carrierServiceCode": "string",
"carrierParcelNr": "string",
"manifestParcelNr": "string",
"printId": 1234567890,
"externalIds": 1234567890
},
"error": "Parcel is already linked to manifested shipment SH001"
}
],
"failedParcels": [
{
"identifiers": {
"id": 1234,
"parcelNr": "RS12345678US",
"senderParcelNr": "client-id-123"
},
"references": {
"shipmentId": 0,
"shipmentNr": "123-000000123",
"bagNr": "bag-001",
"carrier": "string",
"carrierServiceCode": "string",
"carrierParcelNr": "string",
"manifestParcelNr": "string",
"printId": 1234567890,
"externalIds": 1234567890
},
"error": "Parcel is already linked to manifested shipment SH001"
}
],
"bagNrs": [
"string"
],
"failedBagNrs": [
"string"
]
}