List risk assessments
List risk assessments
Overview
List risk assessments
Returns Radar screening results for incoming charges with optional filters for decision, rail, and date range.
When to use this
Use for fraud review queues, exports, and correlating PAYMENT_RISK_* webhook payloads.
See also
Get risk assessment · lomi. Radar guide
Authentication
Merchant routes require an API key in the X-API-KEY header (see Integration overview). Use a test key against https://sandbox.api.lomi.africa and a live key against https://api.lomi.africa.
Endpoint
GET /risk-assessments
Base URLs:
https://sandbox.api.lomi.africahttps://api.lomi.africa
Request
Path parameters
No path parameters beyond the URL pattern.
Query parameters
| Name | In | Required | Schema | Description |
|---|---|---|---|---|
pageSize | query | No | - | |
page | query | No | - | |
endDate | query | No | - | |
startDate | query | No | - | |
rail | query | No | - | |
decision | query | No | - |
Headers
| Name | In | Required | Schema | Description |
|---|---|---|---|---|
Lomi-Account | header | No | - | Optional lomi. Network account id (acct_...). When present, the API key acts as the Operator and the request targets the connected Member Account. |
Responses
| Status | Description |
|---|---|
200 | Risk assessments |
Errors
Errors follow the standard JSON error format (status code and machine-readable message). Validate inputs before calling; 401 indicates a missing/invalid key, 404 a missing resource for this organization, 429 rate limiting. For safe retries on create-style calls, send an idempotency key when your flow supports it.
Example
curl -sS -X GET "https://sandbox.api.lomi.africa/risk-assessments?pageSize=1&page=1" \
-H "X-API-KEY: $LOMI_SECRET_KEY"OpenAPI
- operationId:
RadarController_listAssessments - Operation:
GET /risk-assessments
Full schemas and Try it: API reference. Machine-readable contract: repo apps/docs/openapi.json.