--- updatedAt: 2026-06-18T14:03:31.000Z agentTools: projectIndex: https://docs.melhorenvio.com.br/llms.txt --- # Pesquisar etiqueta
Através dessa rota é possível realizar a pesquisa de uma etiqueta através de alguns dados. No parâmetro `status` deve ser informado um dos seguintes status: pending, released, posted, delivered, undelivered, suspended (pendente, liberado, postado, entregue, não entregue, suspenso).
> 🚧 Importante > > Com base nos dados que são informados no parâmetro `q`, a pesquisa é feita apenas em um dos campos restritos, sendo eles os seguintes: > > * `id`; > * `protocol`; > * `document` ou `company_document` de um dos participantes (remetente ou destinatário); > * `tracking` (Rastreio da transportadora); > * `authorization_code` (Código de autorização). # 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/orders/search": { "get": { "summary": "Pesquisar etiqueta", "description": "", "operationId": "pesquisar-etiqueta", "parameters": [ { "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)" } }, { "name": "q", "in": "query", "description": "Informar o código de autorização, protocolo, código de rastreio, ID do envio ou documento.", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "200", "content": { "application/json": { "examples": { "Result": { "value": "[\n {\n \"id\": \"04c13ada-68e6-41df-a2c6-ff5f3e7560f8\",\n \"protocol\": \"ORD-20220395512\",\n \"service_id\": 3,\n \"contract\": null,\n \"service_code\": null,\n \"quote\": 25.35,\n \"price\": 25.35,\n \"coupon\": null,\n \"discount\": 5.71,\n \"delivery_min\": 5,\n \"delivery_max\": 6,\n \"status\": \"released\",\n \"reminder\": null,\n \"insurance_value\": 50,\n \"weight\": null,\n \"width\": null,\n \"height\": null,\n \"length\": null,\n \"diameter\": null,\n \"format\": \"box\",\n \"billed_weight\": 3.5,\n \"receipt\": false,\n \"own_hand\": false,\n \"collect\": false,\n \"collect_scheduled_at\": null,\n \"reverse\": false,\n \"non_commercial\": false,\n \"authorization_code\": \"2022032921\",\n \"tracking\": \"ME220021P41BR\",\n \"self_tracking\": \"ME220021P41BR\",\n \"delivery_receipt\": null,\n \"additional_info\": null,\n \"cte_key\": null,\n \"paid_at\": \"2022-03-29 21:17:26\",\n \"generated_at\": \"2022-03-29 21:38:30\",\n \"posted_at\": null,\n \"delivered_at\": null,\n \"canceled_at\": null,\n \"suspended_at\": null,\n \"expired_at\": null,\n \"created_at\": \"2022-03-29 20:24:17\",\n \"updated_at\": \"2022-03-29 21:38:30\",\n \"details\": {\n \"balance\": 0,\n \"gateway\": \"25.35\",\n \"discount\": \"0.00\",\n \"subtotal\": \"25.35\",\n \"total\": \"25.35\"\n },\n \"receipt_code\": null,\n \"from\": {\n \"name\": \"Teste ME\",\n \"phone\": \"5598105050\",\n \"email\": \"melhorenvio@teste.com\",\n \"document\": \"16571478358\",\n \"company_document\": \"04517623000197\",\n \"state_register\": \"563025255115\",\n \"postal_code\": \"7110000\",\n \"address\": \"Rua Teste\",\n \"location_number\": \"100\",\n \"complement\": \"CASA\",\n \"district\": \"Bairro Teste\",\n \"city\": \"Guarulhos\",\n \"state_abbr\": \"SP\",\n \"country_id\": \"BR\",\n \"latitude\": null,\n \"longitude\": null,\n \"note\": \"observação\"\n },\n \"to\": {\n \"name\": \"Melhor Envio Teste\",\n \"phone\": \"1999999999\",\n \"email\": \"melhorenvio@teste.com\",\n \"document\": \"73646548010\",\n \"company_document\": \"89794131000100\",\n \"state_register\": \"123456\",\n \"postal_code\": \"26210000\",\n \"address\": \"Avenida Marechal Floriano Peixoto\",\n \"location_number\": \"123\",\n \"complement\": \"Ap 2\",\n \"district\": \"Centro\",\n \"city\": \"Nova Iguacu\",\n \"state_abbr\": \"RJ\",\n \"country_id\": \"BR\",\n \"latitude\": null,\n \"longitude\": null,\n \"note\": \"observação\"\n },\n \"service\": {\n \"id\": 3,\n \"name\": \".Package\",\n \"type\": \"normal\",\n \"range\": \"interstate\",\n \"company\": {\n \"id\": 2,\n \"name\": \"Jadlog\",\n \"picture\": \"/images/shipping-companies/jadlog.png\"\n }\n },\n \"agency\": {\n \"id\": 24,\n \"name\": \"CO SANTO ANDRE 01\",\n \"initials\": \"CO-QSE-01\",\n \"code\": \"1008367\",\n \"company_name\": \"ABC SPEEDY WAY TURISMO E TRANSPORTES LTDA\",\n \"address\": null,\n \"phone\": null,\n \"contact\": null\n },\n \"invoice\": {\n \"model\": \"55\",\n \"number\": \"9248\",\n \"serie\": \"1\",\n \"key\": \"31190307586261000184550010000092481404848162\",\n \"value\": null,\n \"cfop\": null,\n \"issued_at\": \"2019-03-01 00:00:00\",\n \"uploaded_at\": null,\n \"to_document\": null\n },\n \"tags\": [],\n \"products\": [\n {\n \"name\": \"Papel adesivo para etiquetas 1\",\n \"quantity\": 3,\n \"unitary_value\": 100,\n \"weight\": null\n },\n {\n \"name\": \"Papel adesivo para etiquetas 2\",\n \"quantity\": 1,\n \"unitary_value\": 700,\n \"weight\": null\n }\n ],\n \"generated_key\": null,\n \"conciliation\": null,\n \"volumes\": [\n {\n \"id\": 99763,\n \"height\": \"10.00\",\n \"width\": \"15.00\",\n \"length\": \"20.00\",\n \"diameter\": \"0.00\",\n \"weight\": \"3.50\",\n \"format\": \"box\",\n \"created_at\": \"2022-03-29 20:24:17\",\n \"updated_at\": \"2022-03-29 20:24:17\"\n }\n ]\n }\n]" } }, "schema": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "example": "04c13ada-68e6-41df-a2c6-ff5f3e7560f8" }, "protocol": { "type": "string", "example": "ORD-20220395512" }, "service_id": { "type": "integer", "example": 3, "default": 0 }, "contract": {}, "service_code": {}, "quote": { "type": "number", "example": 25.35, "default": 0 }, "price": { "type": "number", "example": 25.35, "default": 0 }, "coupon": {}, "discount": { "type": "number", "example": 5.71, "default": 0 }, "delivery_min": { "type": "integer", "example": 5, "default": 0 }, "delivery_max": { "type": "integer", "example": 6, "default": 0 }, "status": { "type": "string", "example": "released" }, "reminder": {}, "insurance_value": { "type": "integer", "example": 50, "default": 0 }, "weight": {}, "width": {}, "height": {}, "length": {}, "diameter": {}, "format": { "type": "string", "example": "box" }, "billed_weight": { "type": "number", "example": 3.5, "default": 0 }, "receipt": { "type": "boolean", "example": false, "default": true }, "own_hand": { "type": "boolean", "example": false, "default": true }, "collect": { "type": "boolean", "example": false, "default": true }, "collect_scheduled_at": {}, "reverse": { "type": "boolean", "example": false, "default": true }, "non_commercial": { "type": "boolean", "example": false, "default": true }, "authorization_code": { "type": "string", "example": "2022032921" }, "tracking": { "type": "string", "example": "ME220021P41BR" }, "self_tracking": { "type": "string", "example": "ME220021P41BR" }, "delivery_receipt": {}, "additional_info": {}, "cte_key": {}, "paid_at": { "type": "string", "example": "2022-03-29 21:17:26" }, "generated_at": { "type": "string", "example": "2022-03-29 21:38:30" }, "posted_at": {}, "delivered_at": {}, "canceled_at": {}, "suspended_at": {}, "expired_at": {}, "created_at": { "type": "string", "example": "2022-03-29 20:24:17" }, "updated_at": { "type": "string", "example": "2022-03-29 21:38:30" }, "details": { "type": "object", "properties": { "balance": { "type": "integer", "example": 0, "default": 0 }, "gateway": { "type": "string", "example": "25.35" }, "discount": { "type": "string", "example": "0.00" }, "subtotal": { "type": "string", "example": "25.35" }, "total": { "type": "string", "example": "25.35" } } }, "receipt_code": {}, "from": { "type": "object", "properties": { "name": { "type": "string", "example": "Teste ME" }, "phone": { "type": "string", "example": "5598105050" }, "email": { "type": "string", "example": "melhorenvio@teste.com" }, "document": { "type": "string", "example": "16571478358" }, "company_document": { "type": "string", "example": "04517623000197" }, "state_register": { "type": "string", "example": "563025255115" }, "postal_code": { "type": "string", "example": "7110000" }, "address": { "type": "string", "example": "Rua Teste" }, "location_number": { "type": "string", "example": "100" }, "complement": { "type": "string", "example": "CASA" }, "district": { "type": "string", "example": "Bairro Teste" }, "city": { "type": "string", "example": "Guarulhos" }, "state_abbr": { "type": "string", "example": "SP" }, "country_id": { "type": "string", "example": "BR" }, "latitude": {}, "longitude": {}, "note": { "type": "string", "example": "observação" } } }, "to": { "type": "object", "properties": { "name": { "type": "string", "example": "Melhor Envio Teste" }, "phone": { "type": "string", "example": "1999999999" }, "email": { "type": "string", "example": "melhorenvio@teste.com" }, "document": { "type": "string", "example": "73646548010" }, "company_document": { "type": "string", "example": "89794131000100" }, "state_register": { "type": "string", "example": "123456" }, "postal_code": { "type": "string", "example": "26210000" }, "address": { "type": "string", "example": "Avenida Marechal Floriano Peixoto" }, "location_number": { "type": "string", "example": "123" }, "complement": { "type": "string", "example": "Ap 2" }, "district": { "type": "string", "example": "Centro" }, "city": { "type": "string", "example": "Nova Iguacu" }, "state_abbr": { "type": "string", "example": "RJ" }, "country_id": { "type": "string", "example": "BR" }, "latitude": {}, "longitude": {}, "note": { "type": "string", "example": "observação" } } }, "service": { "type": "object", "properties": { "id": { "type": "integer", "example": 3, "default": 0 }, "name": { "type": "string", "example": ".Package" }, "type": { "type": "string", "example": "normal" }, "range": { "type": "string", "example": "interstate" }, "company": { "type": "object", "properties": { "id": { "type": "integer", "example": 2, "default": 0 }, "name": { "type": "string", "example": "Jadlog" }, "picture": { "type": "string", "example": "/images/shipping-companies/jadlog.png" } } } } }, "agency": { "type": "object", "properties": { "id": { "type": "integer", "example": 24, "default": 0 }, "name": { "type": "string", "example": "CO SANTO ANDRE 01" }, "initials": { "type": "string", "example": "CO-QSE-01" }, "code": { "type": "string", "example": "1008367" }, "company_name": { "type": "string", "example": "ABC SPEEDY WAY TURISMO E TRANSPORTES LTDA" }, "address": {}, "phone": {}, "contact": {} } }, "invoice": { "type": "object", "properties": { "model": { "type": "string", "example": "55" }, "number": { "type": "string", "example": "9248" }, "serie": { "type": "string", "example": "1" }, "key": { "type": "string", "example": "31190307586261000184550010000092481404848162" }, "value": {}, "cfop": {}, "issued_at": { "type": "string", "example": "2019-03-01 00:00:00" }, "uploaded_at": {}, "to_document": {} } }, "tags": { "type": "array", "items": { "type": "object", "properties": {} } }, "products": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string", "example": "Papel adesivo para etiquetas 1" }, "quantity": { "type": "integer", "example": 3, "default": 0 }, "unitary_value": { "type": "integer", "example": 100, "default": 0 }, "weight": {} } } }, "generated_key": {}, "conciliation": {}, "volumes": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "integer", "example": 99763, "default": 0 }, "height": { "type": "string", "example": "10.00" }, "width": { "type": "string", "example": "15.00" }, "length": { "type": "string", "example": "20.00" }, "diameter": { "type": "string", "example": "0.00" }, "weight": { "type": "string", "example": "3.50" }, "format": { "type": "string", "example": "box" }, "created_at": { "type": "string", "example": "2022-03-29 20:24:17" }, "updated_at": { "type": "string", "example": "2022-03-29 20:24:17" } } } } } } } } } }, "400": { "description": "400", "content": { "application/json": { "examples": { "Result": { "value": "{\n \"error\": \"Not Found\"\n}" } }, "schema": { "type": "object", "properties": { "error": { "type": "string", "example": "Not Found" } } } } } } }, "deprecated": false } } }, "x-readme": { "headers": [], "explorer-enabled": true, "proxy-enabled": true }, "x-readme-fauxas": true } ```