---
title: "Get Shipments by Month and Year"
method: GET
path: "/guide/{MM}/{YYYY}"
tags: ["Shipments"]
---

# Get Shipments by Month and Year

`GET /guide/{MM}/{YYYY}`

Retrieves all shipments created under your account for a specific calendar month and year. Returns a summary list including tracking numbers, carriers, statuses, and creation dates.

**When to use:** Call this endpoint to build shipment history dashboards, generate monthly shipping reports, reconcile invoices, or audit shipment volumes for a given period.

**Prerequisites:**
- Valid JWT token in the Authorization header
- Month (`MM`) as a zero-padded two-digit string (01-12)
- Year (`YYYY`) as a four-digit string

**Key behaviors:**
- Returns all shipments for the authenticated account within the specified month
- Results include `tracking_number`, `carrier`, `status`, and `created_at` for each shipment
- The `tracking_number` from the response can be used with `GET /guide/{tracking_number}` to fetch full shipment details
- Large result sets may be paginated; check the response for pagination metadata

## Path parameters

- `MM` string, required
- `YYYY` string, required

## Response `200`

Successful response

- object
  - `success` boolean — Indicates if the request was successful
  - `data` object[] — List of shipments
    - `tracking_number` string — Tracking number
    - `carrier` string — Carrier name
    - `status` string — Shipment status
    - `created_at` string, date-time — Creation date

---

[API](https://skmtc.net/envia/apis/envia-shipping-api-complete-documentation.md) · [All operations](https://skmtc.net/envia/apis/envia-shipping-api-complete-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/envia/envia-shipping-api-complete-documentation/revisions/39f9208959d6/schema)