Update Legal Address

Update Legal Address

This endpoint is used to update a legal address.

PUT {{Environment_URL}}/customers/v1/partner/legal/:cnpj/addresses

Headers

Name	Value
Authorization	Bearer <token>

Path Params

Key	Description	Required	Data Type	Example
cnpj	CNPJ in format 58393613000116	true	String	58393613000116

Body Params

The request body follows the same structure and validation rules as the Create Legal Address endpoint. This route should be used exclusively to update one or more existing attributes of a registered legal address.

Observations

Attribute	Description
state	Must have 2 uppercase letters and be a valid Brazilian state
zipCode	Must include - and have 9 digits (e.g., XXXXX-XXX)
country	Must follow ISO 3166-1 alpha-3 format, with 3 uppercase letters

Request Body

Create Legal Address

{
    "zipCode": "12345-678",
    "country": "Brazil",
    "state": "SP",
    "city": "São Paulo",
    "neighborhood": "Itaquera",
    "street": "Av Itaquera",
    "number": 123,
    "complement": "ap 10",
    "nickname": "casa",
    "default": true
}

Response

201 - Success

[
  {
    "id": "68b99847de7f13119148568f",
    "state": "SP",
    "city": "São Paulo",
    "neighborhood": "Vila Olímpia",
    "street": "Travessa Doutor José Alves de Souza Neto",
    "number": 20,
    "complement": "Teste Update",
    "zipCode": "04552-010",
    "default": false,
    "nickname": "Goma",
    "fullAddress": "Travessa Doutor José Alves de Souza Neto, 20 Teste Update - Vila Olímpia - São Paulo/SP, undefined - 04552-010"
  },
  {
    "id": "68bda9b17748028a3e6b262e",
    "country": "Brazil",
    "state": "SP",
    "city": "São Paulo",
    "neighborhood": "Itaquera",
    "street": "Av Itaquera",
    "number": 123,
    "complement": "fundo",
    "zipCode": "12345-678",
    "default": true,
    "nickname": "casa",
    "fullAddress": "Av Itaquera, 123 ap 10 - Itaquera - São Paulo/SP, Brazil - 12345-678"
  }
]