Copy Page
PostPlus API
Authentication, Environments
Endpoints Overview
Parcels Endpoints
Shipments Endpoints
Tracking Endpoints
Accounts Endpoints
Scenarios And Workflows
Working with parcels
Create or update parcel record
Cancel or delete a parcel record
Manifesting parcels in bags and shipments
Query parcel tracking events
Import parcel tracking events
All API Endpoints
Parcels
Create or update single parcel.
Create or update up to 200 parcels in a single request.
Get parcel details by parcel Id.
Get up to 100 parcels details by parcel Ids.
Get parcel details by parcel number (tracking number).
Get up to 100 parcels details by parcel numbers (tracking numbers).
Get parcel details by sender reference number.
Get up to 100 parcel details by sender reference numbers.
Query up to 500 parcels.
Delete parcel by Id.
Delete up to 100 parcels by Ids.
Get print details and contents by print Id.
Get up to 100 parcel print details and contents by print Ids.
Get pickup point details by Id.
Query pickup points.
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.
Get parcel details by manifest reference numbers.
Get up to 100 parcel details by manifest reference numbers.
Get parcel details by carrier reference numbers.
Get up to 100 parcel details by carrier reference numbers.
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
Get current account details.
Integrations
Add up to 500 tracking events to the processing queue. The whole batch either succeeds or fails.
Add tracking event with generic payload.
Shipments
Update a shipment document's effective date. The document's visibility and status are preserved.
HsCodes
Resolve HS codes by list of descriptions.
Tracking
Get the parcel journey phases, in journey order - the dictionary for the category that event codes and tracking events carry. Changes only on release, so fetch it once and cache it.
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
SearchManyBagEventsRequest
SearchManyParcelEventsRequest
TransportModeType
UploadManifestFileRequest
AccountAddressType
AccountCommonSettings
AccountSettingsAddressInfo
AddressInfo
AddTrackingEventsRequest
BagEventsResponse
BagPrintInfo
BagPrintType
BagStatus
BagViewInfo
CancelShipmentParcelsWithErrorsRequest
ContainerType
CreateIntegrationEventsRequest
EmaiNotificationsSettings
CreateOrUpdateManyParcelsRequest
CreateOrUpdateParcelAdditionalInfo
IncludePrintSizes
CreateOrUpdateParcelIdentifiers
LabelSize
CreateOrUpdateParcelInfo
CreateOrUpdateParcelReceiverInfo
CreateOrUpdateParcelReferences
CreateOrUpdateParcelRequest
CreateOrUpdateParcelSenderInfo
CreateOrUpdateParcelStatusInfo
CreateOrUpdateSingleParcelRequest
CustomsSettings
DeleteParcelRequest
TaxType
DownloadBagPrintRequest
DownloadManifestFileRequest
DownloadParcelPrintRequest
DownloadShipmentDocumentRequest
DownloadShipmentDocumentsRequest
FileFormat
FileStatus
GenerateBagPrintsRequest
GenerateParcelCommercialInvoicesRequest
GenerateParcelCommercialInvoicesResponse
ParcelLinkResultInfo
ParcelValidationSettings
GenerateShipmentParcelPrintsResponse
GetAccountDetailsResponse
GetCurrentAccountDetailsRequest
GetEventsBatchResponse
UpdateShipmentDocumentRequest
GetManyParcelPrintsResponse
EventCategoryInfo
LinkBagsToShipmentRequest
GetPickupPointDetailsRequest
GetPickupPointDetailsResponse
CreateBagLevelShipmentRequest
CreateShipmentRequest
GetShipmentDetailsResponse
LabelsSettings
LeanMileSettings
MailType
ResolveHsCodesByDescriptionsRequest
ManifestAndSubmitShipmentParcelInfo
ManifestAndSubmitShipmentRequest
ManifestAndSubmitShipmentResponse
ManifestFileType
UpdateManyParcelReferencesRequest
ManifestFileViewInfo
ManyParcelsDetailsResponse
BagTrackingEventInfo
NewIntegrationEvent
NewTrackingEvent
ParcelAdditionalInfo
ParcelAndTrackingEventInfo
EmaiNotificationsInfo
ParcelCommercialInvoiceInfo
ParcelDetailsResponse
ParcelDocument
ParcelDocumentType
LinkBagsToShipmentResponse
ParcelEventsResponse
ParcelIdentifiers
ParcelInfo
ParcelNrSequenceInfo
ShipmentDocumentViewInfo
ParcelNrType
TrackingEventInfo
ParcelPrintFormat
UpdateManyParcelReferencesResponse
ParcelPrintType
ParcelReceiverInfo
CreateOrUpdateParcelItemInfo
ParcelSenderInfo
ParcelStatus
ParcelStatusInfo
ParcelItemInfo
ParcelTransactionType
PickupPointInfo
PickupPointType
EventCodeInfo
ParcelPrintInfo
ParcelReferences
PostalLabelSettings
PostalSettings
PrepareShipmentRequest
PrepareShipmentResponse
QstepSettings
QueryParcelsResponse
QueryPickupPointsResponse
QueryShipmentsResponse
RateManagementSettings
SearchBagEventsResponse
ResendOrRelabelParcelRequest
SearchParcelEventsResponse
ShipmentArrivalInfo
ShipmentArrivalViewInfo
ShipmentDocumentType
ShipmentManifestLevel
ShipmentManifestSettings
ShipmentStatus
ShipmentStatusInfo
ShipmentTerminalInfo
ShipmentType
ShipmentViewInfo
SubmitShipmentRequest
TelemetrySettings
TrackingParcelInfo
UpdateBagLevelShipmentRequest
UpdateShipmentRequest
UploadManifestFileResponse
UploadShipmentDocumentResponse
UploadTrackingEventsFileResponse
UpsertBagRequest
X7TradeSettings
UpdateShipmentDocumentRequest
Copy Page
{
"effectiveDate"
:
"2019-08-24T14:15:22.123Z"
,
"effectiveBags"
:
0
}