Delete address

This endpoint allows you to delete a specific address from a customer. You must send the customer ID and the address ID in the path. In case of success, the request will return a response with status 200.

DELETE

https://api.mercadopago.com/v1/customers/{id}/addresses/{address_id}
Request parameters
Header
Authorization
string

REQUIRED

Access Token obtained through the developer panel. Must be sent in all requests.
Path
id
string

REQUIRED

Customer ID.
address_id
string

REQUIRED

Address ID.
Response parameters
id
string
Address ID.
phone
string
Phone number associated with the address.
name
string
Address name/label.
floor
string
Floor number.
Errors

400Request error.

100

The credentials are required. Provide a valid access token in the Authorization header.

validation_error

Validation error. One or more fields failed validation. Check the request body and ensure all required fields are correctly formatted.

401Error. Access Token not authorized.

unauthorized

Unauthorized access. The provided access token is invalid or expired. Verify your credentials and try again.

404Error. Requested resource not found.

not_found

The requested resource was not found. Verify that the customer ID and address ID are correct and that the address exists.

500Generic error.

internal_error

Internal server error. Please try again later or contact support if the issue persists.

Request
curl -X DELETE \
    'https://api.mercadopago.com/v1/customers/{id}/addresses/{address_id}'\
    -H 'Content-Type: application/json' \
       -H 'Authorization: Bearer APP_USR-1*********685765-12*********1b4332e5c*********e077d7679*********664' \
    
Response
{
  "id": "1162600213",
  "street_name": "Rua Exemplo",
  "zip_code": "01234567",
  "city": {
    "id": "BR-SP-44",
    "name": "São Paulo"
  },
  "state": {
    "id": "BR-SP",
    "name": "São Paulo"
  },
  "country": {
    "id": "BR",
    "name": "Brasil"
  },
  "neighborhood": {
    "name": "Jardim Ipanema"
  },
  "municipality": {},
  "date_created": "2021-03-16T15:45:17.000-04:00",
  "live_mode": true
}