API reference · Accounts & ledger

Transaction Approvals

GET/transaction/approval/{approvalReference}Fetch a pending transaction approval
POST/transaction/approval/{approvalReference}/approveApprove a pending transaction at its current level
POST/transaction/approval/{approvalReference}/rejectReject a pending transaction at its current level
GET/transaction/approvalsList pending transaction approvals awaiting the session user's decision

GET Fetch a pending transaction approval

GET /transaction/approval/{approvalReference}

Full detail, including the level-by-level decision history.

Headers

Name	Notes
`Authorization`	Bearer token
`X-Tenant`	Your tenant
`X-Environment`	test or live

Path parameters

Name
`approvalReference`

Example

Response: PendingTransactionApprovalResponse

curl -X GET "https://api.bridgemoni.com/transaction/approval/b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e" \
  -H "Authorization: Bearer $BRIDGEMONI_TOKEN" \
  -H "X-Tenant: $BRIDGEMONI_TENANT" \
  -H "X-Environment: $BRIDGEMONI_ENV"

{
  "data": {
    "reference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
    "accountReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
    "operation": "DEPOSIT",
    "transactionType": "DEPOSIT",
    "amount": 250000.0,
    "currencyCode": "NGN",
    "narrative": "March payroll",
    "status": "AWAITING_APPROVAL",
    "totalLevelsRequired": 1,
    "currentLevelNumber": 1,
    "currentApproverUserReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
    "submittedByUserReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
    "creationDateTime": "2027-03-14T14:30:01",
    "executedTransactionReference": "financial transaction reference",
    "failureReason": "March payroll",
    "decisions": [
      {
        "levelNumber": 1,
        "approverUserReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
        "decision": "APPROVED",
        "decidedDateTime": "2027-03-14T14:30:01",
        "comment": "text"
      }
    ]
  },
  "description": "Fetch a pending transaction approval"
}

Responses

Status	When
`200`	Pending approval fetched successfully
`404`	No pending approval exists for the given reference

POST Approve a pending transaction at its current level

POST /transaction/approval/{approvalReference}/approve

Records the session user's approval. If they are the last required level, the original transaction is posted immediately as part of this call.

Headers

Name	Notes
`Authorization`	Bearer token
`X-Tenant`	Your tenant
`X-Environment`	test or live

Path parameters

Name
`approvalReference`

Example

Response: PendingTransactionApprovalResponse

curl -X POST "https://api.bridgemoni.com/transaction/approval/b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e/approve" \
  -H "Authorization: Bearer $BRIDGEMONI_TOKEN" \
  -H "X-Tenant: $BRIDGEMONI_TENANT" \
  -H "X-Environment: $BRIDGEMONI_ENV"

{
  "data": {
    "reference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
    "accountReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
    "operation": "DEPOSIT",
    "transactionType": "DEPOSIT",
    "amount": 250000.0,
    "currencyCode": "NGN",
    "narrative": "March payroll",
    "status": "AWAITING_APPROVAL",
    "totalLevelsRequired": 1,
    "currentLevelNumber": 1,
    "currentApproverUserReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
    "submittedByUserReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
    "creationDateTime": "2027-03-14T14:30:01",
    "executedTransactionReference": "financial transaction reference",
    "failureReason": "March payroll",
    "decisions": [
      {
        "levelNumber": 1,
        "approverUserReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
        "decision": "APPROVED",
        "decidedDateTime": "2027-03-14T14:30:01",
        "comment": "text"
      }
    ]
  },
  "description": "Approve a pending transaction at its current level"
}

Responses

Status	When
`200`	Approval recorded successfully
`403`	The session user is not the designated approver for the current level
`409`	This request is no longer awaiting approval

POST Reject a pending transaction at its current level

POST /transaction/approval/{approvalReference}/reject

Terminal - the request cannot be re-submitted or approved after this.

Headers

Name	Notes
`Authorization`	Bearer token
`X-Tenant`	Your tenant
`X-Environment`	test or live
`Content-Type`	application/json

Path parameters

Name
`approvalReference`

Example

Response: PendingTransactionApprovalResponse

curl -X POST "https://api.bridgemoni.com/transaction/approval/b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e/reject" \
  -H "Authorization: Bearer $BRIDGEMONI_TOKEN" \
  -H "X-Tenant: $BRIDGEMONI_TENANT" \
  -H "X-Environment: $BRIDGEMONI_ENV"

{
  "data": {
    "reference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
    "accountReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
    "operation": "DEPOSIT",
    "transactionType": "DEPOSIT",
    "amount": 250000.0,
    "currencyCode": "NGN",
    "narrative": "March payroll",
    "status": "AWAITING_APPROVAL",
    "totalLevelsRequired": 1,
    "currentLevelNumber": 1,
    "currentApproverUserReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
    "submittedByUserReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
    "creationDateTime": "2027-03-14T14:30:01",
    "executedTransactionReference": "financial transaction reference",
    "failureReason": "March payroll",
    "decisions": [
      {
        "levelNumber": 1,
        "approverUserReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
        "decision": "APPROVED",
        "decidedDateTime": "2027-03-14T14:30:01",
        "comment": "text"
      }
    ]
  },
  "description": "Reject a pending transaction at its current level"
}

Responses

Status	When
`200`	Rejection recorded successfully
`403`	The session user is not the designated approver for the current level
`409`	This request is no longer awaiting approval

GET List pending transaction approvals awaiting the session user's decision

GET /transaction/approvals

Scoped entirely to the session user - only requests where they are the current level's designated approver are returned.

Headers

Name	Notes
`Authorization`	Bearer token
`X-Tenant`	Your tenant
`X-Environment`	test or live

Query parameters

Name	Default
`page`	0
`size`	20

Example

Response: Pager<PendingTransactionApprovalResponse>

curl -X GET "https://api.bridgemoni.com/transaction/approvals?page=0&size=20" \
  -H "Authorization: Bearer $BRIDGEMONI_TOKEN" \
  -H "X-Tenant: $BRIDGEMONI_TENANT" \
  -H "X-Environment: $BRIDGEMONI_ENV"

{
  "data": {
    "page": 0,
    "size": 20,
    "totalElements": 128,
    "totalPages": 7
  },
  "description": "List pending transaction approvals awaiting the session user's decision"
}

Responses

Status	When
`200`	Pending approvals fetched successfully

Generated from the OpenAPI document. Branch on the HTTP status: there is no machine-readable error code on the wire. Errors