Find method
This API call redirects to the Batch method or Label method for the PDF label(s) that are linked to the supplied user_code.
API Details
URL |
HTTP Request Types |
Request Formats |
https://api.nzpost.co.nz/labels/label/find_by_user_code/ |
GET |
PDF, JSON, HTML |
Request Parameters
Parameter |
Description |
Required |
Value |
Maximum Length |
Example |
user_code |
This is the unique code matching the label for which to get the label details. If the label associated with this user_code has a batch_id, this call redirects to the Batch method. |
Yes |
String |
|
A49H6NCK |
Types of Response
Response Type |
Status Code |
Success |
200 |
Invalid Request |
400 |
Label(s) Not Found |
404 |
Response Elements
A 200 response will return a PDF
Element |
Description |
Value |
Required |
Example |
error_code |
The error code |
String |
No |
2006 |
error_reason |
An explanation of the error |
String |
No |
Missing mandatory request parameters |
Error Codes
Error Code |
Error Reason |
2006 |
Missing mandatory request parameters |
2010 |
No label matching supplied user_code |
2011 |
Supplied user_code has expired |
Examples
Note: When an error occurs, the content type is set to application/json
.
Request:
https://api.nzpost.co.nz/labels/label/find_by_user_code/A49H6NCK
Responses:
{
"error_code": "2011",
"error_reason": "Supplied user_code has expired"
}