Report Request Tracking: Get status/data of a request

Using this API, you can fetch all the shipment updates received for a day in Clickpost.

Overview

With help of this API, Enterprise can get the latest status of the "Report Request" created through the "Report Request API" and can get the "Report URL" from which CSV file can be downloaded

Usecase

This is a standard API which applies to all MPS (Multi-Piece Shipment) and SPS (Single Piece Shipment) orders

Geography

This is a standard API which supports all shipments created and transported within

  1. India
  2. North America
  3. Europe
  4. Middle East
  5. South East Asia

Important Links

Run in Postman API Reference

🚧

NOTE

The difference between Start Time and End Time cannot be more that 24 hours.

Query Parameters

Query Parameters to be passed directly in the URL.

Field NameData TypeFieldDescriptionMax LengthExample
keyStringMandatoryUnique license key provided by Clickpost for the enterprise100"00000000-0000-0000-0000-000000000000"
report_reference_numberStringMandatoryThe reference number for the report which was received in the response of "Report Request API" (first step).

Response

meta [meta parameters]

Field NameData TypeDescriptionExample
successBooleanIndicates the success of the API requesttrue
messageStringThe message from clickpost. In case of success it will be "SUCCESS". In case that there are no courier partners that are servicing the pincodes it will be”Pin code not serviceable""SUCCESS"
statusHTTP CodeThe HTTP response status code of the API request200

result [result parameters]

Field NameData TypeDescriptionExample
report_nameStringThe Name of the requested reportTRACKORDER
DASHBOARD_REPORT
s3_linkStringThe URL where you can download the Report"https://clickpost-reports-bucket.s3.amazonaws.com/DOWNLOAD/TRACKING/180611_1667545779.3474863.csv?AWSAccessKeyId=AKIAJPHMJUW5YRJQWS7A&Signature=azSJOPPRGGCfBVPbKSvfoBDuMBw%3D&Expires=1667632185 "
report_created_atStringThe date and time when the report was requested. The date and time is in UTC"2022-11-04 07:09"
report_statusStringThe status of the report"SUCCESS"
Language
Click Try It! to start a request and see the response here!