--- updatedAt: 2026-06-04T08:19:34.000Z agentTools: projectIndex: https://developers.99minutos.com/llms.txt --- # /api/v3/webhooks Get webhooks configurations webhook notification example: ```json { "StatusName": "stored", // Current status of the order, the complete list of events at the tracking endpoint, are sent in camelCase. "TrackingId": "2139671481", // Identifier generated by 99minutos "InternalKey": "SOME_ID", // Identifier sent by the customer "Events": [ // List of events through which the shipment has transited in ascending order { "StatusCode": "1002", "StatusName": "confirmed", "Data": { "comment": "NEW_ORDER_CONFIRMED", // Additional event information "evidence": [] // Evidence of transition, applies only to delivery events, failed delivery attempts and pickup. }, "CreatedAt": "2023-01-02 23:55:39" // UTC Time }, { "StatusCode": "2003", "StatusName": "collected", "Data": { "comment": "Recolectada por el veloz Don Veloz N/A 99m B 2eeb2a6", "evidence": [] }, "CreatedAt": "2023-01-03 20:12:43" }, { "StatusCode": "3001", "StatusName": "stored", "Data": { "comment": "En estación MX5 por módulo de inducción", "evidence": [] }, "CreatedAt": "2023-01-03 22:20:02" }, { "StatusCode": "3004", "StatusName": "onLinehaul", "Data": { "comment": "En camino a estación Tultitlán desde estación Pantaco por jhon.doe el número de orden 2139671481", "evidence": [] }, "CreatedAt": "2023-01-04 01:13:46" }, { "StatusCode": "3001", "StatusName": "stored", "Data": { "comment": "En estación MX0 por módulo de inducción", "evidence": [] }, "CreatedAt": "2023-01-04 04:17:42" }, { "StatusCode": "3002", "StatusName": "onContainer", "Data": { "comment": "Contenerizado en la estación MX0 en el contenedor VQA-319 en el finger F1", "evidence": [] }, "CreatedAt": "2023-01-04 06:28:12" }, { "StatusCode": "3003", "StatusName": "chargedToVehicle", "Data": { "comment": "Subida al line haul del veloz Jhon Doe con las placas LA37321 en la estacion MX0 dentro del contenedor VQA-319", "evidence": [] }, "CreatedAt": "2023-01-05 05:13:24" }, { "StatusCode": "3004", "StatusName": "onLinehaul", "Data": { "comment": "Despachado de la estación MX0 hacia la estación MCH2, en el line haul del veloz Jhon Doe con las placas LA37321 en el contenedor VQA-319", "evidence": [] }, "CreatedAt": "2023-01-05 06:31:29" }, { "StatusCode": "3001", "StatusName": "stored", "Data": { "comment": "En estación final MCH2 por módulo de inducción", "evidence": [] }, "CreatedAt": "2023-01-05 16:37:06" }, { "StatusCode": "4001", "StatusName": "onRoadToDelivery", "Data": { "comment": "Asignada a entrega en la estación al veloz Jhon. Ruta: 49b91331-2be0-2fd4-9b25-1accc772f937", "evidence": [] }, "CreatedAt": "2023-01-05 16:01:40" }, { "StatusCode": "4002", "StatusName": "delivered", "Data": { "comment": "Titular - Carlos Ramirez | <>", "evidence": [ "https://copilot-image-proxy-qndxoltwga-uc.a.run.app/view/62b6fec1836a6321a5ca5a4a.jpeg", // url to the photo of the evidences "https://copilot-image-proxy-qndxoltwga-uc.a.run.app/view/63b1fec1b030b63f06db10a5.jpeg", "https://copilot-image-proxy-qndxoltwga-uc.a.run.app/view/62b1fab2b031b63d01da31b7.jpeg" ] }, "CreatedAt": "2023-01-05 16:45:54" } // You can have n events until delivery or return. ] } ``` # OpenAPI definition ````json { "openapi": "3.0.3", "x-stoplight": { "id": "tt90qxfs5i6qr" }, "info": { "title": "API Version 3", "version": "3.0.0", "description": "This is the documentation for the public api *(version 3)* of 99minutos. [https://www.99minutos.com/.](https://www.99minutos.com/.EnvironmentAPI)\n\n# First Steps\n\n1. Create an account in the sandbox website: [https://delivery-git-sandbox-99minutos.vercel.app/](https://delivery-git-sandbox-99minutos.vercel.app/)\n2. Go to Developers section\n3. On API Keys V3 section click on `Generar`\n4. After this the `client_id` and `client_secret` will be displayed\n \n\nUse the credentials to generate access tokens as shown below in the endpoint `create access token`\n\nFollow the same process in production.\n\n## Environments\n\n| **Environment** | **Website** | **API url** |\n| --- | --- | --- |\n| Sandbox | [https://delivery-git-sandbox-99minutos.vercel.app/](https://delivery-git-sandbox-99minutos.vercel.app/) | [https://sandbox.99minutos.com](https://sandbox.99minutos.com) |\n| Production | [https://envios.99minutos.com/developers](https://envios.99minutos.com/developers) | [https://delivery.99minutos.com](https://delivery.99minutos.com) |\n\n`Each environment has an independent set of credentials`" }, "paths": { "/api/v3/webhooks": { "get": { "summary": "", "operationId": "get-api-v3-webhooks", "responses": { "200": { "$ref": "#/components/responses/ConfigGetResponse" } }, "description": "Get webhooks configurations\n\nwebhook notification example:\n\n```json\n{\n \"StatusName\": \"stored\", // Current status of the order, the complete list of events at the tracking endpoint, are sent in camelCase.\n \"TrackingId\": \"2139671481\", // Identifier generated by 99minutos\n \"InternalKey\": \"SOME_ID\", // Identifier sent by the customer\n \"Events\": [ // List of events through which the shipment has transited in ascending order \n {\n \"StatusCode\": \"1002\",\n \"StatusName\": \"confirmed\",\n \"Data\": {\n \"comment\": \"NEW_ORDER_CONFIRMED\", // Additional event information\n \"evidence\": [] // Evidence of transition, applies only to delivery events, failed delivery attempts and pickup.\n },\n \"CreatedAt\": \"2023-01-02 23:55:39\" // UTC Time\n },\n {\n \"StatusCode\": \"2003\",\n \"StatusName\": \"collected\",\n \"Data\": {\n \"comment\": \"Recolectada por el veloz Don Veloz N/A 99m B 2eeb2a6\",\n \"evidence\": []\n },\n \"CreatedAt\": \"2023-01-03 20:12:43\"\n },\n {\n \"StatusCode\": \"3001\",\n \"StatusName\": \"stored\",\n \"Data\": {\n \"comment\": \"En estación MX5 por módulo de inducción\",\n \"evidence\": []\n },\n \"CreatedAt\": \"2023-01-03 22:20:02\"\n },\n {\n \"StatusCode\": \"3004\",\n \"StatusName\": \"onLinehaul\",\n \"Data\": {\n \"comment\": \"En camino a estación Tultitlán desde estación Pantaco por jhon.doe el número de orden 2139671481\",\n \"evidence\": []\n },\n \"CreatedAt\": \"2023-01-04 01:13:46\"\n },\n {\n \"StatusCode\": \"3001\",\n \"StatusName\": \"stored\",\n \"Data\": {\n \"comment\": \"En estación MX0 por módulo de inducción\",\n \"evidence\": []\n },\n \"CreatedAt\": \"2023-01-04 04:17:42\"\n },\n {\n \"StatusCode\": \"3002\",\n \"StatusName\": \"onContainer\",\n \"Data\": {\n \"comment\": \"Contenerizado en la estación MX0 en el contenedor VQA-319 en el finger F1\",\n \"evidence\": []\n },\n \"CreatedAt\": \"2023-01-04 06:28:12\"\n },\n {\n \"StatusCode\": \"3003\",\n \"StatusName\": \"chargedToVehicle\",\n \"Data\": {\n \"comment\": \"Subida al line haul del veloz Jhon Doe con las placas LA37321 en la estacion MX0 dentro del contenedor VQA-319\",\n \"evidence\": []\n },\n \"CreatedAt\": \"2023-01-05 05:13:24\"\n },\n {\n \"StatusCode\": \"3004\",\n \"StatusName\": \"onLinehaul\",\n \"Data\": {\n \"comment\": \"Despachado de la estación MX0 hacia la estación MCH2, en el line haul del veloz Jhon Doe con las placas LA37321 en el contenedor VQA-319\",\n \"evidence\": []\n },\n \"CreatedAt\": \"2023-01-05 06:31:29\"\n },\n {\n \"StatusCode\": \"3001\",\n \"StatusName\": \"stored\",\n \"Data\": {\n \"comment\": \"En estación final MCH2 por módulo de inducción\",\n \"evidence\": []\n },\n \"CreatedAt\": \"2023-01-05 16:37:06\"\n },\n {\n \"StatusCode\": \"4001\",\n \"StatusName\": \"onRoadToDelivery\",\n \"Data\": {\n \"comment\": \"Asignada a entrega en la estación al veloz Jhon. Ruta: 49b91331-2be0-2fd4-9b25-1accc772f937\",\n \"evidence\": []\n },\n \"CreatedAt\": \"2023-01-05 16:01:40\"\n },\n {\n \"StatusCode\": \"4002\",\n \"StatusName\": \"delivered\",\n \"Data\": {\n \"comment\": \"Titular - Carlos Ramirez | <>\",\n \"evidence\": [\n \"https://copilot-image-proxy-qndxoltwga-uc.a.run.app/view/62b6fec1836a6321a5ca5a4a.jpeg\", // url to the photo of the evidences\n \"https://copilot-image-proxy-qndxoltwga-uc.a.run.app/view/63b1fec1b030b63f06db10a5.jpeg\",\n \"https://copilot-image-proxy-qndxoltwga-uc.a.run.app/view/62b1fab2b031b63d01da31b7.jpeg\"\n ]\n },\n \"CreatedAt\": \"2023-01-05 16:45:54\"\n }\n // You can have n events until delivery or return.\n ]\n}\n```", "security": [ { "AuthJWT": [] } ], "tags": [ "webhooks" ] } } }, "components": { "securitySchemes": { "AuthJWT": { "type": "http", "scheme": "bearer", "bearerFormat": "JWT" } }, "responses": { "ConfigGetResponse": { "description": "Example response", "content": { "application/json": { "schema": { "type": "object", "x-examples": { "example-1": { "status": 200, "message": "OK", "data": [ { "id": "76bf6210-8013-4462-a126-475c2d577752", "url": "http://foo-webhook/bar", "headers": { "Authorization": "Basic KEY", "Content-Type": "application/json", "User-Agent": "99notifications" } }, { "id": "4c136c4a-cdf6-4b37-879e-f0c4a1082856", "url": "http://foo-webhook/bar", "headers": { "Authorization": "Basic KEY", "Content-Type": "application/json", "User-Agent": "99notifications" } } ] } }, "properties": { "status": { "type": "integer" }, "message": { "type": "string" }, "data": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "url": { "type": "string", "format": "uri" }, "headers": { "type": "object", "properties": { "Authorization": { "type": "string" }, "Content-Type": { "type": "string" }, "User-Agent": { "type": "string" } } } } } } } }, "examples": { "Config get response": { "value": { "status": 200, "message": "OK", "data": [ { "id": "76bf6210-8013-4462-a126-475c2d577752", "url": "http://foo-webhook/bar", "headers": { "Authorization": "Basic KEY", "Content-Type": "application/json", "User-Agent": "99notifications" } }, { "id": "4c136c4a-cdf6-4b37-879e-f0c4a1082856", "url": "http://foo-webhook/bar", "headers": { "Authorization": "Basic KEY", "Content-Type": "application/json", "User-Agent": "99notifications" } } ] } } } } } } } }, "servers": [ { "url": "https://delivery.99minutos.com", "description": "Produccion" }, { "url": "https://sandbox.99minutos.com", "description": "Sandbox Environment" } ], "x-readme": { "explorer-enabled": true, "proxy-enabled": true, "samples-enabled": true } } ```` # Sibling pages * [/api/v3/webhooks](https://developers.99minutos.com/reference/post-api-v3-webhooks.md) * [/api/v3/webhooks/{webhook_id}](https://developers.99minutos.com/reference/patch-api-v3-webhooks-webhook_id.md) * [/api/v3/webhooks/{webhook_id}](https://developers.99minutos.com/reference/delete-api-v3-webhooks-webhook_id.md) * [/api/v3/webhooks/evidences/{tracking_id}](https://developers.99minutos.com/reference/get-api-v3-webhooks-evidences-by-tracking-id.md)