# GATH Logistics
> Shanghai-based international freight coordination for ocean, air, inland, battery, and project cargo, with public, portal, and developer (API v2) surfaces.

GATH provides a public website for service discovery and contact, a portal for onboarding, rates, and order workflows, and a REST API (v2) for automated service discovery, rate queries, quote requests, and space inventory access.
Use this file as the primary map for LLMs and browser agents.

## Important notes
- Public pages describe service scope and contact paths.
- Account-specific rate access, order actions, and detailed operational data require authentication.
- Battery, project cargo, and special handling workflows may require additional documentation and human review.
- When available, markdown mirrors of key pages should be preferred over HTML pages.

## Main website
- [Home](https://www.gathlogistics.com/): Public entry point for service scope, SCFI index, Prompt Space inventory, and navigation.
- [Services](https://www.gathlogistics.com/services): Ocean, air, inland, battery, and project logistics scope.
- [About](https://www.gathlogistics.com/about): Company background and operating model.
- [Contact](https://www.gathlogistics.com/contact): Sales and support paths.
- [New energy & battery](https://www.gathlogistics.com/new-energy-battery-logistics/): Battery and project cargo context.
- [For AI (llms.txt)](https://www.gathlogistics.com/llms.txt): This file — primary LLM map.

## Portal and operations
- [Portal](https://portal.gathlogistics.com/): Customer onboarding, rates, orders, and space inventory.
- [Create account](https://portal.gathlogistics.com/register.html): New customer onboarding.
- [Open rates](https://portal.gathlogistics.com/rates.html): Dedicated rate workflow.
- [Spot rate request](https://portal.gathlogistics.com/spot-rate-request.html): Quick quote without account.
- [Space inventory](https://portal.gathlogistics.com/space-inventory.html): Real-time carrier space availability.

## Developer API (v2)
Base URL: `https://api.gathlogistics.com/wp-json/gath/v2/`
Authentication: `X-API-Key: YOUR_API_KEY` (Bearer token for legacy v1)
Full docs: [Developers overview](https://developers.gathlogistics.com/)

### API v2 Endpoints
| Endpoint | Method | Description |
|----------|--------|-------------|
| `/services` | GET | Service discovery — list all available logistics services |
| `/services/{id}` | GET | Get details for a specific service (ocean-freight, air-freight, etc.) |
| `/quotes` | POST | Create a single quote request |
| `/quotes/bulk` | POST | Bulk quote creation (up to 50 quotes per request) |
| `/quotes/{id}` | GET | Retrieve a specific quote by ID |
| `/quotes` | GET | List all quotes (supports pagination and status filter) |
| `/rates` | GET | Query freight rates — all routes or filtered by destination |
| `/rates/calculate` | POST | Calculate shipping cost for specific cargo details |
| `/space-inventory` | GET | Get all current spot space inventory from carriers |
| `/space-inventory/carriers` | GET | List all carriers with space availability |
| `/space-inventory/search` | POST | Search space inventory by POD, carrier, ETD range, container type |

### Quick start
```bash
# 1. Service discovery
curl -X GET "https://api.gathlogistics.com/wp-json/gath/v2/services" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Accept: application/json"

# 2. Query rate: Shanghai → Los Angeles, 40HQ container
curl -X GET "https://api.gathlogistics.com/wp-json/gath/v2/rates?destination=Los+Angeles&container_type=40HQ" \
  -H "X-API-Key: YOUR_API_KEY"

# 3. Create a quote
curl -X POST "https://api.gathlogistics.com/wp-json/gath/v2/quotes" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"service_type":"ocean-freight","origin":"Shanghai","destination":"Los Angeles","cargo_details":{"container_type":"40HQ","quantity":2}}'

# 4. Get spot space inventory
curl -X GET "https://api.gathlogistics.com/wp-json/gath/v2/space-inventory" \
  -H "X-API-Key: YOUR_API_KEY"
```

### Rate calculation formula
```
Ocean freight = base_rate × container_factor × quantity
BAF (fuel surcharge) = ocean_freight × 15%
CAF (currency adjustment) = ocean_freight × 5%
Total = ocean_freight + BAF + CAF
```
Container factors: 20GP=1.0, 40GP=1.7, 40HQ=1.9, 45HQ=2.1

### Available services
| ID | Name | Category | Description |
|----|------|----------|-------------|
| ocean-freight | 国际海运 | freight | FCL, LCL ocean freight to global ports |
| air-freight | 国际空运 | freight | Time-sensitive air cargo with express options |
| land-transport | 陆运衔接 | freight | Inland trucking, drayage, last-mile delivery |
| battery-logistics | 锂电池物流 | specialized | Lithium battery & EV component logistics (UN38.3) |
| dangerous-goods | 危险品运输 | specialized | DG cargo with full compliance documentation |
| oversized-cargo | 超尺寸货物 | specialized | OOG cargo — flat rack, open top containers |

### Supported routes (28 routes)
Major routes include: CN-US, CN-USEC, CN-EU, CN-UK, CN-MED, CN-JP, CN-KR, CN-SG, CN-AU, CN-NZ, CN-BR, CN-ZA, CN-NG, CN-IN, CN-AE, CN-ID, and more.

### Error responses
| Code | Status | Description |
|------|--------|-------------|
| missing_api_key | 401 | API Key required in X-API-Key header |
| invalid_api_key | 401 | Invalid or inactive API Key |
| rate_limit_exceeded | 429 | Too many requests (60/min, 1000/hour) |
| service_not_found | 404 | Requested service ID does not exist |
| rate_not_found | 404 | No rate data for the specified route |
| missing_param | 400 | Required parameter missing |

## Contact
- Shanghai office: 021-51518958
- Taicang office: 0512-53556162
- Mobile: +86-173-1549-9116
- Email: Queenie@gathlogistics.com
- Business hours: Mon-Fri 9:00-18:00 CST (excl. Chinese public holidays)