Website logo

Track a Courier Parcel

Track a Courier Parcel

URL: https://api.trademe.co.nz/v1/MyTradeMe/CourierParcels.{file_format}
HTTP Method: POST
Requires Authentication? Yes
Permission Required: MyTradeMeWrite: Maintain your watchlist, answer questions and post comments.
Supported Formats: XML, JSON
Rate Limited? Yes

URL parameters

file_format Enumeration (required) The format of the response.
xml Serialize responses into XML.
json Serialize responses into JSON.

POST Data

<CourierParcelTrackingRequest>

Parcel <CourierParcel> (required)

Parcel to be tracked

CourierCompany String (required)

The courier company. Commonly used values include: CourierPost, Fastway, New Zealand Couriers, Post Haste, GoSweetSpot, Castle Parcels

AccountNumber String (optional)

Optional account number specific to the courier

TrackingReference String (required)

The tracking reference specific to the courier company

AuctionSoldIds Collection of Integer (required)

The list of purchase IDs (auction sold IDs) that where shipped with this parcel

Returns

<TrackParcelResponse>

Details of whether the operation was successful.

Success Boolean

Indicates whether the operation was successful.

Description String or null

The description of the error, if the operation failed.

Code Enumeration

More information as to the result of the operation

OK 0

Parcel was successfully accepted into the system

ParcelAlreadyExists 1

A duplicate parcel already exists in the system

TrackingReferenceEmpty 2

Tracking reference is empty

TrackingReferenceTooLong 3

Tracking reference is too long

AccountNumberTooLong 4

Account number is too long

MemberIsNotSeller 5

This member did not create one or more of the supplied listing reference ids

InvalidAuctionSoldIds 6

One or more of the sold listing ids do not exist

AuctionSoldIdsEmpty 7

Need to specify at least one auction sold id

AuctionSoldIdsArentForTheSameBuyer 8

All auctions must be for the same buyer

CourierCompanyNotSpecified 9

Courier company is not specified

CourierParcelId Integer

The id of the newly tracked parcel

Example XML Request (switch to JSON)

<CourierParcelTrackingRequest xmlns="http://api.trademe.co.nz/v1">
  <Parcel>
    <CourierCompany>ABC</CourierCompany>
    <AccountNumber>ABC</AccountNumber>
    <TrackingReference>ABC</TrackingReference>
    <AuctionSoldIds>
      <Id>123</Id>
      <Id>123</Id>
    </AuctionSoldIds>
  </Parcel>
</CourierParcelTrackingRequest>

Example JSON Request (switch to XML)

{
  "Parcel": {
    "CourierCompany": "ABC",
    "AccountNumber": "ABC",
    "TrackingReference": "ABC",
    "AuctionSoldIds": [
      123,
      123
    ]
  }
}

Example XML Response (switch to JSON)

<TrackParcelResponse xmlns="http://api.trademe.co.nz/v1">
  <Success>false</Success>
  <Description>ABC</Description>
  <Code>OK</Code>
  <CourierParcelId>123</CourierParcelId>
</TrackParcelResponse>

Example JSON Response (switch to XML)

{
  "Success": false,
  "Description": "ABC",
  "Code": 0,
  "CourierParcelId": 123
}