Nothing Found
    Nothing Found
Locations API
Version 2.3.0

getPointsByPostcode

This endpoint returns a list of all Australia Post points within a specific post code area. You can filter your results using the types parameter.

SecurityAUTH-KEY
Request
path Parameters
postcode
required
integer [ 0 .. 9999 ]

A four-digit Australian postcode.

query Parameters
pc
string

A partner code identifies an entity that owns location data. Currently we offer access only to Australia Post outlet and services data. In the future we may expand this to include location data from partner providers. Note: If this field is left empty, the default value is "AP". Submitting any other value will return an empty data set.

usage_types
string

The usage_types parameter is an optional comma-separated string used to filter locations by its usage type. The filter works as an OR condition, meaning locations matching any of the specified values will be returned. If omitted, all locations will be returned.

Example: usage_types=1,2
types
string

The types parameter is an optional string of comma-delimited values denoting which outlets and facilities you want to locate. There are six of these enumerated values, all of which are selected by default:

  • UPL: Parcel lockers.
  • R_SPB: A red street post box.
  • C_SPB: Combined street post boxes (Both red and yellow boxes together).
  • PO: An Australia Post outlet.
  • OS: Outstation (These are a part of a post office not in the same physical building. For example, a separate building dedicated to PO boxes.)
  • DC: A delivery centre.
Enum: "PO" "UPL" "R_SPB" "C_SPB" "OS" "DC"
Responses
200

OK

get/points/postcode/{postcode}
Request samples 
Response samples 
application/json
{
  • "points": [
    ]
}