Addresses

Retrieving a customer's addresses

get

Retrieves a list of addresses for a customer.

Note: The request needs to be authorized with a customer's access token.


Required scopes

No specific scopes are required.

Authorizations
Path parameters
tenantstring · min: 3 · max: 16Required

Your Emporix tenant's name.

Note: The tenant should always be written in lowercase.

Pattern: ^[a-z][a-z0-9]+$
Responses
200
OK
application/json
get
GET /customer/{tenant}/me/addresses HTTP/1.1
Host: api.emporix.io
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
[
  {
    "contactName": "John Doe",
    "companyName": "Emporix",
    "street": "Platz der Republik",
    "streetNumber": "1",
    "streetAppendix": "",
    "extraLine1": "",
    "extraLine2": "",
    "extraLine3": "",
    "extraLine4": "",
    "zipCode": "11011",
    "city": "Berlin",
    "country": "DE",
    "state": "Berlin",
    "contactPhone": "123456789",
    "tags": [
      "BILLING",
      "SHIPPING"
    ],
    "id": "b05c20e034",
    "isDefault": true
  }
]

Adding a customer address

post

Adds an address to a customer's profile.

Note: The request needs to be authorized with a customer's access token.


Required scopes

No specific scopes are required.

Authorizations
Path parameters
tenantstring · min: 3 · max: 16Required

Your Emporix tenant's name.

Note: The tenant should always be written in lowercase.

Pattern: ^[a-z][a-z0-9]+$
Body
contactNamestringOptional
companyNamestringOptional
streetstringOptional
streetNumberstringOptional
streetAppendixstringOptional
extraLine1stringOptional
extraLine2stringOptional
extraLine3stringOptional
extraLine4stringOptional
zipCodestringOptional
citystringOptional
countrystringOptional
statestringOptional
contactPhonestringOptional
tagsstring[]Optional
Responses
201
Created
application/json
post
POST /customer/{tenant}/me/addresses HTTP/1.1
Host: api.emporix.io
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 306

{
  "contactName": "John Doe",
  "companyName": "Emporix",
  "street": "Platz der Republik",
  "streetNumber": "1",
  "streetAppendix": "",
  "extraLine1": "",
  "extraLine2": "",
  "extraLine3": "",
  "extraLine4": "",
  "zipCode": "11011",
  "city": "Berlin",
  "country": "DE",
  "state": "Berlin",
  "contactPhone": "123456789",
  "tags": [
    "BILLING",
    "SHIPPING"
  ]
}
{
  "id": "b05c20e034"
}

Retrieving a customer's address

get

Retrieves a specified customer address and its details.

Note: The request needs to be authorized with a customer's access token.


Required scopes

No specific scopes are required.

Authorizations
Path parameters
addressIdstring · min: 1Required

Address' unique identifier generated when the address is added to a customer's profile.

tenantstring · min: 3 · max: 16Required

Your Emporix tenant's name.

Note: The tenant should always be written in lowercase.

Pattern: ^[a-z][a-z0-9]+$
Responses
200
OK
application/json
Responseall of
get
GET /customer/{tenant}/me/addresses/{addressId} HTTP/1.1
Host: api.emporix.io
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
  "contactName": "John Doe",
  "companyName": "Emporix",
  "street": "Platz der Republik",
  "streetNumber": "1",
  "streetAppendix": "",
  "extraLine1": "",
  "extraLine2": "",
  "extraLine3": "",
  "extraLine4": "",
  "zipCode": "11011",
  "city": "Berlin",
  "country": "DE",
  "state": "Berlin",
  "contactPhone": "123456789",
  "tags": [
    "BILLING",
    "SHIPPING"
  ],
  "id": "b05c20e034",
  "isDefault": true
}

Deleting a customer's address

delete

Deletes a specified customer address and accounts associated with it.

Note: The request needs to be authorized with a customer's access token.


Required scopes

No specific scopes are required.

Authorizations
Path parameters
addressIdstring · min: 1Required

Address' unique identifier generated when the address is added to a customer's profile.

tenantstring · min: 3 · max: 16Required

Your Emporix tenant's name.

Note: The tenant should always be written in lowercase.

Pattern: ^[a-z][a-z0-9]+$
Responses
204
No Content
delete
DELETE /customer/{tenant}/me/addresses/{addressId} HTTP/1.1
Host: api.emporix.io
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content

Updating a customer's address

patch

Updates a specified customer address.

Note: The request needs to be authorized with a customer's access token.


Required scopes

No specific scopes are required.

Authorizations
Path parameters
addressIdstring · min: 1Required

Address' unique identifier generated when the address is added to a customer's profile.

tenantstring · min: 3 · max: 16Required

Your Emporix tenant's name.

Note: The tenant should always be written in lowercase.

Pattern: ^[a-z][a-z0-9]+$
Body
all ofOptional
Responses
200
OK
patch
PATCH /customer/{tenant}/me/addresses/{addressId} HTTP/1.1
Host: api.emporix.io
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 323

{
  "contactName": "John Doe",
  "companyName": "Emporix",
  "street": "Platz der Republik",
  "streetNumber": "1",
  "streetAppendix": "",
  "extraLine1": "",
  "extraLine2": "",
  "extraLine3": "",
  "extraLine4": "",
  "zipCode": "11011",
  "city": "Berlin",
  "country": "DE",
  "state": "Berlin",
  "contactPhone": "123456789",
  "tags": [
    "BILLING",
    "SHIPPING"
  ],
  "isDefault": true
}

No content

Adding tags to a customer's address

post

Adds tags to a specified customer address.

Note: The request needs to be authorized with a customer's access token.


Required scopes

No specific scopes are required.

Authorizations
Path parameters
tenantstring · min: 3 · max: 16Required

Your Emporix tenant's name.

Note: The tenant should always be written in lowercase.

Pattern: ^[a-z][a-z0-9]+$
addressIdstring · min: 1Required

Address' unique identifier generated when the address is added to a customer's profile.

Query parameters
tagsstring · min: 1Required

List of address tags, separated by commas.

Example: BILLING,SHIPPING
Responses
204
No Content
post
POST /customer/{tenant}/me/addresses/{addressId}/tags HTTP/1.1
Host: api.emporix.io
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content

Deleting tags from a customer's address

delete

Deletes tags from a specified customer address.

Note: The request needs to be authorized with a customer's access token.


Required scopes

No specific scopes are required.

Authorizations
Path parameters
tenantstring · min: 3 · max: 16Required

Your Emporix tenant's name.

Note: The tenant should always be written in lowercase.

Pattern: ^[a-z][a-z0-9]+$
addressIdstring · min: 1Required

Address' unique identifier generated when the address is added to a customer's profile.

Query parameters
tagsstring · min: 1Required

List of address tags, separated by commas.

Example: BILLING,SHIPPING
Responses
204
No Content
delete
DELETE /customer/{tenant}/me/addresses/{addressId}/tags HTTP/1.1
Host: api.emporix.io
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content

Was this helpful?