Graduated Orion analysis operations, from basic contextual analysis to enterprise advanced intelligence.
GET/api/v1/intelligence/basic_orion_contextual_analysisbasic_orion_contextual_analysisintelligence:readTier f₦1,500.00
Return journey identity, route summary and current state composed from authoritative ORN records.
Parameters
| Name | In | Type | Required | Description |
|---|
| journey_id | query | string (uuid) | Yes | Identifier of the journey to analyze. |
State constraints
- The journey must exist and be owned by the requesting organization linked ride owner.
Idempotency
Safe read; no side effects.
Response
Baseline ORION analysis over the journey evidence.
{
"data": {
"scope": "journey",
"analysis_source": "composed_authoritative_records",
"risk_level": "low",
"summary": "Journey is progressing on schedule with one assistance-level event under investigation.",
"evidence": {
"journey": {
"journey_id": "0d0b6f2e-6b1a-4f3e-9a4c-1f2e3d4c5b6a",
"reference": "JRN-4F7K2Q",
"route_id": "3c2b1a0f-9e8d-4c7b-a6f5-e4d3c2b1a0f9",
"state": "draft",
"departure_datetime": "2026-09-28T08:30:00.000Z",
"estimated_arrival_datetime": "2026-09-28T10:45:00.000Z",
"available_seats": 3,
"fare_amount": 4500,
"currency": "NGN",
"driver_name": "Adaeze Okafor",
"driver_phone": "+2348030000000",
"vehicle_type": "bus",
"vehicle_colour": "White",
"created_at": "2026-09-26T09:12:44.120Z",
"updated_at": "2026-09-26T09:12:44.120Z"
},
"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"
},
"checkpoints": {
"planned_total": 4,
"recorded_total": 2,
"by_status": {
"triggered": 0,
"completed": 2,
"missed": 0,
"escalated": 0
}
},
"safety": {
"events_total": 1,
"events_by_level": {
"level_1_concern": 0,
"level_2_assistance": 1,
"level_3_critical": 0
},
"active_events": 1
},
"orion": {
"latest": {
"assessment_id": "a9b8c7d6-3333-4ccc-8ddd-4e5f6a7b8c9d",
"journey_id": "0d0b6f2e-6b1a-4f3e-9a4c-1f2e3d4c5b6a",
"risk_level": "low",
"summary": "Journey is progressing on schedule. All recorded checkpoints are completed and no safety events are active.",
"created_at": "2026-09-28T09:45:00.000Z"
},
"assessments_total": 3,
"by_risk_level": {
"low": 2,
"medium": 1,
"high": 0,
"critical": 0
}
},
"participation": {
"passengers": 12,
"by_status": {
"reserved": 2,
"boarded": 9,
"completed": 1,
"cancelled": 0
}
}
},
"anomalies": []
}
}
Errors
| Code | HTTP | Cause |
|---|
| INVALID_REQUEST | 400 | journey_id is missing or is not a valid resource identifier. |
| RESOURCE_NOT_FOUND | 404 | No journey owned by the requesting organization matches the supplied identifier. |
| CAPABILITY_NOT_AUTHORIZED | 403 | The API key lacks the intelligence:read scope, the capability is disabled, or the organization is not linked to an ORN platform account. |
GET/api/v1/intelligence/journey_intelligence_analysisjourney_intelligence_analysisintelligence:readTier f₦1,750.00
Return journey context fused with checkpoint progress and passenger participation posture.
Parameters
| Name | In | Type | Required | Description |
|---|
| journey_id | query | string (uuid) | Yes | Identifier of the journey to analyze. |
State constraints
- The journey must exist and be owned by the requesting organization linked ride owner.
Idempotency
Safe read; no side effects.
Response
Journey-scoped intelligence with anomaly detection.
{
"data": {
"scope": "journey",
"analysis_source": "composed_authoritative_records",
"risk_level": "low",
"summary": "One checkpoint overdue; route conditions remain moderate.",
"evidence": {
"journey": {
"journey_id": "0d0b6f2e-6b1a-4f3e-9a4c-1f2e3d4c5b6a",
"reference": "JRN-4F7K2Q",
"route_id": "3c2b1a0f-9e8d-4c7b-a6f5-e4d3c2b1a0f9",
"state": "draft",
"departure_datetime": "2026-09-28T08:30:00.000Z",
"estimated_arrival_datetime": "2026-09-28T10:45:00.000Z",
"available_seats": 3,
"fare_amount": 4500,
"currency": "NGN",
"driver_name": "Adaeze Okafor",
"driver_phone": "+2348030000000",
"vehicle_type": "bus",
"vehicle_colour": "White",
"created_at": "2026-09-26T09:12:44.120Z",
"updated_at": "2026-09-26T09:12:44.120Z"
},
"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"
},
"checkpoints": {
"planned_total": 4,
"recorded_total": 2,
"by_status": {
"triggered": 0,
"completed": 2,
"missed": 0,
"escalated": 0
}
},
"safety": {
"events_total": 1,
"events_by_level": {
"level_1_concern": 0,
"level_2_assistance": 1,
"level_3_critical": 0
},
"active_events": 1
},
"orion": {
"latest": {
"assessment_id": "a9b8c7d6-3333-4ccc-8ddd-4e5f6a7b8c9d",
"journey_id": "0d0b6f2e-6b1a-4f3e-9a4c-1f2e3d4c5b6a",
"risk_level": "low",
"summary": "Journey is progressing on schedule. All recorded checkpoints are completed and no safety events are active.",
"created_at": "2026-09-28T09:45:00.000Z"
},
"assessments_total": 3,
"by_risk_level": {
"low": 2,
"medium": 1,
"high": 0,
"critical": 0
}
},
"participation": {
"passengers": 12,
"by_status": {
"reserved": 2,
"boarded": 9,
"completed": 1,
"cancelled": 0
}
}
},
"anomalies": [
{
"type": "checkpoint_missed_or_escalated",
"detail": "Checkpoint 3 is overdue."
}
]
}
}
Errors
| Code | HTTP | Cause |
|---|
| INVALID_REQUEST | 400 | journey_id is missing or is not a valid resource identifier. |
| RESOURCE_NOT_FOUND | 404 | No journey owned by the requesting organization matches the supplied identifier. |
| CAPABILITY_NOT_AUTHORIZED | 403 | The API key lacks the intelligence:read scope, the capability is disabled, or the organization is not linked to an ORN platform account. |
GET/api/v1/intelligence/operational_intelligence_analysisoperational_intelligence_analysisintelligence:readTier f₦1,750.00
Return organization level aggregates for journeys, safety events, checkpoints and ORION assessments over a rolling window.
Parameters
| Name | In | Type | Required | Description |
|---|
| days | query | integer | No | Optional window length in days, clamped to the 1 to 90 range and defaulting to 30 when omitted. |
State constraints
- Window aggregates are capped at 1000 rows per domain query inside the clamped window.
Idempotency
Safe read; no side effects.
Response
Operational posture for the journey.
{
"data": {
"scope": "journey",
"analysis_source": "composed_authoritative_records",
"risk_level": "medium",
"summary": "Active safety event and checkpoint delay require operations attention.",
"evidence": {
"journey": {
"journey_id": "0d0b6f2e-6b1a-4f3e-9a4c-1f2e3d4c5b6a",
"reference": "JRN-4F7K2Q",
"route_id": "3c2b1a0f-9e8d-4c7b-a6f5-e4d3c2b1a0f9",
"state": "draft",
"departure_datetime": "2026-09-28T08:30:00.000Z",
"estimated_arrival_datetime": "2026-09-28T10:45:00.000Z",
"available_seats": 3,
"fare_amount": 4500,
"currency": "NGN",
"driver_name": "Adaeze Okafor",
"driver_phone": "+2348030000000",
"vehicle_type": "bus",
"vehicle_colour": "White",
"created_at": "2026-09-26T09:12:44.120Z",
"updated_at": "2026-09-26T09:12:44.120Z"
},
"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"
},
"checkpoints": {
"planned_total": 4,
"recorded_total": 2,
"by_status": {
"triggered": 0,
"completed": 2,
"missed": 0,
"escalated": 0
}
},
"safety": {
"events_total": 1,
"events_by_level": {
"level_1_concern": 0,
"level_2_assistance": 1,
"level_3_critical": 0
},
"active_events": 1
},
"orion": {
"latest": {
"assessment_id": "a9b8c7d6-3333-4ccc-8ddd-4e5f6a7b8c9d",
"journey_id": "0d0b6f2e-6b1a-4f3e-9a4c-1f2e3d4c5b6a",
"risk_level": "low",
"summary": "Journey is progressing on schedule. All recorded checkpoints are completed and no safety events are active.",
"created_at": "2026-09-28T09:45:00.000Z"
},
"assessments_total": 3,
"by_risk_level": {
"low": 2,
"medium": 1,
"high": 0,
"critical": 0
}
},
"participation": {
"passengers": 12,
"by_status": {
"reserved": 2,
"boarded": 9,
"completed": 1,
"cancelled": 0
}
}
},
"anomalies": [
{
"type": "checkpoint_missed_or_escalated",
"detail": "Checkpoint 3 is overdue."
},
{
"type": "active_emergency",
"detail": "One assistance-level event is active."
}
]
}
}
Errors
| Code | HTTP | Cause |
|---|
| INVALID_REQUEST | 400 | days is present but is not an integer. |
| CAPABILITY_NOT_AUTHORIZED | 403 | The API key lacks the intelligence:read scope, the capability is disabled, or the organization is not linked to an ORN platform account. |
GET/api/v1/intelligence/safety_context_orion_analysissafety_context_orion_analysisintelligence:readTier f₦2,000.00
Return the safety posture of a journey fused with its ORION risk assessment context.
Parameters
| Name | In | Type | Required | Description |
|---|
| journey_id | query | string (uuid) | Yes | Identifier of the journey to analyze. |
State constraints
- The journey must exist and be owned by the requesting organization linked ride owner.
Idempotency
Safe read; no side effects.
Response
Safety-focused ORION analysis for the journey.
{
"data": {
"scope": "journey",
"analysis_source": "composed_authoritative_records",
"risk_level": "medium",
"summary": "One assistance-level event is under investigation; exposure limited to 12 passengers.",
"evidence": {
"journey": {
"journey_id": "0d0b6f2e-6b1a-4f3e-9a4c-1f2e3d4c5b6a",
"reference": "JRN-4F7K2Q",
"route_id": "3c2b1a0f-9e8d-4c7b-a6f5-e4d3c2b1a0f9",
"state": "draft",
"departure_datetime": "2026-09-28T08:30:00.000Z",
"estimated_arrival_datetime": "2026-09-28T10:45:00.000Z",
"available_seats": 3,
"fare_amount": 4500,
"currency": "NGN",
"driver_name": "Adaeze Okafor",
"driver_phone": "+2348030000000",
"vehicle_type": "bus",
"vehicle_colour": "White",
"created_at": "2026-09-26T09:12:44.120Z",
"updated_at": "2026-09-26T09:12:44.120Z"
},
"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"
},
"checkpoints": {
"planned_total": 4,
"recorded_total": 2,
"by_status": {
"triggered": 0,
"completed": 2,
"missed": 0,
"escalated": 0
}
},
"safety": {
"events_total": 1,
"events_by_level": {
"level_1_concern": 0,
"level_2_assistance": 1,
"level_3_critical": 0
},
"active_events": 1
},
"orion": {
"latest": {
"assessment_id": "a9b8c7d6-3333-4ccc-8ddd-4e5f6a7b8c9d",
"journey_id": "0d0b6f2e-6b1a-4f3e-9a4c-1f2e3d4c5b6a",
"risk_level": "low",
"summary": "Journey is progressing on schedule. All recorded checkpoints are completed and no safety events are active.",
"created_at": "2026-09-28T09:45:00.000Z"
},
"assessments_total": 3,
"by_risk_level": {
"low": 2,
"medium": 1,
"high": 0,
"critical": 0
}
},
"participation": {
"passengers": 12,
"by_status": {
"reserved": 2,
"boarded": 9,
"completed": 1,
"cancelled": 0
}
}
},
"anomalies": [
{
"type": "active_emergency",
"detail": "One assistance-level event is active."
}
]
}
}
Errors
| Code | HTTP | Cause |
|---|
| INVALID_REQUEST | 400 | journey_id is missing or is not a valid resource identifier. |
| RESOURCE_NOT_FOUND | 404 | No journey owned by the requesting organization matches the supplied identifier. |
| CAPABILITY_NOT_AUTHORIZED | 403 | The API key lacks the intelligence:read scope, the capability is disabled, or the organization is not linked to an ORN platform account. |
GET/api/v1/intelligence/advanced_journey_intelligenceadvanced_journey_intelligenceintelligence:readTier f₦2,500.00
Return the deep journey surface including checkpoint progress, participation and recent state history.
Parameters
| Name | In | Type | Required | Description |
|---|
| journey_id | query | string (uuid) | Yes | Identifier of the journey to analyze. |
State constraints
- The journey must exist and be owned by the requesting organization linked ride owner.
- recent_state_history is capped at the 20 most recent journey_state_history transitions ordered by change time descending.
Idempotency
Safe read; no side effects.
Response
Deeper journey intelligence with per-domain breakdowns.
{
"data": {
"scope": "journey",
"analysis_source": "composed_authoritative_records",
"risk_level": "medium",
"summary": "Checkpoint slippage is the dominant risk; safety exposure is contained.",
"evidence": {
"journey": {
"journey_id": "0d0b6f2e-6b1a-4f3e-9a4c-1f2e3d4c5b6a",
"reference": "JRN-4F7K2Q",
"route_id": "3c2b1a0f-9e8d-4c7b-a6f5-e4d3c2b1a0f9",
"state": "draft",
"departure_datetime": "2026-09-28T08:30:00.000Z",
"estimated_arrival_datetime": "2026-09-28T10:45:00.000Z",
"available_seats": 3,
"fare_amount": 4500,
"currency": "NGN",
"driver_name": "Adaeze Okafor",
"driver_phone": "+2348030000000",
"vehicle_type": "bus",
"vehicle_colour": "White",
"created_at": "2026-09-26T09:12:44.120Z",
"updated_at": "2026-09-26T09:12:44.120Z"
},
"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"
},
"checkpoints": {
"planned_total": 4,
"recorded_total": 2,
"by_status": {
"triggered": 0,
"completed": 2,
"missed": 0,
"escalated": 0
}
},
"safety": {
"events_total": 1,
"events_by_level": {
"level_1_concern": 0,
"level_2_assistance": 1,
"level_3_critical": 0
},
"active_events": 1
},
"orion": {
"latest": {
"assessment_id": "a9b8c7d6-3333-4ccc-8ddd-4e5f6a7b8c9d",
"journey_id": "0d0b6f2e-6b1a-4f3e-9a4c-1f2e3d4c5b6a",
"risk_level": "low",
"summary": "Journey is progressing on schedule. All recorded checkpoints are completed and no safety events are active.",
"created_at": "2026-09-28T09:45:00.000Z"
},
"assessments_total": 3,
"by_risk_level": {
"low": 2,
"medium": 1,
"high": 0,
"critical": 0
}
},
"participation": {
"passengers": 12,
"by_status": {
"reserved": 2,
"boarded": 9,
"completed": 1,
"cancelled": 0
}
}
},
"anomalies": [
{
"type": "checkpoint_missed_or_escalated",
"detail": "Checkpoint 3 is overdue."
}
],
"recommendations": [
"Follow up on checkpoint 3 with the driver.",
"Monitor the assistance-level event to resolution."
]
}
}
Errors
| Code | HTTP | Cause |
|---|
| INVALID_REQUEST | 400 | journey_id is missing or is not a valid resource identifier. |
| RESOURCE_NOT_FOUND | 404 | No journey owned by the requesting organization matches the supplied identifier. |
| CAPABILITY_NOT_AUTHORIZED | 403 | The API key lacks the intelligence:read scope, the capability is disabled, or the organization is not linked to an ORN platform account. |
GET/api/v1/intelligence/advanced_orion_analysisadvanced_orion_analysisintelligence:readTier f₦3,000.00
Return ORION assessment history and risk level statistics for a journey.
Parameters
| Name | In | Type | Required | Description |
|---|
| journey_id | query | string (uuid) | Yes | Identifier of the journey to analyze. |
State constraints
- The journey must exist and be owned by the requesting organization linked ride owner.
- orion history is capped at the 20 most recent assessments ordered by creation time descending.
Idempotency
Safe read; no side effects.
Response
Advanced ORION analysis across the journey and its organization.
{
"data": {
"scope": "journey_and_organization",
"analysis_source": "composed_authoritative_records",
"risk_level": "medium",
"summary": "Journey-level checkpoint slippage mirrors a small number of organization-wide misses.",
"journey_evidence": {
"journey": {
"journey_id": "0d0b6f2e-6b1a-4f3e-9a4c-1f2e3d4c5b6a",
"reference": "JRN-4F7K2Q",
"route_id": "3c2b1a0f-9e8d-4c7b-a6f5-e4d3c2b1a0f9",
"state": "draft",
"departure_datetime": "2026-09-28T08:30:00.000Z",
"estimated_arrival_datetime": "2026-09-28T10:45:00.000Z",
"available_seats": 3,
"fare_amount": 4500,
"currency": "NGN",
"driver_name": "Adaeze Okafor",
"driver_phone": "+2348030000000",
"vehicle_type": "bus",
"vehicle_colour": "White",
"created_at": "2026-09-26T09:12:44.120Z",
"updated_at": "2026-09-26T09:12:44.120Z"
},
"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"
},
"checkpoints": {
"planned_total": 4,
"recorded_total": 2,
"by_status": {
"triggered": 0,
"completed": 2,
"missed": 0,
"escalated": 0
}
},
"safety": {
"events_total": 1,
"events_by_level": {
"level_1_concern": 0,
"level_2_assistance": 1,
"level_3_critical": 0
},
"active_events": 1
},
"orion": {
"latest": {
"assessment_id": "a9b8c7d6-3333-4ccc-8ddd-4e5f6a7b8c9d",
"journey_id": "0d0b6f2e-6b1a-4f3e-9a4c-1f2e3d4c5b6a",
"risk_level": "low",
"summary": "Journey is progressing on schedule. All recorded checkpoints are completed and no safety events are active.",
"created_at": "2026-09-28T09:45:00.000Z"
},
"assessments_total": 3,
"by_risk_level": {
"low": 2,
"medium": 1,
"high": 0,
"critical": 0
}
},
"participation": {
"passengers": 12,
"by_status": {
"reserved": 2,
"boarded": 9,
"completed": 1,
"cancelled": 0
}
}
},
"organization_evidence": {
"organization_id": "9f8e7d6c-4444-4ddd-8eee-5f6a7b8c9d0e",
"journeys_total": 48,
"by_state": {
"draft": 2,
"planned": 9,
"active": 4,
"completed": 31,
"cancelled": 2
},
"checkpoints": {
"planned_total": 190,
"recorded_total": 164,
"missed": 3,
"escalated": 1
},
"safety": {
"events_total": 6,
"active_events": 1
},
"orion": {
"assessments_total": 41,
"by_risk_level": {
"low": 30,
"medium": 9,
"high": 2,
"critical": 0
}
},
"passengers": {
"participation_total": 512,
"active_total": 38
}
},
"anomalies": [
{
"type": "checkpoint_missed_or_escalated",
"detail": "Checkpoint 3 is overdue."
}
]
}
}
Errors
| Code | HTTP | Cause |
|---|
| INVALID_REQUEST | 400 | journey_id is missing or is not a valid resource identifier. |
| RESOURCE_NOT_FOUND | 404 | No journey owned by the requesting organization matches the supplied identifier. |
| CAPABILITY_NOT_AUTHORIZED | 403 | The API key lacks the intelligence:read scope, the capability is disabled, or the organization is not linked to an ORN platform account. |
GET/api/v1/intelligence/multi_signal_journey_analysismulti_signal_journey_analysisintelligence:readTier h₦5,000.00
Return the fused route, checkpoint, safety, ORION and participation signals for a journey.
Parameters
| Name | In | Type | Required | Description |
|---|
| journey_id | query | string (uuid) | Yes | Identifier of the journey to analyze. |
State constraints
- The journey must exist and be owned by the requesting organization linked ride owner.
Idempotency
Safe read; no side effects.
Response
Fuses route, checkpoint, safety and state signals.
{
"data": {
"scope": "journey",
"analysis_source": "composed_authoritative_records",
"risk_level": "medium",
"summary": "Traffic delay and checkpoint slippage compound into a projected late arrival.",
"evidence": {
"journey": {
"journey_id": "0d0b6f2e-6b1a-4f3e-9a4c-1f2e3d4c5b6a",
"reference": "JRN-4F7K2Q",
"route_id": "3c2b1a0f-9e8d-4c7b-a6f5-e4d3c2b1a0f9",
"state": "draft",
"departure_datetime": "2026-09-28T08:30:00.000Z",
"estimated_arrival_datetime": "2026-09-28T10:45:00.000Z",
"available_seats": 3,
"fare_amount": 4500,
"currency": "NGN",
"driver_name": "Adaeze Okafor",
"driver_phone": "+2348030000000",
"vehicle_type": "bus",
"vehicle_colour": "White",
"created_at": "2026-09-26T09:12:44.120Z",
"updated_at": "2026-09-26T09:12:44.120Z"
},
"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"
},
"checkpoints": {
"planned_total": 4,
"recorded_total": 2,
"by_status": {
"triggered": 0,
"completed": 2,
"missed": 0,
"escalated": 0
}
},
"safety": {
"events_total": 1,
"events_by_level": {
"level_1_concern": 0,
"level_2_assistance": 1,
"level_3_critical": 0
},
"active_events": 1
},
"orion": {
"latest": {
"assessment_id": "a9b8c7d6-3333-4ccc-8ddd-4e5f6a7b8c9d",
"journey_id": "0d0b6f2e-6b1a-4f3e-9a4c-1f2e3d4c5b6a",
"risk_level": "low",
"summary": "Journey is progressing on schedule. All recorded checkpoints are completed and no safety events are active.",
"created_at": "2026-09-28T09:45:00.000Z"
},
"assessments_total": 3,
"by_risk_level": {
"low": 2,
"medium": 1,
"high": 0,
"critical": 0
}
},
"participation": {
"passengers": 12,
"by_status": {
"reserved": 2,
"boarded": 9,
"completed": 1,
"cancelled": 0
}
}
},
"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 | journey_id is missing or is not a valid resource identifier. |
| RESOURCE_NOT_FOUND | 404 | No journey owned by the requesting organization matches the supplied identifier. |
| CAPABILITY_NOT_AUTHORIZED | 403 | The API key lacks the intelligence:read scope, the capability is disabled, or the organization is not linked to an ORN platform account. |
GET/api/v1/intelligence/complex_journey_intelligencecomplex_journey_intelligenceintelligence:readTier h₦5,000.00
Return the full multi signal journey pack with active emergency counts, recent state history and anomaly scan results.
Parameters
| Name | In | Type | Required | Description |
|---|
| journey_id | query | string (uuid) | Yes | Identifier of the journey to analyze. |
State constraints
- The journey must exist and be owned by the requesting organization linked ride owner.
- recent_state_history is capped at the 20 most recent journey_state_history transitions ordered by change time descending.
- anomalies are derived deterministically from missed or escalated checkpoints, active emergency events and missing ORION assessments.
Idempotency
Safe read; no side effects.
Response
Complex journey intelligence with prioritized findings.
{
"data": {
"scope": "journey",
"analysis_source": "composed_authoritative_records",
"risk_level": "medium",
"summary": "Prioritized actions: resolve checkpoint 3, close the assistance event.",
"evidence": {
"journey": {
"journey_id": "0d0b6f2e-6b1a-4f3e-9a4c-1f2e3d4c5b6a",
"reference": "JRN-4F7K2Q",
"route_id": "3c2b1a0f-9e8d-4c7b-a6f5-e4d3c2b1a0f9",
"state": "draft",
"departure_datetime": "2026-09-28T08:30:00.000Z",
"estimated_arrival_datetime": "2026-09-28T10:45:00.000Z",
"available_seats": 3,
"fare_amount": 4500,
"currency": "NGN",
"driver_name": "Adaeze Okafor",
"driver_phone": "+2348030000000",
"vehicle_type": "bus",
"vehicle_colour": "White",
"created_at": "2026-09-26T09:12:44.120Z",
"updated_at": "2026-09-26T09:12:44.120Z"
},
"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"
},
"checkpoints": {
"planned_total": 4,
"recorded_total": 2,
"by_status": {
"triggered": 0,
"completed": 2,
"missed": 0,
"escalated": 0
}
},
"safety": {
"events_total": 1,
"events_by_level": {
"level_1_concern": 0,
"level_2_assistance": 1,
"level_3_critical": 0
},
"active_events": 1
},
"orion": {
"latest": {
"assessment_id": "a9b8c7d6-3333-4ccc-8ddd-4e5f6a7b8c9d",
"journey_id": "0d0b6f2e-6b1a-4f3e-9a4c-1f2e3d4c5b6a",
"risk_level": "low",
"summary": "Journey is progressing on schedule. All recorded checkpoints are completed and no safety events are active.",
"created_at": "2026-09-28T09:45:00.000Z"
},
"assessments_total": 3,
"by_risk_level": {
"low": 2,
"medium": 1,
"high": 0,
"critical": 0
}
},
"participation": {
"passengers": 12,
"by_status": {
"reserved": 2,
"boarded": 9,
"completed": 1,
"cancelled": 0
}
}
},
"anomalies": [
{
"type": "checkpoint_missed_or_escalated",
"detail": "Checkpoint 3 is overdue."
},
{
"type": "active_emergency",
"detail": "One assistance-level event is active."
}
],
"findings": [
{
"priority": 1,
"domain": "checkpoints",
"detail": "Checkpoint 3 escalated."
},
{
"priority": 2,
"domain": "safety",
"detail": "Assistance event under investigation."
}
]
}
}
Errors
| Code | HTTP | Cause |
|---|
| INVALID_REQUEST | 400 | journey_id is missing or is not a valid resource identifier. |
| RESOURCE_NOT_FOUND | 404 | No journey owned by the requesting organization matches the supplied identifier. |
| CAPABILITY_NOT_AUTHORIZED | 403 | The API key lacks the intelligence:read scope, the capability is disabled, or the organization is not linked to an ORN platform account. |
GET/api/v1/intelligence/advanced_specialized_intelligenceadvanced_specialized_intelligenceintelligence:readTier h₦3,000.00
Return a deep dive into one requested journey domain from the authoritative record set.
Parameters
| Name | In | Type | Required | Description |
|---|
| journey_id | query | string (uuid) | Yes | Identifier of the journey to analyze. |
| focus | query | string | No | Optional analysis focus, one of safety, route, checkpoints or passengers, defaulting to safety. |
State constraints
- The journey must exist and be owned by the requesting organization linked ride owner.
- focus must be one of safety, route, checkpoints or passengers and the returned section follows the requested focus.
Idempotency
Safe read; no side effects.
Response
Specialized analysis combining journey and organization scopes.
{
"data": {
"scope": "journey_and_organization",
"analysis_source": "composed_authoritative_records",
"risk_level": "medium",
"summary": "Organization shows two high-risk journeys this month; this journey is medium risk.",
"journey_evidence": {
"journey": {
"journey_id": "0d0b6f2e-6b1a-4f3e-9a4c-1f2e3d4c5b6a",
"reference": "JRN-4F7K2Q",
"route_id": "3c2b1a0f-9e8d-4c7b-a6f5-e4d3c2b1a0f9",
"state": "draft",
"departure_datetime": "2026-09-28T08:30:00.000Z",
"estimated_arrival_datetime": "2026-09-28T10:45:00.000Z",
"available_seats": 3,
"fare_amount": 4500,
"currency": "NGN",
"driver_name": "Adaeze Okafor",
"driver_phone": "+2348030000000",
"vehicle_type": "bus",
"vehicle_colour": "White",
"created_at": "2026-09-26T09:12:44.120Z",
"updated_at": "2026-09-26T09:12:44.120Z"
},
"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"
},
"checkpoints": {
"planned_total": 4,
"recorded_total": 2,
"by_status": {
"triggered": 0,
"completed": 2,
"missed": 0,
"escalated": 0
}
},
"safety": {
"events_total": 1,
"events_by_level": {
"level_1_concern": 0,
"level_2_assistance": 1,
"level_3_critical": 0
},
"active_events": 1
},
"orion": {
"latest": {
"assessment_id": "a9b8c7d6-3333-4ccc-8ddd-4e5f6a7b8c9d",
"journey_id": "0d0b6f2e-6b1a-4f3e-9a4c-1f2e3d4c5b6a",
"risk_level": "low",
"summary": "Journey is progressing on schedule. All recorded checkpoints are completed and no safety events are active.",
"created_at": "2026-09-28T09:45:00.000Z"
},
"assessments_total": 3,
"by_risk_level": {
"low": 2,
"medium": 1,
"high": 0,
"critical": 0
}
},
"participation": {
"passengers": 12,
"by_status": {
"reserved": 2,
"boarded": 9,
"completed": 1,
"cancelled": 0
}
}
},
"organization_evidence": {
"organization_id": "9f8e7d6c-4444-4ddd-8eee-5f6a7b8c9d0e",
"journeys_total": 48,
"by_state": {
"draft": 2,
"planned": 9,
"active": 4,
"completed": 31,
"cancelled": 2
},
"checkpoints": {
"planned_total": 190,
"recorded_total": 164,
"missed": 3,
"escalated": 1
},
"safety": {
"events_total": 6,
"active_events": 1
},
"orion": {
"assessments_total": 41,
"by_risk_level": {
"low": 30,
"medium": 9,
"high": 2,
"critical": 0
}
},
"passengers": {
"participation_total": 512,
"active_total": 38
}
},
"anomalies": [
{
"type": "checkpoint_missed_or_escalated",
"detail": "Checkpoint 3 is overdue."
}
]
}
}
Errors
| Code | HTTP | Cause |
|---|
| INVALID_REQUEST | 400 | journey_id is missing or invalid, or focus is not one of safety, route, checkpoints or passengers. |
| RESOURCE_NOT_FOUND | 404 | No journey owned by the requesting organization matches the supplied identifier. |
| CAPABILITY_NOT_AUTHORIZED | 403 | The API key lacks the intelligence:read scope, the capability is disabled, or the organization is not linked to an ORN platform account. |
GET/api/v1/intelligence/complex_orion_intelligence_operationcomplex_orion_intelligence_operationintelligence:readTier h₦10,000.00
Return the full journey evidence pack with anomaly scan results fused with organization level window aggregates.
Parameters
| Name | In | Type | Required | Description |
|---|
| journey_id | query | string (uuid) | Yes | Identifier of the journey to analyze. |
| days | query | integer | No | Optional organization window length in days, clamped to the 1 to 90 range and defaulting to 30 when omitted. |
State constraints
- The journey must exist and be owned by the requesting organization linked ride owner.
- Window aggregates are capped at 1000 rows per domain query inside the clamped window.
Idempotency
Safe read; no side effects.
Response
Complex ORION operation over all authoritative records.
{
"data": {
"scope": "journey_and_organization",
"analysis_source": "composed_authoritative_records",
"risk_level": "medium",
"summary": "Operational load is within tolerance; one journey needs escalation follow-up.",
"journey_evidence": {
"journey": {
"journey_id": "0d0b6f2e-6b1a-4f3e-9a4c-1f2e3d4c5b6a",
"reference": "JRN-4F7K2Q",
"route_id": "3c2b1a0f-9e8d-4c7b-a6f5-e4d3c2b1a0f9",
"state": "draft",
"departure_datetime": "2026-09-28T08:30:00.000Z",
"estimated_arrival_datetime": "2026-09-28T10:45:00.000Z",
"available_seats": 3,
"fare_amount": 4500,
"currency": "NGN",
"driver_name": "Adaeze Okafor",
"driver_phone": "+2348030000000",
"vehicle_type": "bus",
"vehicle_colour": "White",
"created_at": "2026-09-26T09:12:44.120Z",
"updated_at": "2026-09-26T09:12:44.120Z"
},
"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"
},
"checkpoints": {
"planned_total": 4,
"recorded_total": 2,
"by_status": {
"triggered": 0,
"completed": 2,
"missed": 0,
"escalated": 0
}
},
"safety": {
"events_total": 1,
"events_by_level": {
"level_1_concern": 0,
"level_2_assistance": 1,
"level_3_critical": 0
},
"active_events": 1
},
"orion": {
"latest": {
"assessment_id": "a9b8c7d6-3333-4ccc-8ddd-4e5f6a7b8c9d",
"journey_id": "0d0b6f2e-6b1a-4f3e-9a4c-1f2e3d4c5b6a",
"risk_level": "low",
"summary": "Journey is progressing on schedule. All recorded checkpoints are completed and no safety events are active.",
"created_at": "2026-09-28T09:45:00.000Z"
},
"assessments_total": 3,
"by_risk_level": {
"low": 2,
"medium": 1,
"high": 0,
"critical": 0
}
},
"participation": {
"passengers": 12,
"by_status": {
"reserved": 2,
"boarded": 9,
"completed": 1,
"cancelled": 0
}
}
},
"organization_evidence": {
"organization_id": "9f8e7d6c-4444-4ddd-8eee-5f6a7b8c9d0e",
"journeys_total": 48,
"by_state": {
"draft": 2,
"planned": 9,
"active": 4,
"completed": 31,
"cancelled": 2
},
"checkpoints": {
"planned_total": 190,
"recorded_total": 164,
"missed": 3,
"escalated": 1
},
"safety": {
"events_total": 6,
"active_events": 1
},
"orion": {
"assessments_total": 41,
"by_risk_level": {
"low": 30,
"medium": 9,
"high": 2,
"critical": 0
}
},
"passengers": {
"participation_total": 512,
"active_total": 38
}
},
"anomalies": [
{
"type": "no_orion_assessment",
"detail": "One active journey has no recent ORION assessment."
}
]
}
}
Errors
| Code | HTTP | Cause |
|---|
| INVALID_REQUEST | 400 | journey_id is missing or invalid, or days is present but not an integer. |
| RESOURCE_NOT_FOUND | 404 | No journey owned by the requesting organization matches the supplied identifier. |
| CAPABILITY_NOT_AUTHORIZED | 403 | The API key lacks the intelligence:read scope, the capability is disabled, or the organization is not linked to an ORN platform account. |
GET/api/v1/intelligence/multi_domain_orion_analysismulti_domain_orion_analysisintelligence:readTier h₦10,000.00
Return journey evidence fused with organization level window aggregates across both domains.
Parameters
| Name | In | Type | Required | Description |
|---|
| journey_id | query | string (uuid) | Yes | Identifier of the journey to analyze. |
| days | query | integer | No | Optional organization window length in days, clamped to the 1 to 90 range and defaulting to 30 when omitted. |
State constraints
- The journey must exist and be owned by the requesting organization linked ride owner.
- Window aggregates are capped at 1000 rows per domain query inside the clamped window.
Idempotency
Safe read; no side effects.
Response
Explicit multi-domain scan across route, checkpoints, safety and state.
{
"data": {
"scope": "journey",
"analysis_source": "composed_authoritative_records",
"risk_level": "low",
"summary": "All domains scanned; only route conditions are elevated.",
"evidence": {
"journey": {
"journey_id": "0d0b6f2e-6b1a-4f3e-9a4c-1f2e3d4c5b6a",
"reference": "JRN-4F7K2Q",
"route_id": "3c2b1a0f-9e8d-4c7b-a6f5-e4d3c2b1a0f9",
"state": "draft",
"departure_datetime": "2026-09-28T08:30:00.000Z",
"estimated_arrival_datetime": "2026-09-28T10:45:00.000Z",
"available_seats": 3,
"fare_amount": 4500,
"currency": "NGN",
"driver_name": "Adaeze Okafor",
"driver_phone": "+2348030000000",
"vehicle_type": "bus",
"vehicle_colour": "White",
"created_at": "2026-09-26T09:12:44.120Z",
"updated_at": "2026-09-26T09:12:44.120Z"
},
"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"
},
"checkpoints": {
"planned_total": 4,
"recorded_total": 2,
"by_status": {
"triggered": 0,
"completed": 2,
"missed": 0,
"escalated": 0
}
},
"safety": {
"events_total": 1,
"events_by_level": {
"level_1_concern": 0,
"level_2_assistance": 1,
"level_3_critical": 0
},
"active_events": 1
},
"orion": {
"latest": {
"assessment_id": "a9b8c7d6-3333-4ccc-8ddd-4e5f6a7b8c9d",
"journey_id": "0d0b6f2e-6b1a-4f3e-9a4c-1f2e3d4c5b6a",
"risk_level": "low",
"summary": "Journey is progressing on schedule. All recorded checkpoints are completed and no safety events are active.",
"created_at": "2026-09-28T09:45:00.000Z"
},
"assessments_total": 3,
"by_risk_level": {
"low": 2,
"medium": 1,
"high": 0,
"critical": 0
}
},
"participation": {
"passengers": 12,
"by_status": {
"reserved": 2,
"boarded": 9,
"completed": 1,
"cancelled": 0
}
}
},
"anomalies": [
{
"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 | journey_id is missing or invalid, or days is present but not an integer. |
| RESOURCE_NOT_FOUND | 404 | No journey owned by the requesting organization matches the supplied identifier. |
| CAPABILITY_NOT_AUTHORIZED | 403 | The API key lacks the intelligence:read scope, the capability is disabled, or the organization is not linked to an ORN platform account. |
GET/api/v1/intelligence/highly_specialized_intelligencehighly_specialized_intelligenceintelligence:readTier h₦15,000.00
Return the full journey and organization evidence pack with a free form focus label, anomaly scan and rolling window aggregates.
Parameters
| Name | In | Type | Required | Description |
|---|
| journey_id | query | string (uuid) | Yes | Identifier of the journey to analyze. |
| focus | query | string | No | Optional free form focus label echoed into the response, defaulting to general. |
| days | query | integer | No | Optional organization window length in days, clamped to the 1 to 90 range and defaulting to 30 when omitted. |
State constraints
- The journey must exist and be owned by the requesting organization linked ride owner.
- Window aggregates are capped at 1000 rows per domain query inside the clamped window.
Idempotency
Safe read; no side effects.
Response
Highly specialized intelligence with domain scores.
{
"data": {
"scope": "journey_and_organization",
"analysis_source": "composed_authoritative_records",
"risk_level": "medium",
"summary": "Checkpoint reliability is the weakest domain for the organization.",
"journey_evidence": {
"journey": {
"journey_id": "0d0b6f2e-6b1a-4f3e-9a4c-1f2e3d4c5b6a",
"reference": "JRN-4F7K2Q",
"route_id": "3c2b1a0f-9e8d-4c7b-a6f5-e4d3c2b1a0f9",
"state": "draft",
"departure_datetime": "2026-09-28T08:30:00.000Z",
"estimated_arrival_datetime": "2026-09-28T10:45:00.000Z",
"available_seats": 3,
"fare_amount": 4500,
"currency": "NGN",
"driver_name": "Adaeze Okafor",
"driver_phone": "+2348030000000",
"vehicle_type": "bus",
"vehicle_colour": "White",
"created_at": "2026-09-26T09:12:44.120Z",
"updated_at": "2026-09-26T09:12:44.120Z"
},
"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"
},
"checkpoints": {
"planned_total": 4,
"recorded_total": 2,
"by_status": {
"triggered": 0,
"completed": 2,
"missed": 0,
"escalated": 0
}
},
"safety": {
"events_total": 1,
"events_by_level": {
"level_1_concern": 0,
"level_2_assistance": 1,
"level_3_critical": 0
},
"active_events": 1
},
"orion": {
"latest": {
"assessment_id": "a9b8c7d6-3333-4ccc-8ddd-4e5f6a7b8c9d",
"journey_id": "0d0b6f2e-6b1a-4f3e-9a4c-1f2e3d4c5b6a",
"risk_level": "low",
"summary": "Journey is progressing on schedule. All recorded checkpoints are completed and no safety events are active.",
"created_at": "2026-09-28T09:45:00.000Z"
},
"assessments_total": 3,
"by_risk_level": {
"low": 2,
"medium": 1,
"high": 0,
"critical": 0
}
},
"participation": {
"passengers": 12,
"by_status": {
"reserved": 2,
"boarded": 9,
"completed": 1,
"cancelled": 0
}
}
},
"organization_evidence": {
"organization_id": "9f8e7d6c-4444-4ddd-8eee-5f6a7b8c9d0e",
"journeys_total": 48,
"by_state": {
"draft": 2,
"planned": 9,
"active": 4,
"completed": 31,
"cancelled": 2
},
"checkpoints": {
"planned_total": 190,
"recorded_total": 164,
"missed": 3,
"escalated": 1
},
"safety": {
"events_total": 6,
"active_events": 1
},
"orion": {
"assessments_total": 41,
"by_risk_level": {
"low": 30,
"medium": 9,
"high": 2,
"critical": 0
}
},
"passengers": {
"participation_total": 512,
"active_total": 38
}
},
"anomalies": [
{
"type": "checkpoint_missed_or_escalated",
"detail": "3 organization-wide checkpoint misses recorded."
}
],
"domain_scores": {
"route": 0.82,
"checkpoints": 0.61,
"safety": 0.88,
"state": 0.95
}
}
}
Errors
| Code | HTTP | Cause |
|---|
| INVALID_REQUEST | 400 | journey_id is missing or invalid, or days is present but not an integer. |
| RESOURCE_NOT_FOUND | 404 | No journey owned by the requesting organization matches the supplied identifier. |
| CAPABILITY_NOT_AUTHORIZED | 403 | The API key lacks the intelligence:read scope, the capability is disabled, or the organization is not linked to an ORN platform account. |
GET/api/v1/intelligence/enterprise_advanced_intelligenceenterprise_advanced_intelligenceintelligence:readTier h₦15,000.00
Return organization level current and prior window aggregates for advanced multi window analysis.
Parameters
| Name | In | Type | Required | Description |
|---|
| days | query | integer | No | Optional current window length in days, clamped to the 1 to 90 range and defaulting to 30 when omitted. |
State constraints
- Window aggregates are capped at 1000 rows per domain query inside the clamped window.
- prior_window equals the doubled window counts minus current window counts with a floor of zero.
Idempotency
Safe read; no side effects.
Response
Enterprise analysis with current and prior window comparison.
{
"data": {
"scope": "organization",
"analysis_source": "composed_authoritative_records",
"risk_level": "low",
"summary": "Completed journeys rose month over month; safety events held steady.",
"current_window": {
"organization_id": "9f8e7d6c-4444-4ddd-8eee-5f6a7b8c9d0e",
"journeys_total": 48,
"by_state": {
"draft": 2,
"planned": 9,
"active": 4,
"completed": 31,
"cancelled": 2
},
"checkpoints": {
"planned_total": 190,
"recorded_total": 164,
"missed": 3,
"escalated": 1
},
"safety": {
"events_total": 6,
"active_events": 1
},
"orion": {
"assessments_total": 41,
"by_risk_level": {
"low": 30,
"medium": 9,
"high": 2,
"critical": 0
}
},
"passengers": {
"participation_total": 512,
"active_total": 38
}
},
"prior_window": {
"organization_id": "9f8e7d6c-4444-4ddd-8eee-5f6a7b8c9d0e",
"journeys_total": 41,
"by_state": {
"draft": 1,
"planned": 7,
"active": 3,
"completed": 28,
"cancelled": 2
},
"checkpoints": {
"planned_total": 160,
"recorded_total": 141,
"missed": 4,
"escalated": 2
},
"safety": {
"events_total": 6,
"active_events": 0
},
"orion": {
"assessments_total": 35,
"by_risk_level": {
"low": 26,
"medium": 7,
"high": 2,
"critical": 0
}
},
"passengers": {
"participation_total": 448,
"active_total": 30
}
},
"anomalies": []
}
}
Errors
| Code | HTTP | Cause |
|---|
| INVALID_REQUEST | 400 | days is present but is not an integer. |
| CAPABILITY_NOT_AUTHORIZED | 403 | The API key lacks the intelligence:read scope, the capability is disabled, or the organization is not linked to an ORN platform account. |