Service status
Health of STK, B2C, B2B and wallet services, and a transaction's event timeline.
Overall status, per-component summary and open incidents.
Any valid API key.
Request
curl -X GET "https://swiftwallet.co.ke/v3/service-status" \ -H "Authorization: Bearer $SWIFTWALLET_API_KEY" \ -H "Accept: application/json"
Response fields
success status components_summary.{component}.status components_summary.{component}.failure_rate components_summary.{component}.last_updated active_incidents[] timestamp
Recorded health samples.
Any valid API key.
Parameters
| Field | In | Type | Required | Description |
|---|---|---|---|---|
service_type |
query | string | no |
One component. Omit for all.
One of: stk_push, b2c, b2b, wallet |
hours |
query | integer | no |
Look-back window. Default 24.
Range 1 – 168 |
Request
curl -X GET "https://swiftwallet.co.ke/v3/service-status/history?service_type=…" \ -H "Authorization: Bearer $SWIFTWALLET_API_KEY" \ -H "Accept: application/json"
Response fields
success service_type hours history[].service_type history[].status history[].failure_rate history[].total_requests history[].failed_requests history[].recorded_at
Per-component metrics over the last 15 minutes.
Any valid API key.
Request
curl -X GET "https://swiftwallet.co.ke/v3/service-status/components" \ -H "Authorization: Bearer $SWIFTWALLET_API_KEY" \ -H "Accept: application/json"
Response fields
success window_minutes components
Event timeline of one of your transactions.
Any valid API key.
Parameters
| Field | In | Type | Required | Description |
|---|---|---|---|---|
id |
path | integer | yes |
Your transaction id.
Range 1 – … |
Request
curl -X GET "https://swiftwallet.co.ke/v3/service-status/transaction/{id}" \
-H "Authorization: Bearer $SWIFTWALLET_API_KEY" \
-H "Accept: application/json"Response fields
success transaction_id status timeline[].event timeline[].status timeline[].message timeline[].created_at