List polymorphic addresses
Returns addresses scoped to the API key’s entity. Filter by parent_type
(account, vendor, location, entity) + parent_id for parent-scoped lists,
or by country and is_default. Cursor pagination via starting_after /
ending_before / limit. Requires addresses:read scope.
Authorizations
API key issued per entity via Settings > Developers > API Keys.
Each key carries scopes (e.g. orders:read, products:write).
Bearer token format: Authorization: Bearer ark_live_ent_Test keys use ark_test_ent_. Both are issued per entity
via Settings > Developers > API Keys.
Query Parameters
account, vendor, location, entity Maximum number of records to return per page. Default 25, max 500. Use together with starting_after for cursor pagination. For larger bulk extraction workflows prefer the migration endpoints.
1 <= x <= 500Cursor for pagination. Pass the id of the last record from the previous page to fetch the next page. Mutually exclusive with ending_before.
200Cursor for reverse pagination. Pass the id of the first record from the previous page to fetch the prior page. Mutually exclusive with starting_after.
200
