> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.mycargoextra.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.mycargoextra.com/_mcp/server.

# Overview

Standard API documentation for CargoExtra Gateway Service. Base path: `/api/v1`. Import this JSON into Postman, set `baseUrl`, then authenticate as a user or admin and reuse the returned token in `userToken` or `adminToken`.

Authentication: protected user endpoints accept `Authorization: Bearer {{userToken}}` or the `customerToken/userToken` cookie set by login. Protected admin endpoints accept `Authorization: Bearer {{adminToken}}` or the `staffToken/adminToken` cookie set by login.

Common list query parameters: `page` number, `limit` number max 100, `sortBy` string, `sortOrder` `asc|desc`, `all` 1 to bypass pagination, `q` text search, `dateFrom/from`, `dateTo/to` for date ranges where supported.

Common error responses: `401 { "message": "Unauthorized" }`, `400` for missing/invalid fields, `404` for missing resources, and `500 { "message": "Unxepected Error: ..." }` in unexpected failures.