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

# Listar telefones de uma loja

Cadastro e visualização de endereços e telefones de lojas

<div style={{ textAlign: "justify" }}>
  Uma vez cadastrada a loja, é possível consultar os telefones da mesma. Para isso deve ser informado, como parâmetro da URL, o `id` 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}/phones": {
      "get": {
        "summary": "Listar telefones de uma loja",
        "description": "Cadastro e visualização de endereços e telefones de lojas",
        "operationId": "listar-telefones-de-uma-loja",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "ID da Loja",
            "schema": {
              "type": "string"
            },
            "required": true
          },
          {
            "name": "Accept",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "default": "application/json"
            }
          },
          {
            "name": "Content-Type",
            "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\": 42304,\n      \"label\": null,\n      \"phone\": \"5340302030\",\n      \"type\": \"mobile\",\n      \"country_id\": \"BR\",\n      \"confirmed_at\": null,\n      \"created_at\": \"2022-03-30 20:32:31\",\n      \"updated_at\": \"2022-03-30 20:32:31\"\n    },\n    {\n      \"id\": 42303,\n      \"label\": null,\n      \"phone\": \"5530203020\",\n      \"type\": \"mobile\",\n      \"country_id\": \"BR\",\n      \"confirmed_at\": null,\n      \"created_at\": \"2022-03-30 20:28:52\",\n      \"updated_at\": \"2022-03-30 20:28:52\"\n    }\n  ],\n  \"first_page_url\": \"https://sandbox.melhorenvio.com.br/api/v2/me/companies/bde0e453-1d10-4245-a447-d376ae24be55/phones?page=1\",\n  \"from\": 1,\n  \"last_page\": 1,\n  \"last_page_url\": \"https://sandbox.melhorenvio.com.br/api/v2/me/companies/bde0e453-1d10-4245-a447-d376ae24be55/phones?page=1\",\n  \"next_page_url\": null,\n  \"path\": \"https://sandbox.melhorenvio.com.br/api/v2/me/companies/bde0e453-1d10-4245-a447-d376ae24be55/phones\",\n  \"per_page\": 10,\n  \"prev_page_url\": null,\n  \"to\": 2,\n  \"total\": 2\n}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "current_page": {
                      "type": "integer",
                      "example": 1,
                      "default": 0
                    },
                    "data": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "integer",
                            "example": 42304,
                            "default": 0
                          },
                          "label": {},
                          "phone": {
                            "type": "string",
                            "example": "5340302030"
                          },
                          "type": {
                            "type": "string",
                            "example": "mobile"
                          },
                          "country_id": {
                            "type": "string",
                            "example": "BR"
                          },
                          "confirmed_at": {},
                          "created_at": {
                            "type": "string",
                            "example": "2022-03-30 20:32:31"
                          },
                          "updated_at": {
                            "type": "string",
                            "example": "2022-03-30 20:32:31"
                          }
                        }
                      }
                    },
                    "first_page_url": {
                      "type": "string",
                      "example": "https://sandbox.melhorenvio.com.br/api/v2/me/companies/bde0e453-1d10-4245-a447-d376ae24be55/phones?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/bde0e453-1d10-4245-a447-d376ae24be55/phones?page=1"
                    },
                    "next_page_url": {},
                    "path": {
                      "type": "string",
                      "example": "https://sandbox.melhorenvio.com.br/api/v2/me/companies/bde0e453-1d10-4245-a447-d376ae24be55/phones"
                    },
                    "per_page": {
                      "type": "integer",
                      "example": 10,
                      "default": 0
                    },
                    "prev_page_url": {},
                    "to": {
                      "type": "integer",
                      "example": 2,
                      "default": 0
                    },
                    "total": {
                      "type": "integer",
                      "example": 2,
                      "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
}
```