Quickstart

Get up and running with the Aphelios API in minutes.

1. Get your API key

All requests require an API key in the format aph_live_*. Create one from the Dashboard under Plataform Configuration > API Keys.

2. Make your first request

REST API

curl -H "Authorization: Bearer aph_live_YOUR_API_KEY" \
  https://api.aphelios.ai/v1/shipments

MCP (for AI tools)

If you're connecting an LLM client, the MCP server endpoint is:

https://api.aphelios.ai/v1/mcp

See Examples for ready-to-copy configs for Claude Desktop, Cursor, and custom agents.

3. Track a shipment

curl -X POST https://api.aphelios.ai/v1/shipments \
  -H "Authorization: Bearer aph_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "transport_mode": "ocean",
    "carrier": "MAEU",
    "identifiers": {
      "mbl": "MEDU1234567"
    }
  }'

4. Get shipment status

curl https://api.aphelios.ai/v1/shipments/{shipment_id} \
  -H "Authorization: Bearer aph_live_YOUR_API_KEY"

What's next

• MCP Server -- connect AI agents to your logistics data
• API Reference -- complete REST endpoint docs