younifyd
Menu

List Shipping Addresses

Fetch a list of an account's shipping addresses

GET/accounts/{account_id}/shipping_addresses

Use it in a workflow

  1. Add a step and choose the Recurly connector.
  2. Pick the List Shipping Addresses action (under shipping_address).
  3. Fill in the fields below, then reference the result from later steps as {{listShippingAddresses.response.data}}.

Request

Path parameters

account_idstringrequired

Account ID or code. For ID no prefix is used e.g. `e28zov4fw0v2`. For code use prefix `code-`, e.g. `code-bob`.

Query parameters

idsarray<string>

Filter results by their IDs. Up to 200 IDs can be passed at once using commas as separators, e.g. `ids=h1at4d57xlmy,gyqgg0d3v9n1,jrsm5b4yefg6`. **Important notes:** * The `ids` parameter cannot be used with any other ordering or filtering parameters (`limit`, `order`, `sort`, `begin_time`, `end_time`, etc) * Invalid or unknown IDs will be ignored, so you should check that the results correspond to your request. * Records are returned in an arbitrary order. Since results are all returned at once you can sort the records yourself.

limitinteger

Limit number of records 1-200.

Default 20

orderstring

Sort order.

One ofascdescDefault "desc"

sortstring

Sort field. You *really* only want to sort by `updated_at` in ascending order. In descending order updated records will move behind the cursor and could prevent some records from being returned.

One ofcreated_atupdated_atDefault "created_at"

begin_timestring (date-time)

Inclusively filter by begin_time when `sort=created_at` or `sort=updated_at`. **Note:** this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.

end_timestring (date-time)

Inclusively filter by end_time when `sort=created_at` or `sort=updated_at`. **Note:** this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.

Response

Returns 200 with an object. Read it in later steps with {{listShippingAddresses.response.data.<field>}}.

objectstring

Will always be List.

has_moreboolean

Indicates there are more results on subsequent pages.

nextstring

Path to subsequent page of results.

dataarray<object>
idstring
objectstring
account_idstring
nicknamestring
first_namestring
last_namestring
companystring
emailstring
vat_numberstring
phonestring
street1string
street2string
citystring
regionstring

State or province.

postal_codestring

Zip or postal code.

countrystring

Country, 2-letter ISO 3166-1 alpha-2 code.

geo_codestring

Code that represents a geographic entity (location or object). Only returned when Vertex or Avalara for Communications is enabled.

created_atstring (date-time)
updated_atstring (date-time)
json
{
  "object": "string",
  "has_more": false,
  "next": "string",
  "data": [
    {
      "id": "string",
      "object": "string",
      "account_id": "string",
      "nickname": "string",
      "first_name": "string",
      "last_name": "string",
      "company": "string",
      "email": "string",
      "vat_number": "string",
      "phone": "string",
      "street1": "string",
      "street2": "string"
    }
  ]
}

Need more? See the Recurly guide for connection setup and behaviour shared by every action.