Label method

This API returns details about a generated label.

Try it here

API Details

URL HTTP Request Types Request Formats
https://api.nzpost.co.nz/labels/label/ GET JSON, JSONP, XML, HTML, PDF

Request Parameters

Parameter Description Required Value Maximum Length Example
uuid The unique id of the label Yes String bcdfh47fdgsd534

Types of Response

Response Type Status Code
Success 200
Invalid Request 400
Label(s) Not Found 404

Response Elements

Note that a response can be 200 and still result in error. It is regarded as a queued error.

Element Description Value Required Example
status_code The status code for the response type is either 'OK' or 'ERROR' String Yes OK
status The status of generating the label String No NetDespatching
label_uuid The unique id of the generated label String No bcdfh47fdgsd534
user_reference_code Sender's own unique identifier for this package String No PKG-23478236565
details_url The url path to json response details String No https://api.nzpost.co.nz/label/bcdfh47fdgsd534.json
print_url The url path to download the pdf label String No https://api.nzpost.co.nz/label/bcdfh47fdgsd534.pdf
tracking_code The tracking code attached to the label String No JD260022817NZ
error_code The error code String No 2004
error_reason An explanation of the error String No Label has been deleted, pdfs retained for only 3 months

Error Codes

Error Code Error Reason
2000 Not Ready, try again soon.
2001 No label matching supplied uuid
2002 PDF Not Ready, try again soon.
2003 JSONP requires a callback parameter
2004 Label has been deleted, pdfs retained for only 3 months
2006 Missing mandatory request parameters
2008 PDF file not found
2009 No license matching supplied api_code
2010 No label matching supplied user_code
2011 Supplied user_code has expired
2012 Error generating QR code

Examples

Note: When an error occurs, the content type is set to application/json.

Request:

        https://api.nzpost.co.nz/labels/label/bcdfh47fdgsd534.json

    

Responses:

    
{
  "status_code": "OK",
  "status": "Complete",
  "label_uuid": "585acff07ac5012e893f442c03203548",
  "user_reference_code":"PKG-6933083665",
  "details_url": "https://api.nzpost.co.nz/labels/label/bcdfh47fdgsd534.json",
  "print_url": "https://api.nzpost.co.nz/labels/label/bcdfh47fdgsd534.pdf",
  "tracking_code": "JD260003490NZ"
}

{
  "status_code": "ERROR",
  "error_code": "2002",
  "error_reason": "PDF Not Ready, try again soon."
}