API reference · Moving money
Disbursements JSON or CSV runs, every line validated, maker-checker approval with PIN. About bulk payouts Next
GET List a disburser's batches GET /disbursement/batch
Newest first.
Headers Name Notes AuthorizationBearer token X-TenantYour tenant X-Environmenttest or live
Query parameters Name Default disburserReferenceOptional statusOptional page0 size20
Example Response: GenericResponseBatchPageResponse
curl Response
Copy curl -X GET "https://api.bridgemoni.com/disbursement/batch?disburserReference=value&page=value&size=20" \
-H "Authorization: Bearer $BRIDGEMONI_TOKEN" \
-H "X-Tenant: $BRIDGEMONI_TENANT" \
-H "X-Environment: $BRIDGEMONI_ENV" Copy {
"data": {
"content": [
{
"batchReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
"batchName": "string",
"status": "string",
"itemCount": 0,
"totalDebit": {
"value": "string",
"currency": "string"
},
"makerReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
"checkerReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
"items": [
{
"clientReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
"transferReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
"status": "string",
"sendAmount": {
"value": "string",
"currency": "string"
},
"receiveAmount": {
"value": "string",
"currency": "string"
},
"error": "string"
}
],
"createdAt": "2026-09-25T10:00:00Z"
}
],
"page": 0,
"size": 0,
"totalElements": 0
},
"description": "OK"
} Responses POST Submit a batch POST /disbursement/batch
Up to 1,000 lines inline. Validation runs asynchronously; poll the batch until it is VALIDATED. Replaying the same Idempotency-Key returns the first batch.
Headers Name Notes AuthorizationBearer token X-TenantYour tenant X-Environmenttest or live Idempotency-KeyReuse the same value on every retry of this request Content-Typeapplication/json
Example Request body: BatchRequest · Response: GenericResponseBatchResponse
curl Request Response
Copy curl -X POST "https://api.bridgemoni.com/disbursement/batch" \
-H "Authorization: Bearer $BRIDGEMONI_TOKEN" \
-H "X-Tenant: $BRIDGEMONI_TENANT" \
-H "X-Environment: $BRIDGEMONI_ENV" \
-H "Idempotency-Key: $(uuidgen)" \
-H "Content-Type: application/json" \
-d '{
"batchName": "string",
"fundingAccountNumber": "string",
"items": [
{
"clientReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
"corridor": {
"sendCountry": "string",
"sendCurrency": "string",
"receiveCountry": "string",
"receiveCurrency": "string",
"deliveryMethod": "BRIDGE_WALLET"
},
"amountType": "SEND_AMOUNT",
"amount": "string",
"recipient": {
"type": "PERSON",
"firstName": "Ada",
"lastName": "Okafor",
"organisationName": "string",
"dateOfBirth": "1990-01-01",
"placeOfBirth": {
"city": "string",
"country": "string"
},
"nationality": "string",
"address": {
"streetName": "string",
"buildingNumber": "string",
"postCode": "string",
"townName": "string",
"countrySubDivision": "string",
"country": "string"
},
"identification": {
"type": "string",
"number": "string",
"issuingCountry": "string"
},
"account": {
"scheme": "IBAN",
"iban": "string",
"sortCode": "string",
"accountNumber": "string",
"bankCode": "string",
"bic": "string",
"msisdn": "+2348000000000",
"walletId": "string"
},
"msisdn": "+2348000000000",
"relationship": "string"
},
"ultimateSender": {
"type": "PERSON",
"firstName": "Ada",
"lastName": "Okafor",
"organisationName": "string",
"dateOfBirth": "1990-01-01",
"placeOfBirth": {
"city": "string",
"country": "string"
},
"nationality": "string",
"address": {
"streetName": "string",
"buildingNumber": "string",
"postCode": "string",
"townName": "string",
"countrySubDivision": "string",
"country": "string"
},
"identification": {
"type": "string",
"number": "string",
"issuingCountry": "string"
},
"account": {
"scheme": "IBAN",
"iban": "string",
"sortCode": "string",
"accountNumber": "string",
"bankCode": "string",
"bic": "string",
"msisdn": "+2348000000000",
"walletId": "string"
},
"msisdn": "+2348000000000",
"relationship": "string"
},
"purpose": "string",
"sourceOfFunds": "string",
"narrative": "string"
}
]
}' Copy {
"batchName": "string",
"fundingAccountNumber": "string",
"items": [
{
"clientReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
"corridor": {
"sendCountry": "string",
"sendCurrency": "string",
"receiveCountry": "string",
"receiveCurrency": "string",
"deliveryMethod": "BRIDGE_WALLET"
},
"amountType": "SEND_AMOUNT",
"amount": "string",
"recipient": {
"type": "PERSON",
"firstName": "Ada",
"lastName": "Okafor",
"organisationName": "string",
"dateOfBirth": "1990-01-01",
"placeOfBirth": {
"city": "string",
"country": "string"
},
"nationality": "string",
"address": {
"streetName": "string",
"buildingNumber": "string",
"postCode": "string",
"townName": "string",
"countrySubDivision": "string",
"country": "string"
},
"identification": {
"type": "string",
"number": "string",
"issuingCountry": "string"
},
"account": {
"scheme": "IBAN",
"iban": "string",
"sortCode": "string",
"accountNumber": "string",
"bankCode": "string",
"bic": "string",
"msisdn": "+2348000000000",
"walletId": "string"
},
"msisdn": "+2348000000000",
"relationship": "string"
},
"ultimateSender": {
"type": "PERSON",
"firstName": "Ada",
"lastName": "Okafor",
"organisationName": "string",
"dateOfBirth": "1990-01-01",
"placeOfBirth": {
"city": "string",
"country": "string"
},
"nationality": "string",
"address": {
"streetName": "string",
"buildingNumber": "string",
"postCode": "string",
"townName": "string",
"countrySubDivision": "string",
"country": "string"
},
"identification": {
"type": "string",
"number": "string",
"issuingCountry": "string"
},
"account": {
"scheme": "IBAN",
"iban": "string",
"sortCode": "string",
"accountNumber": "string",
"bankCode": "string",
"bic": "string",
"msisdn": "+2348000000000",
"walletId": "string"
},
"msisdn": "+2348000000000",
"relationship": "string"
},
"purpose": "string",
"sourceOfFunds": "string",
"narrative": "string"
}
]
} Copy {
"data": {
"batchReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
"batchName": "string",
"status": "string",
"itemCount": 0,
"totalDebit": {
"value": "string",
"currency": "string"
},
"makerReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
"checkerReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
"items": [
{
"clientReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
"transferReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
"status": "string",
"sendAmount": {
"value": "string",
"currency": "string"
},
"receiveAmount": {
"value": "string",
"currency": "string"
},
"error": "string"
}
],
"createdAt": "2026-09-25T10:00:00Z"
},
"description": "OK"
} Responses POST Submit a batch as a CSV file POST /disbursement/batch/upload
UTF-8 CSV up to 25 MB and 100,000 lines with the header client_reference, rail, recipient_name, recipient_phone, recipient_email, account_number, provider_code, country_code, beneficiary_reference, amount, narration. Validation runs asynchronously.
Headers Name Notes AuthorizationBearer token X-TenantYour tenant X-Environmenttest or live Idempotency-KeyReuse the same value on every retry of this request Content-Typemultipart/form-data
Query parameters Name Default disburserReferenceOptional titleOptional currencyCodeOptional scheduledForOptional
Example Request body: object · Response: GenericResponseBatchResponse
curl Response
Copy curl -X POST "https://api.bridgemoni.com/disbursement/batch/upload?disburserReference=value&title=value¤cyCode=value" \
-H "Authorization: Bearer $BRIDGEMONI_TOKEN" \
-H "X-Tenant: $BRIDGEMONI_TENANT" \
-H "X-Environment: $BRIDGEMONI_ENV" \
-H "Idempotency-Key: $(uuidgen)" \
-F "file=@./document.pdf" Copy {
"data": {
"batchReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
"batchName": "string",
"status": "string",
"itemCount": 0,
"totalDebit": {
"value": "string",
"currency": "string"
},
"makerReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
"checkerReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
"items": [
{
"clientReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
"transferReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
"status": "string",
"sendAmount": {
"value": "string",
"currency": "string"
},
"receiveAmount": {
"value": "string",
"currency": "string"
},
"error": "string"
}
],
"createdAt": "2026-09-25T10:00:00Z"
},
"description": "OK"
} Responses GET Read a batch GET /disbursement/batch/{reference}
Totals count only lines that can be paid. The content digest is what an approver signs.
Headers Name Notes AuthorizationBearer token X-TenantYour tenant X-Environmenttest or live
Path parameters Example Response: GenericResponseBatchResponse
curl Response
Copy curl -X GET "https://api.bridgemoni.com/disbursement/batch/b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e" \
-H "Authorization: Bearer $BRIDGEMONI_TOKEN" \
-H "X-Tenant: $BRIDGEMONI_TENANT" \
-H "X-Environment: $BRIDGEMONI_ENV" Copy {
"data": {
"batchReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
"batchName": "string",
"status": "string",
"itemCount": 0,
"totalDebit": {
"value": "string",
"currency": "string"
},
"makerReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
"checkerReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
"items": [
{
"clientReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
"transferReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
"status": "string",
"sendAmount": {
"value": "string",
"currency": "string"
},
"receiveAmount": {
"value": "string",
"currency": "string"
},
"error": "string"
}
],
"createdAt": "2026-09-25T10:00:00Z"
},
"description": "OK"
} Responses POST Cancel a batch POST /disbursement/batch/{reference}/cancel
Before funding nothing moves. After funding, every line not yet paid is cancelled and refunded; lines already sent to a bank are left to finish.
Headers Name Notes AuthorizationBearer token X-TenantYour tenant X-Environmenttest or live
Path parameters Example Response: GenericResponseBatchResponse
curl Response
Copy curl -X POST "https://api.bridgemoni.com/disbursement/batch/b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e/cancel" \
-H "Authorization: Bearer $BRIDGEMONI_TOKEN" \
-H "X-Tenant: $BRIDGEMONI_TENANT" \
-H "X-Environment: $BRIDGEMONI_ENV" Copy {
"data": {
"batchReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
"batchName": "string",
"status": "string",
"itemCount": 0,
"totalDebit": {
"value": "string",
"currency": "string"
},
"makerReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
"checkerReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
"items": [
{
"clientReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
"transferReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
"status": "string",
"sendAmount": {
"value": "string",
"currency": "string"
},
"receiveAmount": {
"value": "string",
"currency": "string"
},
"error": "string"
}
],
"createdAt": "2026-09-25T10:00:00Z"
},
"description": "OK"
} Responses GET List a batch's lines GET /disbursement/batch/{reference}/item
Every line carries every finding at once, with the supplied and resolved names side by side.
Headers Name Notes AuthorizationBearer token X-TenantYour tenant X-Environmenttest or live
Path parameters Query parameters Name Default statusOptional page0 size100
Example Response: GenericResponseItemPageResponse
curl Response
Copy curl -X GET "https://api.bridgemoni.com/disbursement/batch/b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e/item?page=value&size=100" \
-H "Authorization: Bearer $BRIDGEMONI_TOKEN" \
-H "X-Tenant: $BRIDGEMONI_TENANT" \
-H "X-Environment: $BRIDGEMONI_ENV" Copy {
"data": {
"content": [
{
"reference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
"batchReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
"lineNumber": 0,
"clientReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
"rail": "WALLET",
"status": "PENDING",
"amount": {
"amount": "10000.00",
"currencyCode": "NGN"
},
"fee": {
"amount": "10000.00",
"currencyCode": "NGN"
},
"destination": {
"accountNumberMasked": "string",
"providerCode": "string",
"providerName": "string",
"countryCode": "string"
},
"recipientNameSupplied": "string",
"resolvedAccountName": "string",
"nameMatch": {
"band": "EXACT",
"score": 0
},
"findings": [
{
"code": "AMOUNT_NOT_POSITIVE",
"severity": "INFO",
"message": "string"
}
],
"worstSeverity": "INFO",
"reviewDecision": "ACCEPT",
"reviewReason": "string",
"failureCode": "ACCOUNT_NOT_FOUND",
"failureDescription": "string",
"providerReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
"attemptCount": 0,
"postedAt": "2026-09-25T10:00:00Z",
"dispatchedAt": "2026-09-25T10:00:00Z",
"settledAt": "2026-09-25T10:00:00Z",
"refundedAt": "2026-09-25T10:00:00Z",
"returnedAt": "2026-09-25T10:00:00Z"
}
],
"page": 0,
"size": 0,
"totalElements": 0
},
"description": "OK"
} Responses POST Accept or exclude a flagged line POST /disbursement/batch/{reference}/item/{itemReference}/review
Accepting needs a reason, which is recorded with who decided. A line is never edited after validation; fix it and upload again.
Headers Name Notes AuthorizationBearer token X-TenantYour tenant X-Environmenttest or live Content-Typeapplication/json
Path parameters Name referenceitemReference
Example Request body: ReviewRequest · Response: GenericResponseItemResponse
curl Request Response
Copy curl -X POST "https://api.bridgemoni.com/disbursement/batch/b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e/item/b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e/review" \
-H "Authorization: Bearer $BRIDGEMONI_TOKEN" \
-H "X-Tenant: $BRIDGEMONI_TENANT" \
-H "X-Environment: $BRIDGEMONI_ENV" \
-H "Content-Type: application/json" \
-d '{
"target": "PROPERTY",
"rating": 4,
"body": "Repairs were handled within a week"
}' Copy {
"target": "PROPERTY",
"rating": 4,
"body": "Repairs were handled within a week"
} Copy {
"data": {
"reference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
"batchReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
"lineNumber": 0,
"clientReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
"rail": "WALLET",
"status": "PENDING",
"amount": {
"amount": "10000.00",
"currencyCode": "NGN"
},
"fee": {
"amount": "10000.00",
"currencyCode": "NGN"
},
"destination": {
"accountNumberMasked": "string",
"providerCode": "string",
"providerName": "string",
"countryCode": "string"
},
"recipientNameSupplied": "string",
"resolvedAccountName": "string",
"nameMatch": {
"band": "EXACT",
"score": 0
},
"findings": [
{
"code": "AMOUNT_NOT_POSITIVE",
"severity": "INFO",
"message": "string"
}
],
"worstSeverity": "INFO",
"reviewDecision": "ACCEPT",
"reviewReason": "string",
"failureCode": "ACCOUNT_NOT_FOUND",
"failureDescription": "string",
"providerReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
"attemptCount": 0,
"postedAt": "2026-09-25T10:00:00Z",
"dispatchedAt": "2026-09-25T10:00:00Z",
"settledAt": "2026-09-25T10:00:00Z",
"refundedAt": "2026-09-25T10:00:00Z",
"returnedAt": "2026-09-25T10:00:00Z"
},
"description": "OK"
} Responses POST Pause an executing batch POST /disbursement/batch/{reference}/pause
Headers Name Notes AuthorizationBearer token X-TenantYour tenant X-Environmenttest or live
Path parameters Example Response: GenericResponseBatchResponse
curl Response
Copy curl -X POST "https://api.bridgemoni.com/disbursement/batch/b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e/pause" \
-H "Authorization: Bearer $BRIDGEMONI_TOKEN" \
-H "X-Tenant: $BRIDGEMONI_TENANT" \
-H "X-Environment: $BRIDGEMONI_ENV" Copy {
"data": {
"batchReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
"batchName": "string",
"status": "string",
"itemCount": 0,
"totalDebit": {
"value": "string",
"currency": "string"
},
"makerReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
"checkerReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
"items": [
{
"clientReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
"transferReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
"status": "string",
"sendAmount": {
"value": "string",
"currency": "string"
},
"receiveAmount": {
"value": "string",
"currency": "string"
},
"error": "string"
}
],
"createdAt": "2026-09-25T10:00:00Z"
},
"description": "OK"
} Responses GET Download the batch report GET /disbursement/batch/{reference}/report
One CSV row per line with its final status, provider reference and failure reason. Account numbers are masked.
Headers Name Notes AuthorizationBearer token X-TenantYour tenant X-Environmenttest or live
Path parameters Example Response: string
curl Response
Copy curl -X GET "https://api.bridgemoni.com/disbursement/batch/b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e/report" \
-H "Authorization: Bearer $BRIDGEMONI_TOKEN" \
-H "X-Tenant: $BRIDGEMONI_TENANT" \
-H "X-Environment: $BRIDGEMONI_ENV" Responses POST Resume a paused batch POST /disbursement/batch/{reference}/resume
Headers Name Notes AuthorizationBearer token X-TenantYour tenant X-Environmenttest or live
Path parameters Example Response: GenericResponseBatchResponse
curl Response
Copy curl -X POST "https://api.bridgemoni.com/disbursement/batch/b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e/resume" \
-H "Authorization: Bearer $BRIDGEMONI_TOKEN" \
-H "X-Tenant: $BRIDGEMONI_TENANT" \
-H "X-Environment: $BRIDGEMONI_ENV" Copy {
"data": {
"batchReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
"batchName": "string",
"status": "string",
"itemCount": 0,
"totalDebit": {
"value": "string",
"currency": "string"
},
"makerReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
"checkerReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
"items": [
{
"clientReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
"transferReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
"status": "string",
"sendAmount": {
"value": "string",
"currency": "string"
},
"receiveAmount": {
"value": "string",
"currency": "string"
},
"error": "string"
}
],
"createdAt": "2026-09-25T10:00:00Z"
},
"description": "OK"
} Responses POST Revalidate a batch POST /disbursement/batch/{reference}/revalidate
Re-runs every check on every payable line, for example after a stale name enquiry.
Headers Name Notes AuthorizationBearer token X-TenantYour tenant X-Environmenttest or live
Path parameters Example Response: GenericResponseBatchResponse
curl Response
Copy curl -X POST "https://api.bridgemoni.com/disbursement/batch/b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e/revalidate" \
-H "Authorization: Bearer $BRIDGEMONI_TOKEN" \
-H "X-Tenant: $BRIDGEMONI_TENANT" \
-H "X-Environment: $BRIDGEMONI_ENV" Copy {
"data": {
"batchReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
"batchName": "string",
"status": "string",
"itemCount": 0,
"totalDebit": {
"value": "string",
"currency": "string"
},
"makerReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
"checkerReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
"items": [
{
"clientReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
"transferReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
"status": "string",
"sendAmount": {
"value": "string",
"currency": "string"
},
"receiveAmount": {
"value": "string",
"currency": "string"
},
"error": "string"
}
],
"createdAt": "2026-09-25T10:00:00Z"
},
"description": "OK"
} Responses POST Send a batch for approval POST /disbursement/batch/{reference}/submit
Refused while a line still needs a review decision or a batch-level limit blocks it.
Headers Name Notes AuthorizationBearer token X-TenantYour tenant X-Environmenttest or live
Path parameters Example Response: GenericResponseBatchResponse
curl Response
Copy curl -X POST "https://api.bridgemoni.com/disbursement/batch/b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e/submit" \
-H "Authorization: Bearer $BRIDGEMONI_TOKEN" \
-H "X-Tenant: $BRIDGEMONI_TENANT" \
-H "X-Environment: $BRIDGEMONI_ENV" Copy {
"data": {
"batchReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
"batchName": "string",
"status": "string",
"itemCount": 0,
"totalDebit": {
"value": "string",
"currency": "string"
},
"makerReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
"checkerReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
"items": [
{
"clientReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
"transferReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
"status": "string",
"sendAmount": {
"value": "string",
"currency": "string"
},
"receiveAmount": {
"value": "string",
"currency": "string"
},
"error": "string"
}
],
"createdAt": "2026-09-25T10:00:00Z"
},
"description": "OK"
} Responses POST Claim payments held for you POST /disbursement/claim
Pays every unclaimed disbursement held for the verified phone number on your profile into your wallet in that currency.
Headers Name Notes AuthorizationBearer token X-TenantYour tenant X-Environmenttest or live
Example Response: GenericResponseListItemResponse
curl Response
Copy curl -X POST "https://api.bridgemoni.com/disbursement/claim" \
-H "Authorization: Bearer $BRIDGEMONI_TOKEN" \
-H "X-Tenant: $BRIDGEMONI_TENANT" \
-H "X-Environment: $BRIDGEMONI_ENV" Copy {
"data": [
{
"reference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
"batchReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
"lineNumber": 0,
"clientReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
"rail": "WALLET",
"status": "PENDING",
"amount": {
"amount": "10000.00",
"currencyCode": "NGN"
},
"fee": {
"amount": "10000.00",
"currencyCode": "NGN"
},
"destination": {
"accountNumberMasked": "string",
"providerCode": "string",
"providerName": "string",
"countryCode": "string"
},
"recipientNameSupplied": "string",
"resolvedAccountName": "string",
"nameMatch": {
"band": "EXACT",
"score": 0
},
"findings": [
{
"code": "AMOUNT_NOT_POSITIVE",
"severity": "INFO",
"message": "string"
}
],
"worstSeverity": "INFO",
"reviewDecision": "ACCEPT",
"reviewReason": "string",
"failureCode": "ACCOUNT_NOT_FOUND",
"failureDescription": "string",
"providerReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
"attemptCount": 0,
"postedAt": "2026-09-25T10:00:00Z",
"dispatchedAt": "2026-09-25T10:00:00Z",
"settledAt": "2026-09-25T10:00:00Z",
"refundedAt": "2026-09-25T10:00:00Z",
"returnedAt": "2026-09-25T10:00:00Z"
}
],
"description": "OK"
} Responses GET List disbursers GET /disbursement/disburser
Newest first. Page size is capped at 100.
Headers Name Notes AuthorizationBearer token X-TenantYour tenant X-Environmenttest or live
Query parameters Example Response: GenericResponseListDisburserResponse
curl Response
Copy curl -X GET "https://api.bridgemoni.com/disbursement/disburser?page=value&size=20" \
-H "Authorization: Bearer $BRIDGEMONI_TOKEN" \
-H "X-Tenant: $BRIDGEMONI_TENANT" \
-H "X-Environment: $BRIDGEMONI_ENV" Copy {
"data": [
{
"reference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
"ownerUserReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
"ownerOrganizationReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
"displayName": "string",
"status": "ACTIVE",
"allowedRails": [
"WALLET"
],
"feeBearer": "DISBURSER",
"perItemMaximum": 0,
"perBatchMaximum": 0,
"perBatchItemMaximum": 0,
"dailyMaximum": 0,
"duplicateWindowDays": 0,
"nameMatchPolicy": "BLOCK",
"approvalWindowHours": 0,
"fundingWindowHours": 0,
"straightThroughEnabled": true,
"straightThroughMaximum": 0,
"straightThroughChangedBy": "string",
"straightThroughChangedAt": "2026-09-25T10:00:00Z",
"origin": "TENANT",
"originModule": "string",
"fundingAccounts": [
{
"currencyCode": "string",
"fundingAccountNumber": "string",
"clearingAccountNumber": "string"
}
],
"creationDateTime": "2026-09-25T10:00:00Z"
}
],
"description": "OK"
} Responses GET Read a disburser GET /disbursement/disburser/{reference}
Carries every currency the disburser is funded in, with its funding and clearing accounts.
Headers Name Notes AuthorizationBearer token X-TenantYour tenant X-Environmenttest or live
Path parameters Example Response: GenericResponseDisburserResponse
curl Response
Copy curl -X GET "https://api.bridgemoni.com/disbursement/disburser/b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e" \
-H "Authorization: Bearer $BRIDGEMONI_TOKEN" \
-H "X-Tenant: $BRIDGEMONI_TENANT" \
-H "X-Environment: $BRIDGEMONI_ENV" Copy {
"data": {
"reference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
"ownerUserReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
"ownerOrganizationReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
"displayName": "string",
"status": "ACTIVE",
"allowedRails": [
"WALLET"
],
"feeBearer": "DISBURSER",
"perItemMaximum": 0,
"perBatchMaximum": 0,
"perBatchItemMaximum": 0,
"dailyMaximum": 0,
"duplicateWindowDays": 0,
"nameMatchPolicy": "BLOCK",
"approvalWindowHours": 0,
"fundingWindowHours": 0,
"straightThroughEnabled": true,
"straightThroughMaximum": 0,
"straightThroughChangedBy": "string",
"straightThroughChangedAt": "2026-09-25T10:00:00Z",
"origin": "TENANT",
"originModule": "string",
"fundingAccounts": [
{
"currencyCode": "string",
"fundingAccountNumber": "string",
"clearingAccountNumber": "string"
}
],
"creationDateTime": "2026-09-25T10:00:00Z"
},
"description": "OK"
} Responses GET List operators GET /disbursement/disburser/{reference}/operator
Headers Name Notes AuthorizationBearer token X-TenantYour tenant X-Environmenttest or live
Path parameters Example Response: GenericResponseListOperatorResponse
curl Response
Copy curl -X GET "https://api.bridgemoni.com/disbursement/disburser/b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e/operator" \
-H "Authorization: Bearer $BRIDGEMONI_TOKEN" \
-H "X-Tenant: $BRIDGEMONI_TENANT" \
-H "X-Environment: $BRIDGEMONI_ENV" Copy {
"data": [
{
"reference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
"disburserReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
"userReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
"role": "MAKER",
"status": "ACTIVE",
"creationDateTime": "2026-09-25T10:00:00Z"
}
],
"description": "OK"
} Responses GET List approval tiers GET /disbursement/disburser/{reference}/tier
Headers Name Notes AuthorizationBearer token X-TenantYour tenant X-Environmenttest or live
Path parameters Example Response: GenericResponseListApprovalTierResponse
curl Response
Copy curl -X GET "https://api.bridgemoni.com/disbursement/disburser/b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e/tier" \
-H "Authorization: Bearer $BRIDGEMONI_TOKEN" \
-H "X-Tenant: $BRIDGEMONI_TENANT" \
-H "X-Environment: $BRIDGEMONI_ENV" Copy {
"data": [
{
"reference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
"currencyCode": "string",
"lowerBound": 0,
"upperBound": 0,
"requiredApprovals": 0,
"requiresSenior": true
}
],
"description": "OK"
} Responses GET Read one line GET /disbursement/item/{reference}
Headers Name Notes AuthorizationBearer token X-TenantYour tenant X-Environmenttest or live
Path parameters Example Response: GenericResponseItemResponse
curl Response
Copy curl -X GET "https://api.bridgemoni.com/disbursement/item/b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e" \
-H "Authorization: Bearer $BRIDGEMONI_TOKEN" \
-H "X-Tenant: $BRIDGEMONI_TENANT" \
-H "X-Environment: $BRIDGEMONI_ENV" Copy {
"data": {
"reference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
"batchReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
"lineNumber": 0,
"clientReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
"rail": "WALLET",
"status": "PENDING",
"amount": {
"amount": "10000.00",
"currencyCode": "NGN"
},
"fee": {
"amount": "10000.00",
"currencyCode": "NGN"
},
"destination": {
"accountNumberMasked": "string",
"providerCode": "string",
"providerName": "string",
"countryCode": "string"
},
"recipientNameSupplied": "string",
"resolvedAccountName": "string",
"nameMatch": {
"band": "EXACT",
"score": 0
},
"findings": [
{
"code": "AMOUNT_NOT_POSITIVE",
"severity": "INFO",
"message": "string"
}
],
"worstSeverity": "INFO",
"reviewDecision": "ACCEPT",
"reviewReason": "string",
"failureCode": "ACCOUNT_NOT_FOUND",
"failureDescription": "string",
"providerReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
"attemptCount": 0,
"postedAt": "2026-09-25T10:00:00Z",
"dispatchedAt": "2026-09-25T10:00:00Z",
"settledAt": "2026-09-25T10:00:00Z",
"refundedAt": "2026-09-25T10:00:00Z",
"returnedAt": "2026-09-25T10:00:00Z"
},
"description": "OK"
} Responses GET Read a line's history GET /disbursement/item/{reference}/event
Every transition, what caused it and who.
Headers Name Notes AuthorizationBearer token X-TenantYour tenant X-Environmenttest or live
Path parameters Example Response: GenericResponseListItemEventResponse
curl Response
Copy curl -X GET "https://api.bridgemoni.com/disbursement/item/b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e/event" \
-H "Authorization: Bearer $BRIDGEMONI_TOKEN" \
-H "X-Tenant: $BRIDGEMONI_TENANT" \
-H "X-Environment: $BRIDGEMONI_ENV" Copy {
"data": [
{
"fromStatus": "string",
"toStatus": "string",
"cause": "string",
"actor": "string",
"detail": "string",
"at": "2026-09-25T10:00:00Z"
}
],
"description": "OK"
} Responses POST Reissue a failed or returned line POST /disbursement/item/{reference}/reissue
Creates a new single-line batch under the same client reference with a ~r suffix. It is validated and approved like any other batch.
Headers Name Notes AuthorizationBearer token X-TenantYour tenant X-Environmenttest or live
Path parameters Example Response: GenericResponseBatchResponse
curl Response
Copy curl -X POST "https://api.bridgemoni.com/disbursement/item/b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e/reissue" \
-H "Authorization: Bearer $BRIDGEMONI_TOKEN" \
-H "X-Tenant: $BRIDGEMONI_TENANT" \
-H "X-Environment: $BRIDGEMONI_ENV" Copy {
"data": {
"batchReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
"batchName": "string",
"status": "string",
"itemCount": 0,
"totalDebit": {
"value": "string",
"currency": "string"
},
"makerReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
"checkerReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
"items": [
{
"clientReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
"transferReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
"status": "string",
"sendAmount": {
"value": "string",
"currency": "string"
},
"receiveAmount": {
"value": "string",
"currency": "string"
},
"error": "string"
}
],
"createdAt": "2026-09-25T10:00:00Z"
},
"description": "OK"
} Responses POST Ask the provider about a line now POST /disbursement/item/{reference}/requery
Headers Name Notes AuthorizationBearer token X-TenantYour tenant X-Environmenttest or live
Path parameters Example Response: GenericResponseItemResponse
curl Response
Copy curl -X POST "https://api.bridgemoni.com/disbursement/item/b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e/requery" \
-H "Authorization: Bearer $BRIDGEMONI_TOKEN" \
-H "X-Tenant: $BRIDGEMONI_TENANT" \
-H "X-Environment: $BRIDGEMONI_ENV" Copy {
"data": {
"reference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
"batchReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
"lineNumber": 0,
"clientReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
"rail": "WALLET",
"status": "PENDING",
"amount": {
"amount": "10000.00",
"currencyCode": "NGN"
},
"fee": {
"amount": "10000.00",
"currencyCode": "NGN"
},
"destination": {
"accountNumberMasked": "string",
"providerCode": "string",
"providerName": "string",
"countryCode": "string"
},
"recipientNameSupplied": "string",
"resolvedAccountName": "string",
"nameMatch": {
"band": "EXACT",
"score": 0
},
"findings": [
{
"code": "AMOUNT_NOT_POSITIVE",
"severity": "INFO",
"message": "string"
}
],
"worstSeverity": "INFO",
"reviewDecision": "ACCEPT",
"reviewReason": "string",
"failureCode": "ACCOUNT_NOT_FOUND",
"failureDescription": "string",
"providerReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
"attemptCount": 0,
"postedAt": "2026-09-25T10:00:00Z",
"dispatchedAt": "2026-09-25T10:00:00Z",
"settledAt": "2026-09-25T10:00:00Z",
"refundedAt": "2026-09-25T10:00:00Z",
"returnedAt": "2026-09-25T10:00:00Z"
},
"description": "OK"
} Responses GET List provider lanes GET /disbursement/lane
Shows each lane's circuit state. OPEN means dispatch is paused; lines wait in the queue and are never sent into a provider that is failing.
Headers Name Notes AuthorizationBearer token X-TenantYour tenant X-Environmenttest or live
Example Response: GenericResponseListProviderLaneResponse
curl Response
Copy curl -X GET "https://api.bridgemoni.com/disbursement/lane" \
-H "Authorization: Bearer $BRIDGEMONI_TOKEN" \
-H "X-Tenant: $BRIDGEMONI_TENANT" \
-H "X-Environment: $BRIDGEMONI_ENV" Copy {
"data": [
{
"reference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
"providerCode": "string",
"rail": "WALLET",
"currencyCode": "string",
"capabilities": [
"SYNC_SETTLE"
],
"maxConcurrency": 0,
"state": "CLOSED",
"openedAt": "2026-09-25T10:00:00Z",
"openReason": "string",
"consecutiveFailures": 0,
"returnWindowDays": 0,
"requeryWindowHours": 0,
"referenceIdempotent": true
}
],
"description": "OK"
} Responses GET The operator queue GET /disbursement/review
Lines in manual review, held by fraud policy or screening, and lines the provider has not answered.
Headers Name Notes AuthorizationBearer token X-TenantYour tenant X-Environmenttest or live
Query parameters Example Response: GenericResponseItemPageResponse
curl Response
Copy curl -X GET "https://api.bridgemoni.com/disbursement/review?page=value&size=100" \
-H "Authorization: Bearer $BRIDGEMONI_TOKEN" \
-H "X-Tenant: $BRIDGEMONI_TENANT" \
-H "X-Environment: $BRIDGEMONI_ENV" Copy {
"data": {
"content": [
{
"reference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
"batchReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
"lineNumber": 0,
"clientReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
"rail": "WALLET",
"status": "PENDING",
"amount": {
"amount": "10000.00",
"currencyCode": "NGN"
},
"fee": {
"amount": "10000.00",
"currencyCode": "NGN"
},
"destination": {
"accountNumberMasked": "string",
"providerCode": "string",
"providerName": "string",
"countryCode": "string"
},
"recipientNameSupplied": "string",
"resolvedAccountName": "string",
"nameMatch": {
"band": "EXACT",
"score": 0
},
"findings": [
{
"code": "AMOUNT_NOT_POSITIVE",
"severity": "INFO",
"message": "string"
}
],
"worstSeverity": "INFO",
"reviewDecision": "ACCEPT",
"reviewReason": "string",
"failureCode": "ACCOUNT_NOT_FOUND",
"failureDescription": "string",
"providerReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
"attemptCount": 0,
"postedAt": "2026-09-25T10:00:00Z",
"dispatchedAt": "2026-09-25T10:00:00Z",
"settledAt": "2026-09-25T10:00:00Z",
"refundedAt": "2026-09-25T10:00:00Z",
"returnedAt": "2026-09-25T10:00:00Z"
}
],
"page": 0,
"size": 0,
"totalElements": 0
},
"description": "OK"
} Responses GET List recurring disbursements GET /disbursement/schedule
Headers Name Notes AuthorizationBearer token X-TenantYour tenant X-Environmenttest or live
Query parameters Name Default disburserReferenceOptional
Example Response: GenericResponseListScheduleResponse
curl Response
Copy curl -X GET "https://api.bridgemoni.com/disbursement/schedule?disburserReference=value" \
-H "Authorization: Bearer $BRIDGEMONI_TOKEN" \
-H "X-Tenant: $BRIDGEMONI_TENANT" \
-H "X-Environment: $BRIDGEMONI_ENV" Copy {
"data": [
{
"reference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
"walletReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
"purpose": "DISBURSEMENT",
"allocationMode": "FIXED_PER_BENEFICIARY",
"frequency": "WEEKLY",
"dayOfMonth": 1,
"dayOfWeek": 5,
"totalAmount": {
"amount": "10000.00",
"currencyCode": "NGN"
},
"status": "ACTIVE",
"startAt": "2026-09-25T10:00:00Z",
"nextRunAt": "2026-09-25T10:00:00Z",
"endAt": "2026-09-25T10:00:00Z",
"maxOccurrences": 12,
"occurrenceCount": 3,
"lastRunAt": "2026-09-25T10:00:00Z",
"lastRunOutcome": "PENDING",
"lastFailureReason": "string",
"consecutiveFailureCount": 0,
"lines": [
{
"reference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
"beneficiaryReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
"beneficiaryDisplayName": "Mum",
"amount": {
"amount": "10000.00",
"currencyCode": "NGN"
},
"percentageBps": 5000,
"status": "ACTIVE"
}
],
"creationDateTime": "2026-09-25T10:00:00Z"
}
],
"description": "OK"
} Responses POST Create a recurring disbursement POST /disbursement/schedule
Each occurrence becomes an ordinary batch that is validated and approved. Client references get the occurrence date appended so each run is its own instruction.
Headers Name Notes AuthorizationBearer token X-TenantYour tenant X-Environmenttest or live Content-Typeapplication/json
Example Request body: ScheduleRequest · Response: GenericResponseScheduleResponse
curl Request Response
Copy curl -X POST "https://api.bridgemoni.com/disbursement/schedule" \
-H "Authorization: Bearer $BRIDGEMONI_TOKEN" \
-H "X-Tenant: $BRIDGEMONI_TENANT" \
-H "X-Environment: $BRIDGEMONI_ENV" \
-H "Content-Type: application/json" \
-d '{
"disburserReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
"title": "string",
"currencyCode": "string",
"frequency": "WEEKLY",
"firstRunAt": "2026-09-25T10:00:00Z",
"endsAt": "2026-09-25T10:00:00Z",
"standingMandate": true,
"items": [
{
"clientReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
"corridor": {
"sendCountry": "string",
"sendCurrency": "string",
"receiveCountry": "string",
"receiveCurrency": "string",
"deliveryMethod": "BRIDGE_WALLET"
},
"amountType": "SEND_AMOUNT",
"amount": "string",
"recipient": {
"type": "PERSON",
"firstName": "Ada",
"lastName": "Okafor",
"organisationName": "string",
"dateOfBirth": "1990-01-01",
"placeOfBirth": {
"city": "string",
"country": "string"
},
"nationality": "string",
"address": {
"streetName": "string",
"buildingNumber": "string",
"postCode": "string",
"townName": "string",
"countrySubDivision": "string",
"country": "string"
},
"identification": {
"type": "string",
"number": "string",
"issuingCountry": "string"
},
"account": {
"scheme": "IBAN",
"iban": "string",
"sortCode": "string",
"accountNumber": "string",
"bankCode": "string",
"bic": "string",
"msisdn": "+2348000000000",
"walletId": "string"
},
"msisdn": "+2348000000000",
"relationship": "string"
},
"ultimateSender": {
"type": "PERSON",
"firstName": "Ada",
"lastName": "Okafor",
"organisationName": "string",
"dateOfBirth": "1990-01-01",
"placeOfBirth": {
"city": "string",
"country": "string"
},
"nationality": "string",
"address": {
"streetName": "string",
"buildingNumber": "string",
"postCode": "string",
"townName": "string",
"countrySubDivision": "string",
"country": "string"
},
"identification": {
"type": "string",
"number": "string",
"issuingCountry": "string"
},
"account": {
"scheme": "IBAN",
"iban": "string",
"sortCode": "string",
"accountNumber": "string",
"bankCode": "string",
"bic": "string",
"msisdn": "+2348000000000",
"walletId": "string"
},
"msisdn": "+2348000000000",
"relationship": "string"
},
"purpose": "string",
"sourceOfFunds": "string",
"narrative": "string"
}
]
}' Copy {
"disburserReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
"title": "string",
"currencyCode": "string",
"frequency": "WEEKLY",
"firstRunAt": "2026-09-25T10:00:00Z",
"endsAt": "2026-09-25T10:00:00Z",
"standingMandate": true,
"items": [
{
"clientReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
"corridor": {
"sendCountry": "string",
"sendCurrency": "string",
"receiveCountry": "string",
"receiveCurrency": "string",
"deliveryMethod": "BRIDGE_WALLET"
},
"amountType": "SEND_AMOUNT",
"amount": "string",
"recipient": {
"type": "PERSON",
"firstName": "Ada",
"lastName": "Okafor",
"organisationName": "string",
"dateOfBirth": "1990-01-01",
"placeOfBirth": {
"city": "string",
"country": "string"
},
"nationality": "string",
"address": {
"streetName": "string",
"buildingNumber": "string",
"postCode": "string",
"townName": "string",
"countrySubDivision": "string",
"country": "string"
},
"identification": {
"type": "string",
"number": "string",
"issuingCountry": "string"
},
"account": {
"scheme": "IBAN",
"iban": "string",
"sortCode": "string",
"accountNumber": "string",
"bankCode": "string",
"bic": "string",
"msisdn": "+2348000000000",
"walletId": "string"
},
"msisdn": "+2348000000000",
"relationship": "string"
},
"ultimateSender": {
"type": "PERSON",
"firstName": "Ada",
"lastName": "Okafor",
"organisationName": "string",
"dateOfBirth": "1990-01-01",
"placeOfBirth": {
"city": "string",
"country": "string"
},
"nationality": "string",
"address": {
"streetName": "string",
"buildingNumber": "string",
"postCode": "string",
"townName": "string",
"countrySubDivision": "string",
"country": "string"
},
"identification": {
"type": "string",
"number": "string",
"issuingCountry": "string"
},
"account": {
"scheme": "IBAN",
"iban": "string",
"sortCode": "string",
"accountNumber": "string",
"bankCode": "string",
"bic": "string",
"msisdn": "+2348000000000",
"walletId": "string"
},
"msisdn": "+2348000000000",
"relationship": "string"
},
"purpose": "string",
"sourceOfFunds": "string",
"narrative": "string"
}
]
} Copy {
"data": {
"reference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
"walletReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
"purpose": "DISBURSEMENT",
"allocationMode": "FIXED_PER_BENEFICIARY",
"frequency": "WEEKLY",
"dayOfMonth": 1,
"dayOfWeek": 5,
"totalAmount": {
"amount": "10000.00",
"currencyCode": "NGN"
},
"status": "ACTIVE",
"startAt": "2026-09-25T10:00:00Z",
"nextRunAt": "2026-09-25T10:00:00Z",
"endAt": "2026-09-25T10:00:00Z",
"maxOccurrences": 12,
"occurrenceCount": 3,
"lastRunAt": "2026-09-25T10:00:00Z",
"lastRunOutcome": "PENDING",
"lastFailureReason": "string",
"consecutiveFailureCount": 0,
"lines": [
{
"reference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
"beneficiaryReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
"beneficiaryDisplayName": "Mum",
"amount": {
"amount": "10000.00",
"currencyCode": "NGN"
},
"percentageBps": 5000,
"status": "ACTIVE"
}
],
"creationDateTime": "2026-09-25T10:00:00Z"
},
"description": "OK"
} Responses POST End a recurring disbursement POST /disbursement/schedule/{reference}/end
Headers Name Notes AuthorizationBearer token X-TenantYour tenant X-Environmenttest or live
Path parameters Example Response: GenericResponseScheduleResponse
curl Response
Copy curl -X POST "https://api.bridgemoni.com/disbursement/schedule/b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e/end" \
-H "Authorization: Bearer $BRIDGEMONI_TOKEN" \
-H "X-Tenant: $BRIDGEMONI_TENANT" \
-H "X-Environment: $BRIDGEMONI_ENV" Copy {
"data": {
"reference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
"walletReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
"purpose": "DISBURSEMENT",
"allocationMode": "FIXED_PER_BENEFICIARY",
"frequency": "WEEKLY",
"dayOfMonth": 1,
"dayOfWeek": 5,
"totalAmount": {
"amount": "10000.00",
"currencyCode": "NGN"
},
"status": "ACTIVE",
"startAt": "2026-09-25T10:00:00Z",
"nextRunAt": "2026-09-25T10:00:00Z",
"endAt": "2026-09-25T10:00:00Z",
"maxOccurrences": 12,
"occurrenceCount": 3,
"lastRunAt": "2026-09-25T10:00:00Z",
"lastRunOutcome": "PENDING",
"lastFailureReason": "string",
"consecutiveFailureCount": 0,
"lines": [
{
"reference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
"beneficiaryReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
"beneficiaryDisplayName": "Mum",
"amount": {
"amount": "10000.00",
"currencyCode": "NGN"
},
"percentageBps": 5000,
"status": "ACTIVE"
}
],
"creationDateTime": "2026-09-25T10:00:00Z"
},
"description": "OK"
} Responses POST Pause a recurring disbursement POST /disbursement/schedule/{reference}/pause
Headers Name Notes AuthorizationBearer token X-TenantYour tenant X-Environmenttest or live
Path parameters Example Response: GenericResponseScheduleResponse
curl Response
Copy curl -X POST "https://api.bridgemoni.com/disbursement/schedule/b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e/pause" \
-H "Authorization: Bearer $BRIDGEMONI_TOKEN" \
-H "X-Tenant: $BRIDGEMONI_TENANT" \
-H "X-Environment: $BRIDGEMONI_ENV" Copy {
"data": {
"reference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
"walletReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
"purpose": "DISBURSEMENT",
"allocationMode": "FIXED_PER_BENEFICIARY",
"frequency": "WEEKLY",
"dayOfMonth": 1,
"dayOfWeek": 5,
"totalAmount": {
"amount": "10000.00",
"currencyCode": "NGN"
},
"status": "ACTIVE",
"startAt": "2026-09-25T10:00:00Z",
"nextRunAt": "2026-09-25T10:00:00Z",
"endAt": "2026-09-25T10:00:00Z",
"maxOccurrences": 12,
"occurrenceCount": 3,
"lastRunAt": "2026-09-25T10:00:00Z",
"lastRunOutcome": "PENDING",
"lastFailureReason": "string",
"consecutiveFailureCount": 0,
"lines": [
{
"reference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
"beneficiaryReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
"beneficiaryDisplayName": "Mum",
"amount": {
"amount": "10000.00",
"currencyCode": "NGN"
},
"percentageBps": 5000,
"status": "ACTIVE"
}
],
"creationDateTime": "2026-09-25T10:00:00Z"
},
"description": "OK"
} Responses POST Resume a recurring disbursement POST /disbursement/schedule/{reference}/resume
Headers Name Notes AuthorizationBearer token X-TenantYour tenant X-Environmenttest or live
Path parameters Example Response: GenericResponseScheduleResponse
curl Response
Copy curl -X POST "https://api.bridgemoni.com/disbursement/schedule/b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e/resume" \
-H "Authorization: Bearer $BRIDGEMONI_TOKEN" \
-H "X-Tenant: $BRIDGEMONI_TENANT" \
-H "X-Environment: $BRIDGEMONI_ENV" Copy {
"data": {
"reference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
"walletReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
"purpose": "DISBURSEMENT",
"allocationMode": "FIXED_PER_BENEFICIARY",
"frequency": "WEEKLY",
"dayOfMonth": 1,
"dayOfWeek": 5,
"totalAmount": {
"amount": "10000.00",
"currencyCode": "NGN"
},
"status": "ACTIVE",
"startAt": "2026-09-25T10:00:00Z",
"nextRunAt": "2026-09-25T10:00:00Z",
"endAt": "2026-09-25T10:00:00Z",
"maxOccurrences": 12,
"occurrenceCount": 3,
"lastRunAt": "2026-09-25T10:00:00Z",
"lastRunOutcome": "PENDING",
"lastFailureReason": "string",
"consecutiveFailureCount": 0,
"lines": [
{
"reference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
"beneficiaryReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
"beneficiaryDisplayName": "Mum",
"amount": {
"amount": "10000.00",
"currencyCode": "NGN"
},
"percentageBps": 5000,
"status": "ACTIVE"
}
],
"creationDateTime": "2026-09-25T10:00:00Z"
},
"description": "OK"
} Responses