PostPlus API
  1. Integrations
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
  • 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).
      • 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
      • Create new shipment.
      • Update shipment.
      • Get shipment details.
      • Delete 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.
      • Cancel erroneous parcels in a shipment.
      • Upload shipment manifest file.
      • Upload shipment document.
      • Delete shipment manifest file.
      • Query up to 500 shipments.
      • Group parcels into bags and link to a shipment, then prepare and submit shipment in one transaction.
    • Documents
      • Download manifest file.
      • Download resulting (processed) manifest file.
      • Download resulting (processed) shipment file.
      • Download shipment documents in archive file.
      • Download shipment document file by Id.
      • Download parcel label by Id.
      • Generate and download shipment parcel labels.
      • Generate and download generic bag labels.
      • Generate and download bag label.
      • Generate and download parcel commercial invoices.
    • Tracking
      • Get event codes and other metadata.
      • Fetch up to 500 tracking events in cursor fashion.
      • 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.
      • Upload tracking events file.
      • 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.
    • Accounts
      • Get current account details.
    • Integrations
      • Add up to 500 tracking events to the processing queue. The whole batch either succeeds or fails.
        POST
      • Add tracking event with generic payload.
        POST
  1. Integrations

Add up to 500 tracking events to the processing queue. The whole batch either succeeds or fails.

POST
https://api.test.post-plus.io/api/v1/integrations/tracking-import
Integrations

Request

Header Params
Content-Type
string 
optional
Default:
application/json
Accept
string 
optional
Default:
application/json
X-API-KEY
string 
optional
Default:
apitest1234567890
Body Params application/json
events
array[object (NewTrackingEvent) {12}]  | null 
optional
eventId
string  | null 
optional
Optional - external unique event id, on subsequent requests with same EventId the original event will be found by this id and overwritten
eventSourceAlt
string  | null 
optional
Alternative event source
eventCode
string  | null 
optional
Event code
eventCodeAlt
string  | null 
optional
Alternative event code
eventMessage
string  | null 
optional
Event message
eventTime
string  | null 
optional
Event time in ISO format "2015-06-03T13:18:30+00:00"
eventLocation
string  | null 
optional
Arbitrary event location, such as country code, city, zip ode, etc.
trackingNr
string  | null 
optional
Tracking number
senderTrackingNr
string  | null 
optional
Sender tracking number
carrier
string  | null 
optional
Carrier name
carrierParcelNr
string  | null 
optional
Carrier parcel number
otherTrackingData
string  | null 
optional
Other tracking data
Example
{
    "events": [
        {
            "eventId": "string",
            "eventSourceAlt": "string",
            "eventCode": "string",
            "eventCodeAlt": "string",
            "eventMessage": "string",
            "eventTime": "string",
            "eventLocation": "string",
            "trackingNr": "string",
            "senderTrackingNr": "string",
            "carrier": "string",
            "carrierParcelNr": "string",
            "otherTrackingData": "string"
        }
    ]
}

Request 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/integrations/tracking-import' \
--header 'Accept: application/json' \
--header 'X-API-KEY: apitest1234567890' \
--header 'Content-Type: application/json' \
--data-raw '{
    "events": [
        {
            "eventId": "string",
            "eventSourceAlt": "string",
            "eventCode": "string",
            "eventCodeAlt": "string",
            "eventMessage": "string",
            "eventTime": "string",
            "eventLocation": "string",
            "trackingNr": "string",
            "senderTrackingNr": "string",
            "carrier": "string",
            "carrierParcelNr": "string",
            "otherTrackingData": "string"
        }
    ]
}'

Responses

🟢200OK
Success
This response does not have a body.
Previous
Get current account details.
Next
Add tracking event with generic payload.
Built with