---
updatedAt: 2026-07-07T16:22:54.000Z
agentTools:
  projectIndex: https://docs.envia.com/llms.txt
---

# Track Shipments

Retrieve the current tracking status and event history for one or more shipments using their tracking numbers.

**When to use:** Call this endpoint to check delivery progress, confirm delivery, or display shipment status to your end users. You can also use webhooks for real-time push updates instead of polling.

**Prerequisites:**
- Valid JWT authentication token (Bearer)
- One or more valid tracking numbers from previously generated shipments

**Key behaviors:**
- Accepts an array of tracking numbers, allowing batch tracking in a single request
- Returns the latest status, status history, and estimated delivery date when available
- Tracking data is fetched in real time from the carrier
- For automated status updates, consider using webhooks (`/ship/webhooktest/`) instead of polling this endpoint

Catalog of statuses

| ID | Name                | Explanation                                                                                                                                    |
| -- | ------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| 1  | Created             | The shipment has been created in the system but has not yet been processed or picked up.                                                       |
| 2  | Shipped             | The shipment has been picked up from the sender's location and is in transit to the destination.                                               |
| 3  | Delivered           | The shipment has been successfully delivered to the recipient's address.                                                                       |
| 4  | Canceled            | The shipment has been canceled and will not be delivered.                                                                                      |
| 5  | Information         | This status is used to convey additional information or updates about the shipment.                                                            |
| 6  | N/A                 | Not applicable or not available. This status may be used when there is no relevant information for the shipment.                               |
| 7  | Pending             | The shipment is awaiting further action or processing.                                                                                         |
| 8  | Picked Up           | The shipment has been picked up from the sender's location.                                                                                    |
| 9  | Out for Delivery    | The shipment is out for delivery and is en route to the recipient's address.                                                                   |
| 10 | Lost                | The shipment has been misplaced or lost during transit and cannot be located.                                                                  |
| 11 | Returned            | The shipment has been returned to the sender or a designated location.                                                                         |
| 12 | Pickup at Office    | The recipient needs to pick up the shipment from the logistics office or a designated location.                                                |
| 13 | Delivered at Origin | The shipment has been delivered back to the origin or sender's location.                                                                       |
| 14 | Damaged             | The shipment has been damaged during transit or handling.                                                                                      |
| 15 | Redirected          | The shipment's delivery address has been changed and redirected to a new location.                                                             |
| 16 | Out for Pickup      | The shipment is ready for pickup by the sender or a designated party.                                                                          |
| 17 | 1 delivery attempt  | The shipment has undergone one unsuccessful delivery attempt.                                                                                  |
| 18 | 2 delivery attempts | The shipment has undergone two unsuccessful delivery attempts.                                                                                 |
| 19 | 3 delivery attempts | The shipment has undergone three unsuccessful delivery attempts.                                                                               |
| 20 | Return problem      | There is an issue with the return of the shipment to the sender or a designated location.                                                      |
| 21 | Address error       | There is an error or issue with the delivery address provided for the shipment.                                                                |
| 22 | Undeliverable       | The shipment is undeliverable to the intended recipient due to various reasons, such as an incorrect address or refusal to accept the package. |
| 23 | Delayed             | The shipment is experiencing a delay and will not be delivered within the expected timeframe.                                                  |
| 24 | Rejected            | The shipment has been rejected by the recipient or the delivery has been refused.                                                              |
| 25 | 1 pickup attempt    | The shipment has undergone one unsuccessful pickup attempt.                                                                                    |
| 26 | Partially Shipped   | Items have been shipped, but some parts of the order are still pending.                                                                        |
| 27 | Partially Delivered | Some items in the order have been delivered, while others are still pending.                                                                   |
| 28 | Delivery Attempt    | A delivery was attempted but was not successful, and may be rescheduled.                                                                       |

<br />

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "Envia Shipping API — Complete Documentation",
    "version": "v2.3.0",
    "description": "Shipping API to connect with over 100 couriers worldwide. Shipping made simple for e-commerces and enterprises. Envia's Shipping Web Services offers solutions that applications can use to quote, create labels, request pickups, track packages, cancel shipments and many other logistics operations in USA, Mexico, Colombia, Brazil, India, Canada, Argentina, Chile, Guatemala, Spain, Italy and France. This API is built for e-commerce platforms, logistics teams, and enterprise applications that need a single integration to access multi-carrier shipping capabilities. Core features include real-time rate comparison, label generation, package tracking, pickup scheduling, shipment cancellation, and webhook-based event notifications.\n\n**Important Information:**\n- State codes must be 2 digits\n- Country codes must be 2 digits  \n- Validate the shipping address structure\n- Make sure the zip code or locality are correct\n\n**Custom Keys:** Custom Keys are used when you have a direct account with a carrier. This way you create labels with your rates with an additional small fee for service.",
    "contact": {
      "name": "Envia API Support",
      "url": "https://docs.envia.com/discuss"
    },
    "license": {
      "name": "Proprietary",
      "url": "https://www.envia.com/terminos-y-condiciones"
    },
    "termsOfService": "https://www.envia.com/terminos-y-condiciones"
  },
  "externalDocs": {
    "description": "Full Envia API Documentation",
    "url": "https://docs.envia.com"
  },
  "servers": [
    {
      "url": "https://api-test.envia.com",
      "description": "Sandbox/Test"
    },
    {
      "url": "https://api.envia.com",
      "description": "Production"
    }
  ],
  "components": {
    "securitySchemes": {
      "bearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "JWT"
      }
    }
  },
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "tags": [
    {
      "name": "Tracking & Logs",
      "description": "Track shipments and view delivery status"
    }
  ],
  "paths": {
    "/ship/generaltrack/": {
      "post": {
        "tags": [
          "Tracking & Logs"
        ],
        "summary": "Track Shipments",
        "description": "Retrieve the current tracking status and event history for one or more shipments using their tracking numbers.\n\n**When to use:** Call this endpoint to check delivery progress, confirm delivery, or display shipment status to your end users. You can also use webhooks for real-time push updates instead of polling.\n\n**Prerequisites:**\n- Valid JWT authentication token (Bearer)\n- One or more valid tracking numbers from previously generated shipments\n\n**Key behaviors:**\n- Accepts an array of tracking numbers, allowing batch tracking in a single request\n- Returns the latest status, status history, and estimated delivery date when available\n- Tracking data is fetched in real time from the carrier\n- For automated status updates, consider using webhooks (`/ship/webhooktest/`) instead of polling this endpoint",
        "operationId": "track-shipments",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "trackingNumbers"
                ],
                "properties": {
                  "trackingNumbers": {
                    "type": "array",
                    "description": "Array of tracking numbers to track",
                    "items": {
                      "type": "string"
                    },
                    "example": [
                      "7520610403",
                      "7520610404"
                    ]
                  }
                }
              },
              "example": {
                "trackingNumbers": [
                  "1Z68W99A4297214308",
                  "1Z68W99A4297214309"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Tracking information retrieved successfully"
          }
        }
      }
    }
  }
}
```