Addresses

Learn how to manage addresses.

Creating or updating a shopper's address

Use POST /v1/shoppers/me/addresses to create a shopper record. Contact your Digital River team to set up this request. An address entry must have a unique nickname. If a current address has the same nickname specified in the request, that address is updated; otherwise, a new address is created. See Addresses query parameters for a description of the query parameters.

cURL

curl --location --request POST 'https://api.digitalriver.com/v1/shoppers/me/addresses' \
--header 'authorization: bearer ***\
...
--data-raw '{
  "address": {
    "nickName": "test",
    "isDefault": "true",
    "firstName": "Jon",
    "lastName": "Doe",
    "companyName": "Digital River",
    "line1": "10380 Bren Road West",
    "line2": "string",
    "line3": "string",
    "city": "Minnetonka",
    "countrySubdivision": "MN",
    "postalCode": "55343",
    "country": "US",
    "countryName": "United States",
    "countyName": "Hennepin",
    "phoneNumber": "555-253-1234",
    "phoneticFirstName": "クリス",
    "phoneticLastName": "ミラー",
    "division": "製品開発"
  }
}

You will receive a 204 No Content response.

Getting an address by identifier

Use GET /v1/shoppers/me/addresses/{addressId} to get a shopper's address by its identifier (addressId).

cURL

curl --location --request GET 'https://api.digitalriver.com/v1/shoppers/addresses/{addressId}' \
--header 'authorization: bearer ***\
...

200 OK response

{
  "address": {
    "uri": "https://api.digitalriver.com/v1/shoppers/me/addresses/1234567890",
    "id": 1655007697,
    "nickName": "test",
    "isDefault": "true",
    "firstName": "Jon",
    "lastName": "Doe",
    "line1": "10380 Bren Road West",
    "line2": "string",
    "city": "Minnetonka",
    "countrySubdivision": "MN",
    "postalCode": "55343",
    "country": "US",
    "countryName": "United States",
    "phoneNumber": "952-253-1234",
    "phoneticFirstName": "クリス",
    "phoneticLastName": "ミラー",
    "division": "製品開発"
  }
}

Getting all shopper addresses

Use GET /v1/shoppers/me/addresses to get all shopper addresses.

cURL

curl --location --request GET 'https://api.digitalriver.com/v1/shoppers/addresses' \
--header 'authorization: bearer ***\
...

200 OK response

{
  "addresses": {
    "uri": "https://api.digitalriver.com/v1/shoppers/me/addresses",
    "address": [
      {
        "uri": "https://api.digitalriver.com/v1/shoppers/me/addresses/1234567890",
        "nickName": "test",
        "isDefault": "true"
      }
    ]
  }
}

Deleting a shopper's address

Use DELETE /v1/shoppers/me/addresses/{addressId} to delete a shopper's address by its identifier (addressId).

cUR.

curl --location --request DELETE 'https://api.digitalriver.com/v1/shoppers/addresses/{addressId}' \
--header 'authorization: bearer ***\
...De

You will receive a 204 No Content response.