---
title: "Retrieve shipment reports"
method: GET
path: "/public/v3/Shipments/{shipmentId}/reports"
tags: ["Shipments"]
---

# Retrieve shipment reports

`GET /public/v3/Shipments/{shipmentId}/reports`

Retrieve paginated reports for a specified shipment

## Path parameters

- `shipmentId` string, required

## Query parameters

- `PageSize` integer
- `PageNumber` integer

## Headers

- `x-tive-account-id` integer, required

## Response `200`

The requested reports for shipment

- ShipmentReportResponsePaginatedResponse
  - `totalRecords` integer
  - `pageNumber` integer
  - `pageSize` integer
  - `data` ShipmentReportResponse[], nullable
    - `reportId` string, nullable
    - `language` string, nullable
    - `format` 0 | 1 | 2
    - `visibility` 0 | 1 | 2
    - `dateCreated` string, date-time, nullable
    - `createdBy` string, nullable
    - `reportFields` ReportField[], nullable
    - `reportState` 'Pending' | 'Succeeded' | 'Failed' | 'Invalid'
    - `reportStartDate` string, date-time, nullable
    - `reportEndDate` string, date-time, nullable
  - `next` string, nullable
  - `previous` string, nullable

## Other responses

- `401` — Unauthorized
- `404` — Not Found
- `500` — Internal Server Error

---

[API](https://skmtc.net/tive/apis/tive-public-api.md) · [All operations](https://skmtc.net/tive/apis/tive-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tive/tive-public-api/versions/9a8d869e3cdc/schema)