List shared routes

get/routes

Returns all trade routes currently shared with the partner network.

Query Parameters

regionstring

Filter by desert region (e.g. "northern", "eastern")

pageinteger

Default: 1

Responses

200A list of shared routes

application/json

routesarray of Route

idstring (uuid)

namestring

regionstring

waypointsarray of string

distance_kminteger

published_bystring

created_atstring (date-time)

totalinteger

Request

curl -X GET 'https://partners.cameltrading.example/v2/routes' \
  -H 'Authorization: Bearer <your-token>'

Response

{
  "routes": [
    {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "name": "Northern Silk Road",
      "region": "northern",
      "waypoints": [
        "oasis-north-1",
        "oasis-north-3"
      ],
      "distance_km": 480,
      "published_by": "partner_acme",
      "created_at": "2024-01-15T10:30:00Z"
    }
  ],
  "total": 0
}