Locations API
Version 2.3.0

getPointsByWorkCenterID

This endpoint returns a list of all points associated with a specific Australia Post work centre's. You can filter your results using the types parameter.

A work center is a unique numeric identification code that represents a parent Australia Post facility, and all of the child point objects (assets or facilities) associated with it. The facility and its point objects all share the same work_centre_id, but each point is unique.

SecurityAUTH-KEY
Request
path Parameters
work_centre_id
required
integer [ 0 .. 999999999 ]

See the endpoint description above.

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/workcentres/{work_centre_id}
Request samples
Response samples
application/json
{
  • "points": [
    ]
}