API Operations

Route Intelligence

Route summaries, ETA analysis, delay and traffic context and mobility anomaly detection for journeys.

Sensitivity: standardRate limit class: standard

GET/api/v1/route/retrieve_journey_eta_summaryretrieve_journey_eta_summary

journeys:readTier b₦250.00

Returns the authoritative ETA surface for one owned journey, combining departure time, estimated arrival, a projected arrival derived from the snapshot travel time and the recorded traffic delay.

Parameters

Name	In	Type	Required	Description
journey_id	query	string	Yes	Required UUID of the owned journey whose ETA summary is returned.

State constraints

No journey-state precondition is enforced; draft journeys without a planned route return a null route payload instead of an error.

Idempotency

Safe read; no side effects.

Response

ETA summary derived from the route and live conditions.

{
  "data": {
    "journey_id": "0d0b6f2e-6b1a-4f3e-9a4c-1f2e3d4c5b6a",
    "route_id": "3c2b1a0f-9e8d-4c7b-a6f5-e4d3c2b1a0f9",
    "departure_datetime": "2026-09-28T08:30:00.000Z",
    "estimated_arrival_datetime": "2026-09-28T10:45:00.000Z",
    "projected_arrival_datetime": "2026-09-28T11:06:00.000Z",
    "live_delay_minutes": 21
  }
}

Errors

Code	HTTP	Cause
INVALID_REQUEST	400	The journey_id query parameter is missing or is not a valid resource identifier.
CAPABILITY_NOT_AUTHORIZED	403	The API key lacks the required scope, the route capability is disabled or the organization is not linked to an ORN platform account.
RESOURCE_NOT_FOUND	404	The requested journey was not found, is not owned by the linked ride-owner account, or no active pricing row exists for the operation.

GET/api/v1/route/retrieve_route_summaryretrieve_route_summary

journeys:readTier b₦250.00

Returns the planning-route snapshot for one owned journey, including origin, destination, estimated distance, ideal and live travel times, traffic delay and the traffic data source.

Parameters

Name	In	Type	Required	Description
journey_id	query	string	Yes	Required UUID of the owned journey whose route summary is returned.

State constraints

No journey-state precondition is enforced; draft journeys without a planned route return a null route payload instead of an error.

Idempotency

Safe read; no side effects.

Response

Distance and travel-time facts for the route.

{
  "data": {
    "route_id": "3c2b1a0f-9e8d-4c7b-a6f5-e4d3c2b1a0f9",
    "origin": {
      "location": "Ikorodu Road Terminal, Lagos",
      "lat": 6.5902,
      "lng": 3.3667
    },
    "destination": {
      "location": "Ibadan Central Park",
      "lat": 7.3775,
      "lng": 3.947
    },
    "estimated_distance_km": 128,
    "ideal_travel_time_minutes": 120,
    "live_traffic_travel_time_minutes": 141,
    "traffic_delay_minutes": 21,
    "traffic_data_source": "live",
    "planned_at": "2026-09-26T09:00:00.000Z"
  }
}

Errors

Code	HTTP	Cause
INVALID_REQUEST	400	The journey_id query parameter is missing or is not a valid resource identifier.
CAPABILITY_NOT_AUTHORIZED	403	The API key lacks the required scope, the route capability is disabled or the organization is not linked to an ORN platform account.
RESOURCE_NOT_FOUND	404	The requested journey was not found, is not owned by the linked ride-owner account, or no active pricing row exists for the operation.

GET/api/v1/route/journey_delay_analysisjourney_delay_analysis

intelligence:readTier d₦500.00

Returns a deterministic delay breakdown for one owned journey comparing the ideal travel time against snapshot and live traffic delay, with a delay ratio, condition class and projected arrival.

Parameters

Name	In	Type	Required	Description
journey_id	query	string	Yes	Required UUID of the owned journey whose delay analysis is returned.

State constraints

No journey-state precondition is enforced; draft journeys without a planned route return a null route payload instead of an error.

Deterministic rules

Deterministic delay rules: live_delay_minutes = live traffic travel time − ideal travel time (never invented); snapshot_delay_minutes is the planning-snapshot value of the same difference.
delay_ratio = max(live delay, snapshot delay, 0) ÷ max(ideal travel time, 1), rounded to 3 decimal places.
condition classes by delay ratio: light below 0.1, moderate from 0.1 to below 0.25, heavy from 0.25 to below 0.5, severe at 0.5 or above.
projected_arrival_datetime = departure_datetime + the best-available travel time: live traffic minutes when a live reading exists, otherwise the ideal planning travel time; it is null only when no travel-time value exists for the route.

Idempotency

Safe read; no side effects.

Response

Delay decomposition against the ideal travel time.

{
  "data": {
    "journey_id": "0d0b6f2e-6b1a-4f3e-9a4c-1f2e3d4c5b6a",
    "route_id": "3c2b1a0f-9e8d-4c7b-a6f5-e4d3c2b1a0f9",
    "ideal_travel_time_minutes": 120,
    "snapshot_delay_minutes": 18,
    "live_delay_minutes": 21,
    "delay_ratio": 0.175,
    "projected_arrival_datetime": "2026-09-28T11:06:00.000Z",
    "condition": "moderate"
  }
}

Errors

Code	HTTP	Cause
INVALID_REQUEST	400	The journey_id query parameter is missing or is not a valid resource identifier.
CAPABILITY_NOT_AUTHORIZED	403	The API key lacks the required scope, the route capability is disabled or the organization is not linked to an ORN platform account.
RESOURCE_NOT_FOUND	404	The requested journey was not found, is not owned by the linked ride-owner account, or no active pricing row exists for the operation.

GET/api/v1/route/route_intelligence_summaryroute_intelligence_summary

intelligence:readTier d₦500.00

Returns a fused route, journey state, checkpoint progress and active safety event posture for one owned journey.

Parameters

Name	In	Type	Required	Description
journey_id	query	string	Yes	Required UUID of the owned journey whose route intelligence summary is returned.

State constraints

No journey-state precondition is enforced; draft journeys without a planned route return a null route payload instead of an error.

Idempotency

Safe read; no side effects.

Response

Route intelligence combined with journey progress.

{
  "data": {
    "route": {
      "route_id": "3c2b1a0f-9e8d-4c7b-a6f5-e4d3c2b1a0f9",
      "origin": {
        "location": "Ikorodu Road Terminal, Lagos",
        "lat": 6.5902,
        "lng": 3.3667
      },
      "destination": {
        "location": "Ibadan Central Park",
        "lat": 7.3775,
        "lng": 3.947
      },
      "estimated_distance_km": 128,
      "ideal_travel_time_minutes": 120,
      "live_traffic_travel_time_minutes": 141,
      "traffic_delay_minutes": 21,
      "traffic_data_source": "live",
      "planned_at": "2026-09-26T09:00:00.000Z"
    },
    "state": "active",
    "checkpoint_progress": {
      "planned_total": 4,
      "completed": 2
    },
    "active_emergencies": 1
  }
}

Errors

Code	HTTP	Cause
INVALID_REQUEST	400	The journey_id query parameter is missing or is not a valid resource identifier.
CAPABILITY_NOT_AUTHORIZED	403	The API key lacks the required scope, the route capability is disabled or the organization is not linked to an ORN platform account.
RESOURCE_NOT_FOUND	404	The requested journey was not found, is not owned by the linked ride-owner account, or no active pricing row exists for the operation.

GET/api/v1/route/journey_traffic_contextjourney_traffic_context

intelligence:readTier d₦600.00

Returns the planning-route snapshot of one owned journey alongside live re-resolved traffic conditions and a deterministic traffic condition classification.

Parameters

Name	In	Type	Required	Description
journey_id	query	string	Yes	Required UUID of the owned journey whose traffic context is returned.

State constraints

No journey-state precondition is enforced; draft journeys without a planned route return a null route payload instead of an error.

Idempotency

Safe read; no side effects.

Response

Traffic snapshot plus any live replan for the journey.

{
  "data": {
    "journey_id": "0d0b6f2e-6b1a-4f3e-9a4c-1f2e3d4c5b6a",
    "route": {
      "route_id": "3c2b1a0f-9e8d-4c7b-a6f5-e4d3c2b1a0f9",
      "origin": {
        "location": "Ikorodu Road Terminal, Lagos",
        "lat": 6.5902,
        "lng": 3.3667
      },
      "destination": {
        "location": "Ibadan Central Park",
        "lat": 7.3775,
        "lng": 3.947
      },
      "estimated_distance_km": 128,
      "ideal_travel_time_minutes": 120,
      "live_traffic_travel_time_minutes": 141,
      "traffic_delay_minutes": 21,
      "traffic_data_source": "live",
      "planned_at": "2026-09-26T09:00:00.000Z"
    },
    "snapshot": {
      "travel_time_minutes": 138,
      "delay_minutes": 18,
      "data_source": "planning_snapshot"
    },
    "live_replan": {
      "travel_time_minutes": 141,
      "delay_minutes": 21,
      "data_source": "live"
    },
    "traffic_condition": "moderate"
  }
}

Errors

Code	HTTP	Cause
INVALID_REQUEST	400	The journey_id query parameter is missing or is not a valid resource identifier.
CAPABILITY_NOT_AUTHORIZED	403	The API key lacks the required scope, the route capability is disabled or the organization is not linked to an ORN platform account.
RESOURCE_NOT_FOUND	404	The requested journey was not found, is not owned by the linked ride-owner account, or no active pricing row exists for the operation.

GET/api/v1/route/traffic_aware_journey_analysistraffic_aware_journey_analysis

intelligence:readTier d₦600.00

Returns a traffic-aware journey posture for one owned journey combining live delay classification, checkpoint progress and the latest ORION risk assessment.

Parameters

Name	In	Type	Required	Description
journey_id	query	string	Yes	Required UUID of the owned journey whose traffic-aware analysis is returned.

State constraints

No journey-state precondition is enforced; draft journeys without a planned route return a null route payload instead of an error.

Idempotency

Safe read; no side effects.

Response

Traffic-aware arrival projection for the journey.

{
  "data": {
    "journey_id": "0d0b6f2e-6b1a-4f3e-9a4c-1f2e3d4c5b6a",
    "route": {
      "route_id": "3c2b1a0f-9e8d-4c7b-a6f5-e4d3c2b1a0f9",
      "origin": {
        "location": "Ikorodu Road Terminal, Lagos",
        "lat": 6.5902,
        "lng": 3.3667
      },
      "destination": {
        "location": "Ibadan Central Park",
        "lat": 7.3775,
        "lng": 3.947
      },
      "estimated_distance_km": 128,
      "ideal_travel_time_minutes": 120,
      "live_traffic_travel_time_minutes": 141,
      "traffic_delay_minutes": 21,
      "traffic_data_source": "live",
      "planned_at": "2026-09-26T09:00:00.000Z"
    },
    "traffic_condition": "moderate",
    "projected_arrival_datetime": "2026-09-28T11:06:00.000Z",
    "total_delay_minutes": 21,
    "checked_domains": [
      "route",
      "checkpoints",
      "safety",
      "state"
    ]
  }
}

Errors

Code	HTTP	Cause
INVALID_REQUEST	400	The journey_id query parameter is missing or is not a valid resource identifier.
CAPABILITY_NOT_AUTHORIZED	403	The API key lacks the required scope, the route capability is disabled or the organization is not linked to an ORN platform account.
RESOURCE_NOT_FOUND	404	The requested journey was not found, is not owned by the linked ride-owner account, or no active pricing row exists for the operation.

GET/api/v1/route/route_condition_analysisroute_condition_analysis

intelligence:readTier d₦650.00

Returns the current route condition classification for one owned journey with snapshot freshness indicators, distance and both snapshot and live data sources.

Parameters

Name	In	Type	Required	Description
journey_id	query	string	Yes	Required UUID of the owned journey whose route condition analysis is returned.

State constraints

No journey-state precondition is enforced; draft journeys without a planned route return a null route payload instead of an error.

Idempotency

Safe read; no side effects.

Response

Condition classification for the route.

{
  "data": {
    "route_id": "3c2b1a0f-9e8d-4c7b-a6f5-e4d3c2b1a0f9",
    "condition": "moderate",
    "distance_km": 128,
    "snapshot_data_source": "planning_snapshot",
    "live_data_source": "live",
    "has_live_conditions": true
  }
}

Errors

Code	HTTP	Cause
INVALID_REQUEST	400	The journey_id query parameter is missing or is not a valid resource identifier.
CAPABILITY_NOT_AUTHORIZED	403	The API key lacks the required scope, the route capability is disabled or the organization is not linked to an ORN platform account.
RESOURCE_NOT_FOUND	404	The requested journey was not found, is not owned by the linked ride-owner account, or no active pricing row exists for the operation.

GET/api/v1/route/mobility_anomaly_analysismobility_anomaly_analysis

intelligence:readTier d₦750.00

Returns a deterministic anomaly scan for one owned journey across route, checkpoints, safety events and journey state, with each finding citing the authoritative record that produced it.

Parameters

Name	In	Type	Required	Description
journey_id	query	string	Yes	Required UUID of the owned journey whose mobility anomaly analysis is returned.

State constraints

No journey-state precondition is enforced; draft journeys without a planned route return a null route payload instead of an error.
The arrival-window-elapsed anomaly is only evaluated while the journey state is planned, activated, boarding or active.

Idempotency

Safe read; no side effects.

Response

Anomalies detected across the journey domains. live_replan is null when no coordinates exist.

{
  "data": {
    "journey_id": "0d0b6f2e-6b1a-4f3e-9a4c-1f2e3d4c5b6a",
    "anomaly_count": 2,
    "anomalies": [
      {
        "type": "checkpoint_missed_or_escalated",
        "detail": "Checkpoint 3 is overdue."
      },
      {
        "type": "traffic_delay",
        "detail": "Live delay of 21 minutes exceeds the moderate threshold."
      }
    ],
    "checked_domains": [
      "route",
      "checkpoints",
      "safety",
      "state"
    ]
  }
}

Errors

Code	HTTP	Cause
INVALID_REQUEST	400	The journey_id query parameter is missing or is not a valid resource identifier.
CAPABILITY_NOT_AUTHORIZED	403	The API key lacks the required scope, the route capability is disabled or the organization is not linked to an ORN platform account.
RESOURCE_NOT_FOUND	404	The requested journey was not found, is not owned by the linked ride-owner account, or no active pricing row exists for the operation.

GET/api/v1/route/advanced_route_intelligenceadvanced_route_intelligence

intelligence:readTier d₦1,000.00

Returns a deep fused route intelligence view for one owned journey combining the planning snapshot, live re-resolution, traffic classification, checkpoint posture, emergency event totals and the latest ORION risk assessment.

Parameters

Name	In	Type	Required	Description
journey_id	query	string	Yes	Required UUID of the owned journey whose advanced route intelligence is returned.

State constraints

No journey-state precondition is enforced; draft journeys without a planned route return a null route payload instead of an error.

Idempotency

Safe read; no side effects.

Response

Advanced route intelligence including problematic checkpoints.

{
  "data": {
    "route": {
      "route_id": "3c2b1a0f-9e8d-4c7b-a6f5-e4d3c2b1a0f9",
      "origin": {
        "location": "Ikorodu Road Terminal, Lagos",
        "lat": 6.5902,
        "lng": 3.3667
      },
      "destination": {
        "location": "Ibadan Central Park",
        "lat": 7.3775,
        "lng": 3.947
      },
      "estimated_distance_km": 128,
      "ideal_travel_time_minutes": 120,
      "live_traffic_travel_time_minutes": 141,
      "traffic_delay_minutes": 21,
      "traffic_data_source": "live",
      "planned_at": "2026-09-26T09:00:00.000Z"
    },
    "traffic_condition": "moderate",
    "projected_arrival_datetime": "2026-09-28T11:06:00.000Z",
    "problematic_checkpoints": [
      {
        "checkpoint_id": "f6a5b4c3-7777-4aaa-9bbb-8c9d0e1f2a3b",
        "checkpoint_number": 3,
        "status": "escalated"
      }
    ],
    "emergency_events_total": 1,
    "anomalies": [
      {
        "type": "arrival_window_elapsed",
        "detail": "Projected arrival is past the estimated window."
      }
    ]
  }
}

Errors

Code	HTTP	Cause
INVALID_REQUEST	400	The journey_id query parameter is missing or is not a valid resource identifier.
CAPABILITY_NOT_AUTHORIZED	403	The API key lacks the required scope, the route capability is disabled or the organization is not linked to an ORN platform account.
RESOURCE_NOT_FOUND	404	The requested journey was not found, is not owned by the linked ride-owner account, or no active pricing row exists for the operation.

API Operations

Route Intelligence

Route summaries, ETA analysis, delay and traffic context and mobility anomaly detection for journeys.

Sensitivity: standardRate limit class: standard

GET/api/v1/route/retrieve_journey_eta_summaryretrieve_journey_eta_summary

journeys:readTier b₦250.00

Returns the authoritative ETA surface for one owned journey, combining departure time, estimated arrival, a projected arrival derived from the snapshot travel time and the recorded traffic delay.

Parameters

Name	In	Type	Required	Description
journey_id	query	string	Yes	Required UUID of the owned journey whose ETA summary is returned.

State constraints

No journey-state precondition is enforced; draft journeys without a planned route return a null route payload instead of an error.

Idempotency

Safe read; no side effects.

Response

ETA summary derived from the route and live conditions.

{
  "data": {
    "journey_id": "0d0b6f2e-6b1a-4f3e-9a4c-1f2e3d4c5b6a",
    "route_id": "3c2b1a0f-9e8d-4c7b-a6f5-e4d3c2b1a0f9",
    "departure_datetime": "2026-09-28T08:30:00.000Z",
    "estimated_arrival_datetime": "2026-09-28T10:45:00.000Z",
    "projected_arrival_datetime": "2026-09-28T11:06:00.000Z",
    "live_delay_minutes": 21
  }
}

Errors

Code	HTTP	Cause
INVALID_REQUEST	400	The journey_id query parameter is missing or is not a valid resource identifier.
CAPABILITY_NOT_AUTHORIZED	403	The API key lacks the required scope, the route capability is disabled or the organization is not linked to an ORN platform account.
RESOURCE_NOT_FOUND	404	The requested journey was not found, is not owned by the linked ride-owner account, or no active pricing row exists for the operation.

GET/api/v1/route/retrieve_route_summaryretrieve_route_summary

journeys:readTier b₦250.00

Returns the planning-route snapshot for one owned journey, including origin, destination, estimated distance, ideal and live travel times, traffic delay and the traffic data source.

Parameters

Name	In	Type	Required	Description
journey_id	query	string	Yes	Required UUID of the owned journey whose route summary is returned.

State constraints

No journey-state precondition is enforced; draft journeys without a planned route return a null route payload instead of an error.

Idempotency

Safe read; no side effects.

Response

Distance and travel-time facts for the route.

{
  "data": {
    "route_id": "3c2b1a0f-9e8d-4c7b-a6f5-e4d3c2b1a0f9",
    "origin": {
      "location": "Ikorodu Road Terminal, Lagos",
      "lat": 6.5902,
      "lng": 3.3667
    },
    "destination": {
      "location": "Ibadan Central Park",
      "lat": 7.3775,
      "lng": 3.947
    },
    "estimated_distance_km": 128,
    "ideal_travel_time_minutes": 120,
    "live_traffic_travel_time_minutes": 141,
    "traffic_delay_minutes": 21,
    "traffic_data_source": "live",
    "planned_at": "2026-09-26T09:00:00.000Z"
  }
}

Errors

Code	HTTP	Cause
INVALID_REQUEST	400	The journey_id query parameter is missing or is not a valid resource identifier.
CAPABILITY_NOT_AUTHORIZED	403	The API key lacks the required scope, the route capability is disabled or the organization is not linked to an ORN platform account.
RESOURCE_NOT_FOUND	404	The requested journey was not found, is not owned by the linked ride-owner account, or no active pricing row exists for the operation.

GET/api/v1/route/journey_delay_analysisjourney_delay_analysis

intelligence:readTier d₦500.00

Returns a deterministic delay breakdown for one owned journey comparing the ideal travel time against snapshot and live traffic delay, with a delay ratio, condition class and projected arrival.

Parameters

Name	In	Type	Required	Description
journey_id	query	string	Yes	Required UUID of the owned journey whose delay analysis is returned.

State constraints

No journey-state precondition is enforced; draft journeys without a planned route return a null route payload instead of an error.

Deterministic rules

Deterministic delay rules: live_delay_minutes = live traffic travel time − ideal travel time (never invented); snapshot_delay_minutes is the planning-snapshot value of the same difference.
delay_ratio = max(live delay, snapshot delay, 0) ÷ max(ideal travel time, 1), rounded to 3 decimal places.
condition classes by delay ratio: light below 0.1, moderate from 0.1 to below 0.25, heavy from 0.25 to below 0.5, severe at 0.5 or above.
projected_arrival_datetime = departure_datetime + the best-available travel time: live traffic minutes when a live reading exists, otherwise the ideal planning travel time; it is null only when no travel-time value exists for the route.

Idempotency

Safe read; no side effects.

Response

Delay decomposition against the ideal travel time.

{
  "data": {
    "journey_id": "0d0b6f2e-6b1a-4f3e-9a4c-1f2e3d4c5b6a",
    "route_id": "3c2b1a0f-9e8d-4c7b-a6f5-e4d3c2b1a0f9",
    "ideal_travel_time_minutes": 120,
    "snapshot_delay_minutes": 18,
    "live_delay_minutes": 21,
    "delay_ratio": 0.175,
    "projected_arrival_datetime": "2026-09-28T11:06:00.000Z",
    "condition": "moderate"
  }
}

Errors

Code	HTTP	Cause
INVALID_REQUEST	400	The journey_id query parameter is missing or is not a valid resource identifier.
CAPABILITY_NOT_AUTHORIZED	403	The API key lacks the required scope, the route capability is disabled or the organization is not linked to an ORN platform account.
RESOURCE_NOT_FOUND	404	The requested journey was not found, is not owned by the linked ride-owner account, or no active pricing row exists for the operation.

GET/api/v1/route/route_intelligence_summaryroute_intelligence_summary

intelligence:readTier d₦500.00

Returns a fused route, journey state, checkpoint progress and active safety event posture for one owned journey.

Parameters

Name	In	Type	Required	Description
journey_id	query	string	Yes	Required UUID of the owned journey whose route intelligence summary is returned.

State constraints

No journey-state precondition is enforced; draft journeys without a planned route return a null route payload instead of an error.

Idempotency

Safe read; no side effects.

Response

Route intelligence combined with journey progress.

{
  "data": {
    "route": {
      "route_id": "3c2b1a0f-9e8d-4c7b-a6f5-e4d3c2b1a0f9",
      "origin": {
        "location": "Ikorodu Road Terminal, Lagos",
        "lat": 6.5902,
        "lng": 3.3667
      },
      "destination": {
        "location": "Ibadan Central Park",
        "lat": 7.3775,
        "lng": 3.947
      },
      "estimated_distance_km": 128,
      "ideal_travel_time_minutes": 120,
      "live_traffic_travel_time_minutes": 141,
      "traffic_delay_minutes": 21,
      "traffic_data_source": "live",
      "planned_at": "2026-09-26T09:00:00.000Z"
    },
    "state": "active",
    "checkpoint_progress": {
      "planned_total": 4,
      "completed": 2
    },
    "active_emergencies": 1
  }
}

Errors

Code	HTTP	Cause
INVALID_REQUEST	400	The journey_id query parameter is missing or is not a valid resource identifier.
CAPABILITY_NOT_AUTHORIZED	403	The API key lacks the required scope, the route capability is disabled or the organization is not linked to an ORN platform account.
RESOURCE_NOT_FOUND	404	The requested journey was not found, is not owned by the linked ride-owner account, or no active pricing row exists for the operation.

GET/api/v1/route/journey_traffic_contextjourney_traffic_context

intelligence:readTier d₦600.00

Returns the planning-route snapshot of one owned journey alongside live re-resolved traffic conditions and a deterministic traffic condition classification.

Parameters

Name	In	Type	Required	Description
journey_id	query	string	Yes	Required UUID of the owned journey whose traffic context is returned.

State constraints

No journey-state precondition is enforced; draft journeys without a planned route return a null route payload instead of an error.

Idempotency

Safe read; no side effects.

Response

Traffic snapshot plus any live replan for the journey.

{
  "data": {
    "journey_id": "0d0b6f2e-6b1a-4f3e-9a4c-1f2e3d4c5b6a",
    "route": {
      "route_id": "3c2b1a0f-9e8d-4c7b-a6f5-e4d3c2b1a0f9",
      "origin": {
        "location": "Ikorodu Road Terminal, Lagos",
        "lat": 6.5902,
        "lng": 3.3667
      },
      "destination": {
        "location": "Ibadan Central Park",
        "lat": 7.3775,
        "lng": 3.947
      },
      "estimated_distance_km": 128,
      "ideal_travel_time_minutes": 120,
      "live_traffic_travel_time_minutes": 141,
      "traffic_delay_minutes": 21,
      "traffic_data_source": "live",
      "planned_at": "2026-09-26T09:00:00.000Z"
    },
    "snapshot": {
      "travel_time_minutes": 138,
      "delay_minutes": 18,
      "data_source": "planning_snapshot"
    },
    "live_replan": {
      "travel_time_minutes": 141,
      "delay_minutes": 21,
      "data_source": "live"
    },
    "traffic_condition": "moderate"
  }
}

Errors

Code	HTTP	Cause
INVALID_REQUEST	400	The journey_id query parameter is missing or is not a valid resource identifier.
CAPABILITY_NOT_AUTHORIZED	403	The API key lacks the required scope, the route capability is disabled or the organization is not linked to an ORN platform account.
RESOURCE_NOT_FOUND	404	The requested journey was not found, is not owned by the linked ride-owner account, or no active pricing row exists for the operation.

GET/api/v1/route/traffic_aware_journey_analysistraffic_aware_journey_analysis

intelligence:readTier d₦600.00

Returns a traffic-aware journey posture for one owned journey combining live delay classification, checkpoint progress and the latest ORION risk assessment.

Parameters

Name	In	Type	Required	Description
journey_id	query	string	Yes	Required UUID of the owned journey whose traffic-aware analysis is returned.

State constraints

No journey-state precondition is enforced; draft journeys without a planned route return a null route payload instead of an error.

Idempotency

Safe read; no side effects.

Response

Traffic-aware arrival projection for the journey.

{
  "data": {
    "journey_id": "0d0b6f2e-6b1a-4f3e-9a4c-1f2e3d4c5b6a",
    "route": {
      "route_id": "3c2b1a0f-9e8d-4c7b-a6f5-e4d3c2b1a0f9",
      "origin": {
        "location": "Ikorodu Road Terminal, Lagos",
        "lat": 6.5902,
        "lng": 3.3667
      },
      "destination": {
        "location": "Ibadan Central Park",
        "lat": 7.3775,
        "lng": 3.947
      },
      "estimated_distance_km": 128,
      "ideal_travel_time_minutes": 120,
      "live_traffic_travel_time_minutes": 141,
      "traffic_delay_minutes": 21,
      "traffic_data_source": "live",
      "planned_at": "2026-09-26T09:00:00.000Z"
    },
    "traffic_condition": "moderate",
    "projected_arrival_datetime": "2026-09-28T11:06:00.000Z",
    "total_delay_minutes": 21,
    "checked_domains": [
      "route",
      "checkpoints",
      "safety",
      "state"
    ]
  }
}

Errors

Code	HTTP	Cause
INVALID_REQUEST	400	The journey_id query parameter is missing or is not a valid resource identifier.
CAPABILITY_NOT_AUTHORIZED	403	The API key lacks the required scope, the route capability is disabled or the organization is not linked to an ORN platform account.
RESOURCE_NOT_FOUND	404	The requested journey was not found, is not owned by the linked ride-owner account, or no active pricing row exists for the operation.

GET/api/v1/route/route_condition_analysisroute_condition_analysis

intelligence:readTier d₦650.00

Returns the current route condition classification for one owned journey with snapshot freshness indicators, distance and both snapshot and live data sources.

Parameters

Name	In	Type	Required	Description
journey_id	query	string	Yes	Required UUID of the owned journey whose route condition analysis is returned.

State constraints

No journey-state precondition is enforced; draft journeys without a planned route return a null route payload instead of an error.

Idempotency

Safe read; no side effects.

Response

Condition classification for the route.

{
  "data": {
    "route_id": "3c2b1a0f-9e8d-4c7b-a6f5-e4d3c2b1a0f9",
    "condition": "moderate",
    "distance_km": 128,
    "snapshot_data_source": "planning_snapshot",
    "live_data_source": "live",
    "has_live_conditions": true
  }
}

Errors

Code	HTTP	Cause
INVALID_REQUEST	400	The journey_id query parameter is missing or is not a valid resource identifier.
CAPABILITY_NOT_AUTHORIZED	403	The API key lacks the required scope, the route capability is disabled or the organization is not linked to an ORN platform account.
RESOURCE_NOT_FOUND	404	The requested journey was not found, is not owned by the linked ride-owner account, or no active pricing row exists for the operation.

GET/api/v1/route/mobility_anomaly_analysismobility_anomaly_analysis

intelligence:readTier d₦750.00

Returns a deterministic anomaly scan for one owned journey across route, checkpoints, safety events and journey state, with each finding citing the authoritative record that produced it.

Parameters

Name	In	Type	Required	Description
journey_id	query	string	Yes	Required UUID of the owned journey whose mobility anomaly analysis is returned.

State constraints

No journey-state precondition is enforced; draft journeys without a planned route return a null route payload instead of an error.
The arrival-window-elapsed anomaly is only evaluated while the journey state is planned, activated, boarding or active.

Idempotency

Safe read; no side effects.

Response

Anomalies detected across the journey domains. live_replan is null when no coordinates exist.

{
  "data": {
    "journey_id": "0d0b6f2e-6b1a-4f3e-9a4c-1f2e3d4c5b6a",
    "anomaly_count": 2,
    "anomalies": [
      {
        "type": "checkpoint_missed_or_escalated",
        "detail": "Checkpoint 3 is overdue."
      },
      {
        "type": "traffic_delay",
        "detail": "Live delay of 21 minutes exceeds the moderate threshold."
      }
    ],
    "checked_domains": [
      "route",
      "checkpoints",
      "safety",
      "state"
    ]
  }
}

Errors

Code	HTTP	Cause
INVALID_REQUEST	400	The journey_id query parameter is missing or is not a valid resource identifier.
CAPABILITY_NOT_AUTHORIZED	403	The API key lacks the required scope, the route capability is disabled or the organization is not linked to an ORN platform account.
RESOURCE_NOT_FOUND	404	The requested journey was not found, is not owned by the linked ride-owner account, or no active pricing row exists for the operation.

GET/api/v1/route/advanced_route_intelligenceadvanced_route_intelligence

intelligence:readTier d₦1,000.00

Parameters

Name	In	Type	Required	Description
journey_id	query	string	Yes	Required UUID of the owned journey whose advanced route intelligence is returned.

State constraints

No journey-state precondition is enforced; draft journeys without a planned route return a null route payload instead of an error.

Idempotency

Safe read; no side effects.

Response

Advanced route intelligence including problematic checkpoints.

{
  "data": {
    "route": {
      "route_id": "3c2b1a0f-9e8d-4c7b-a6f5-e4d3c2b1a0f9",
      "origin": {
        "location": "Ikorodu Road Terminal, Lagos",
        "lat": 6.5902,
        "lng": 3.3667
      },
      "destination": {
        "location": "Ibadan Central Park",
        "lat": 7.3775,
        "lng": 3.947
      },
      "estimated_distance_km": 128,
      "ideal_travel_time_minutes": 120,
      "live_traffic_travel_time_minutes": 141,
      "traffic_delay_minutes": 21,
      "traffic_data_source": "live",
      "planned_at": "2026-09-26T09:00:00.000Z"
    },
    "traffic_condition": "moderate",
    "projected_arrival_datetime": "2026-09-28T11:06:00.000Z",
    "problematic_checkpoints": [
      {
        "checkpoint_id": "f6a5b4c3-7777-4aaa-9bbb-8c9d0e1f2a3b",
        "checkpoint_number": 3,
        "status": "escalated"
      }
    ],
    "emergency_events_total": 1,
    "anomalies": [
      {
        "type": "arrival_window_elapsed",
        "detail": "Projected arrival is past the estimated window."
      }
    ]
  }
}

Errors

Code	HTTP	Cause
INVALID_REQUEST	400	The journey_id query parameter is missing or is not a valid resource identifier.
CAPABILITY_NOT_AUTHORIZED	403	The API key lacks the required scope, the route capability is disabled or the organization is not linked to an ORN platform account.
RESOURCE_NOT_FOUND	404	The requested journey was not found, is not owned by the linked ride-owner account, or no active pricing row exists for the operation.