---
updatedAt: 2026-06-18T14:03:31.000Z
agentTools:
  projectIndex: https://docs.melhorenvio.com.br/llms.txt
---

# Listar endereços de uma loja

<div style={{ textAlign: "justify" }}>

Uma vez cadastrada a loja, é possível consultar o endereço da mesma. Para isto, deve ser informado como parâmetro da URL o `id` retornado no cadastro da loja.

</div>

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "api-melhor-envio-sandbox",
    "version": "1.0"
  },
  "servers": [
    {
      "url": "https://sandbox.melhorenvio.com.br/",
      "description": "Ambiente de Sandbox (Testes)"
    },
    {
      "url": "https://melhorenvio.com.br/",
      "description": "Ambiente de Produção (Real)"
    }
  ],
  "security": [
    {}
  ],
  "paths": {
    "/api/v2/me/companies/{storeId}/addresses": {
      "get": {
        "summary": "Listar endereços de uma loja",
        "description": "",
        "operationId": "listar-enderecos-de-uma-loja",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "ID da loja",
            "schema": {
              "type": "string"
            },
            "required": true
          },
          {
            "name": "Content-type",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "default": "application/json"
            }
          },
          {
            "name": "Accept",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "default": "application/json"
            }
          },
          {
            "name": "Authorization",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "default": "Bearer token"
            }
          },
          {
            "name": "User-Agent",
            "in": "header",
            "description": "É obrigatório que seja adicionado o cabeçalho HTTP User-Agent com o nome da sua aplicação junto a um email de contato/suporte.",
            "required": true,
            "schema": {
              "type": "string",
              "default": "Aplicação (email para contato técnico)"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "200",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{\n  \"current_page\": 1,\n  \"data\": [\n    {\n      \"id\": 32336,\n      \"label\": \"\",\n      \"postal_code\": \"07110000\",\n      \"address\": \"Av Teste\",\n      \"number\": \"123\",\n      \"complement\": \"ABC\",\n      \"district\": null,\n      \"latitude\": null,\n      \"longitude\": null,\n      \"confirmed_at\": null,\n      \"created_at\": \"2022-03-30 17:08:23\",\n      \"updated_at\": \"2022-03-30 17:08:23\",\n      \"city\": {\n        \"id\": 5269,\n        \"city\": \"São Paulo\",\n        \"state\": {\n          \"id\": 25,\n          \"state\": \"São Paulo\",\n          \"state_abbr\": \"SP\",\n          \"country\": {\n            \"id\": \"BR\",\n            \"country\": \"Brazil\"\n          }\n        }\n      }\n    }\n  ],\n  \"first_page_url\": \"https://sandbox.melhorenvio.com.br/api/v2/me/companies/781f86be-c3be-47e7-9bef-70b8675a55c3/addresses?page=1\",\n  \"from\": 1,\n  \"last_page\": 1,\n  \"last_page_url\": \"https://sandbox.melhorenvio.com.br/api/v2/me/companies/781f86be-c3be-47e7-9bef-70b8675a55c3/addresses?page=1\",\n  \"next_page_url\": null,\n  \"path\": \"https://sandbox.melhorenvio.com.br/api/v2/me/companies/781f86be-c3be-47e7-9bef-70b8675a55c3/addresses\",\n  \"per_page\": 10,\n  \"prev_page_url\": null,\n  \"to\": 1,\n  \"total\": 1\n}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "current_page": {
                      "type": "integer",
                      "example": 1,
                      "default": 0
                    },
                    "data": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "integer",
                            "example": 32336,
                            "default": 0
                          },
                          "label": {
                            "type": "string",
                            "example": ""
                          },
                          "postal_code": {
                            "type": "string",
                            "example": "07110000"
                          },
                          "address": {
                            "type": "string",
                            "example": "Av Teste"
                          },
                          "number": {
                            "type": "string",
                            "example": "123"
                          },
                          "complement": {
                            "type": "string",
                            "example": "ABC"
                          },
                          "district": {},
                          "latitude": {},
                          "longitude": {},
                          "confirmed_at": {},
                          "created_at": {
                            "type": "string",
                            "example": "2022-03-30 17:08:23"
                          },
                          "updated_at": {
                            "type": "string",
                            "example": "2022-03-30 17:08:23"
                          },
                          "city": {
                            "type": "object",
                            "properties": {
                              "id": {
                                "type": "integer",
                                "example": 5269,
                                "default": 0
                              },
                              "city": {
                                "type": "string",
                                "example": "São Paulo"
                              },
                              "state": {
                                "type": "object",
                                "properties": {
                                  "id": {
                                    "type": "integer",
                                    "example": 25,
                                    "default": 0
                                  },
                                  "state": {
                                    "type": "string",
                                    "example": "São Paulo"
                                  },
                                  "state_abbr": {
                                    "type": "string",
                                    "example": "SP"
                                  },
                                  "country": {
                                    "type": "object",
                                    "properties": {
                                      "id": {
                                        "type": "string",
                                        "example": "BR"
                                      },
                                      "country": {
                                        "type": "string",
                                        "example": "Brazil"
                                      }
                                    }
                                  }
                                }
                              }
                            }
                          }
                        }
                      }
                    },
                    "first_page_url": {
                      "type": "string",
                      "example": "https://sandbox.melhorenvio.com.br/api/v2/me/companies/781f86be-c3be-47e7-9bef-70b8675a55c3/addresses?page=1"
                    },
                    "from": {
                      "type": "integer",
                      "example": 1,
                      "default": 0
                    },
                    "last_page": {
                      "type": "integer",
                      "example": 1,
                      "default": 0
                    },
                    "last_page_url": {
                      "type": "string",
                      "example": "https://sandbox.melhorenvio.com.br/api/v2/me/companies/781f86be-c3be-47e7-9bef-70b8675a55c3/addresses?page=1"
                    },
                    "next_page_url": {},
                    "path": {
                      "type": "string",
                      "example": "https://sandbox.melhorenvio.com.br/api/v2/me/companies/781f86be-c3be-47e7-9bef-70b8675a55c3/addresses"
                    },
                    "per_page": {
                      "type": "integer",
                      "example": 10,
                      "default": 0
                    },
                    "prev_page_url": {},
                    "to": {
                      "type": "integer",
                      "example": 1,
                      "default": 0
                    },
                    "total": {
                      "type": "integer",
                      "example": 1,
                      "default": 0
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "404",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{\n  \"message\": \"No query results for model [App\\\\Company].\"\n}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "message": {
                      "type": "string",
                      "example": "No query results for model [App\\Company]."
                    }
                  }
                }
              }
            }
          }
        },
        "deprecated": false
      }
    }
  },
  "x-readme": {
    "headers": [],
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true
}
```