List all addresses
GET/addresses
Returns a list of your addresses.
Request
Query Parameters
-
street_address
: sorts the result by thestreet_address
field in ascending order. -
-street_address
: sorts the result by thestreet_address
field in descending order.
Possible values: >= 1
Default value: 1
The page number to load
Possible values: >= 1
and <= 250
Default value: 20
The size of the page
Filter addresses via the customer reference set. Matching is not case-sensitive.
If present, addresses with customer_reference
containing the given value will be returned. Matching is not case-sensitive.
Default value: null
If set as 'true', only addresses used as the emergency address for at least one active phone-number will be returned. When set to 'false', the opposite happens: only addresses not used as the emergency address from phone-numbers will be returned.
Default value: null
If present, addresses with street_address
containing the given value will be returned. Matching is not case-sensitive. Requires at least three characters.
Default value: null
If present, only returns results with the address_book
flag set to the given value.
Possible values: [created_at
, first_name
, last_name
, business_name
, street_address
]
Default value: created_at
Specifies the sort order for results. By default sorting direction is ascending. To have the results sorted in descending order add the -
prefix.
That is:
If not given, results are sorted by
created_at
Responses
200: Successful response
- application/json
400: Bad request
401: Unauthorized
404: Resource not found