List transactions
List transactions
Overview
List transactions
Returns ledger transactions with filters for status, provider, method, currency, and time range.
When to use this
Use as the primary reconciliation feed for payments, refunds, and payouts visible to your org.
See also
See also payment state machine for status semantics.
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 /transactions
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 |
|---|---|---|---|---|
isPos | query | No | - | Uniquement les transactions points de vente (TPV) |
endDate | query | No | - | Jusqu'à cette date (format ISO 8601) |
startDate | query | No | - | À partir de cette date (format ISO 8601) |
pageSize | query | No | - | Nombre d'éléments par page |
page | query | No | - | Numéro de page |
paymentMethod | query | No | - | Filtrer par code de moyen de paiement (séparés par des virgules pour plusieurs valeurs) |
currency | query | No | - | Filtrer par code devise (séparés par des virgules pour plusieurs valeurs) |
type | query | No | - | Filtrer par type de transaction (séparés par des virgules pour plusieurs valeurs) |
status | query | No | - | Filtrer par statut de transaction (séparés par des virgules pour plusieurs valeurs) |
provider | query | No | - | Filtrer par code de fournisseur de paiement |
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 | Success |
401 | Invalid or missing API key |
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/transactions?isPos=true&endDate=value" \
-H "X-API-KEY: $LOMI_SECRET_KEY"OpenAPI
- operationId:
TransactionsController_findAll - Operation:
GET /transactions
Full schemas and Try it: API reference. Machine-readable contract: repo apps/docs/openapi.json.