Trackings API - AfterShip Docs

Trackings

Create trackings, update trackings, and get tracking results.

Resource	Description
POST /trackings	Create a tracking.
DELETE /trackings/:slug/:tracking_number	Delete a tracking.
GET /trackings	Get tracking results of multiple trackings.
GET /trackings/:slug/:tracking_number	Get tracking results of a single tracking.
PUT /trackings/:slug/:tracking_number	Update a tracking.
POST /trackings/:slug/:tracking_number/retrack	Retrack an expired tracking. Max 3 times per tracking.

Pro Tip!

You can always use/:id to replace /:slug/:tracking_number.
e.g. DELETE /trackings/:id

Headers

aftership-api-key: YOUR_API_KEY
Content-Type: application/json

Parameters

Required Parameters

Parameter	Type	Description
`tracking_number`	String	Tracking number of a shipment. Duplicate tracking numbers, or tracking number with invalid tracking number format will not be accepted.

Optional Parameters

Parameter	Type	Description
`slug`	String or Array	Unique code of each courier. Provide a single courier or array for a list of couriers. If you do not specify a slug, Aftership will automatically detect the courier based on the tracking number format and your selected couriers. Get a list of courier slug using GET /couriers
`tracking_postal_code`	String	The postal code of receiver's address. Required by some couriers, such as`deutsch-post`
`tracking_ship_date`	String	Shipping date in`YYYYMMDD`format. Required by some couriers, such as`deutsch-post`
`tracking_account_number`	String	Account number of the shipper for a specific courier. Required by some couriers, such as`dynamic-logistics`
`tracking_key`	String	Key of the shipment for a specific courier. Required by some couriers, such as`sic-teliway`
`tracking_destination_country`	String	Destination Country of the shipment for a specific courier. Required by some couriers, such as`postnl-3s`
`android`	Array or String	Google cloud message registration IDs to receive the push notifications. Accept either array or Comma comma separated as input.
`ios`	Array or String	Apple iOS device IDs to receive the push notifications. Accept either array or Comma comma separated as input.
`emails`	Array or String	Email address(es) to receive email notifications. Accept either array or Comma comma separated as input.
`smses`	Array or String	Phone number(s) to receive sms notifications. Enter`+` and`area code` before phone number. Accept either array or Comma comma separated as input.
`title`	String	Title of the tracking. Default value as`tracking_number`
`customer_name`	String	Customer name of the tracking.
`destination_country_iso3`	String	EnterISO Alpha-3(three letters)to specify the destination of the shipment. If you use postal service to send international shipments, AfterShip will automatically get tracking results at destination courier as well (e.g. USPS for USA).
`order_id`	String	Text field for order ID
`order_id_path`	String	Text field for order path
`custom_fields`	String	Custom fields that accept any text string
`note`	String	Text field for the note

Body

{
    "tracking": {
        "slug": "dhl",
        "tracking_number": "123456789",
        "title": "Title Name",
        "smses": [
            "+18555072509",
            "+18555072501"
        ],
        "emails": [
            "email@yourdomain.com",
            "another_email@yourdomain.com"
        ],
        "order_id": "ID 1234",
        "order_id_path": "http://www.aftership.com/order_id=1234",
        "custom_fields": {
            "product_name": "iPhone Case",
            "product_price": "USD19.99"
        }
    }
}

Headers

HTTP/1.1 201 Created
Content-Type: application/json
Connection: keep-alive
Date: Mon, 10 Jun 2013 07:38:02 GMT

Attributes

Attribute	Type	Description
`tracking`	Hash of Tracking Object	Hash describes the tracking information.

Tracking Object

Attribute	Type	Description
`created_at`	DateTime	Date and time of the tracking created.
`updated_at`	DateTime	Date and time of the tracking last updated.
`id`	String	A unique identifier generated by AfterShip for the tracking.
`tracking_postal_code`	String	The postal code of receiver's address. Required by some couriers, such as`deutsch-post`
`tracking_ship_date`	String	Shipping date in`YYYYMMDD`format. Required by some couriers, such as`deutsch-post`
`tracking_account_number`	String	Account number of the shipper for a specific courier. Required by some couriers, such as`dynamic-logistics`
`tracking_key`	String	Key of the shipment for a specific courier. Required by some couriers, such as`sic-teliway`
`tracking_destination_country`	String	Destination Country of the shipment for a specific courier. Required by some couriers, such as`postnl-3s`
`slug`	String	Unique code of courier. Get courier slug here
`active`	boolean	Whether or not AfterShip will continue tracking the shipments. Value is `false` when tag (status) is `Delivered`, `Expired`, or further updates for 30 days since last update.
`android`	Array or String	Google cloud message registration IDs to receive the push notifications. Accept either array or Comma comma separated as input.
`custom_fields`	Hash	Custom fields of the tracking.
`customer_name`	String	Customer name of the tracking.
`delivery_time`	Number	Total delivery time in days. - Difference of 1st checkpoint time and delivered time for delivered shipments - Difference of 1st checkpoint time and current time for non-delivered shipments Value as `0` for pending shipments or delivered shipment with only one checkpoint.
`destination_country_iso3`	String	Destination country of the tracking. ISO Alpha-3 (three letters). If you use postal service to send international shipments, AfterShip will automatically get tracking results from destination postal service based on destination country.
`emails`	Array	Email address(es) to receive email notifications. Comma separated for multiple values.
`expected_delivery`	String	Expected delivery date (if any). Empty String, YYYY-MM-DD, YYYY-MM-DDTHH:MM:SS, or YYYY-MM-DDTHH:MM:SS+TIMEZONE
`ios`	Array or String	Apple iOS device IDs to receive the push notifications. Accept either array or Comma comma separated as input.
`order_id`	String	Text field for order ID
`order_id_path`	String	Text field for order path
`origin_country_iso3`	String	Origin country of the tracking. ISO Alpha-3 (three letters).
`unique_token`	String	The token to generate the direct tracking link: `https://yourusername.aftership.com/unique_token` or `https://www.aftership.com/unique_token`
`shipment_package_count`	Number	Number of packages under the tracking.
`shipment_type`	String	Shipment type provided by carrier (if any).
`shipment_weight`	Number	Shipment weight provied by carrier (if any)
`shipment_weight_unit`	String	Weight unit provied by carrier, either in `kg` or `lb` (if any)
`signed_by`	String	Signed by information for delivered shipment (if any).
`smses`	Array	Phone number(s) to receive sms notifications. The phone number(s) to receive sms notifications. Phone number should begin with `+` and `Area Code` before phone number. Comma separated for multiple values.
`source`	String	Source of how this tracking is added.
`tag`	String	Current status of tracking. Values include `Pending` `InfoReceived` `InTransit` `OutForDelivery` `AttemptFail` `Delivered` `Exception` `Expired` (See status definition)
`title`	String	Title of the tracking.
`tracked_count`	Number	Number of attempts AfterShip tracks at courier's system.
`checkpoints`	Array of Checkpoint Object	Array of Hash describes the checkpoint information.

Checkpoint Object

Attribute	Type	Description
`created_at`	DateTime	Date and time of the tracking created.
`slug`	String	The unique code of courier for this checkpoint message. Get courier slug here
`checkpoint_time`	String	Date and time of the checkpoint, provided by courier. Value may be: Empty String, YYYY-MM-DD, YYYY-MM-DDTHH:MM:SS, or YYYY-MM-DDTHH:MM:SS+TIMEZONE
`city`	String	Location info (if any)
`coordinates`	Array	Deprecated as of March 2013
`country_iso3`	String	Country ISO Alpha-3 (three letters) of the checkpoint
`country_name`	String	Country name of the checkpoint, may also contain other location info.
`message`	String	Checkpoint message
`state`	String	Location info (if any)
`tag`	String	Current status of checkpoint. Values include `Pending` `InfoReceived` `InTransit` `OutForDelivery` `AttemptFail` `Delivered` `Exception` `Expired` (See status definition)
`zip`	String	Location info (if any)

Body

{
    "meta": {
        "code": 201
    },
    "data": {
        "tracking": {
            "id": "53aa7b5c415a670000000021",
            "created_at": "2014-06-25T07:33:48+00:00",
            "updated_at": "2014-06-25T07:33:48+00:00",
            "tracking_number": "123456789",
            "tracking_account_number": null,
            "tracking_postal_code": null,
            "tracking_ship_date": null,
            "slug": "dhl",
            "active": true,
            "custom_fields": {
                "product_price": "USD19.99",
                "product_name": "iPhone Case"
            },
            "customer_name": null,
            "destination_country_iso3": null,
            "emails": [
                "email@yourdomain.com",
                "another_email@yourdomain.com"
            ],
            "expected_delivery": null,
            "note": null,
            "order_id": "ID 1234",
            "order_id_path": "http://www.aftership.com/order_id=1234",
            "origin_country_iso3": null,
            "shipment_package_count": 0,
            "shipment_type": null,
            "signed_by": null,
            "smses": [],
            "source": "api",
            "tag": "Pending",
            "title": "Title Name",
            "tracked_count": 0,
            "unique_token": "xy_fej9Llg",
            "checkpoints": []
        }
    }
}