---
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}`

## Request

- Base URL: `https://queries.test.envia.com`
- URL: `https://queries.test.envia.com/guide/{MM}/{YYYY}`
- Auth: HTTP bearer

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.dev/envia/apis/envia-queries-api.md) - [All operations](https://skmtc.dev/envia/apis/envia-queries-api/llms.txt) - [OpenAPI document](https://skmtc.dev/envia/apis/envia-queries-api/revisions/56f601a52f3f?raw)