API reference · Platform & integration

ISO 20022 payments

GET/iso20022/message/{reference}/paymentsList the payments one of your messages carried
GET/iso20022/payment/{uetr}Track one of your payments by UETR

GET List the payments one of your messages carried

GET /iso20022/message/{reference}/payments

Headers

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

Path parameters

Name
`reference`

Example

Response: GenericResponseListIsoPaymentTrackerResponse

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

{
  "data": [
    {
      "uetr": "3f6b8c1e-2d4a-4b7f-9e1c-5a8d2f0b7c34",
      "endToEndId": "string",
      "instructionId": "string",
      "paymentInformationId": "string",
      "direction": "string",
      "amount": 0,
      "currencyCode": "string",
      "status": "ACSC",
      "reasonCode": "string",
      "reasonDetail": "string",
      "debtorAccount": "string",
      "creditorAccount": "string",
      "creditorAgent": "string",
      "messageReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
      "bridgeTargetReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
      "bridgeBatchReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
      "history": [
        {
          "status": "ACSP",
          "reasonCode": "AC04",
          "source": "string",
          "applied": true,
          "at": "2026-09-25T10:00:00Z"
        }
      ]
    }
  ],
  "description": "OK"
}

Responses

Status	When
`200`	OK

GET Track one of your payments by UETR

GET /iso20022/payment/{uetr}

The payment's ISO 20022 status, the reason when it was rejected, and every status change in order. A change refused as a regression is listed with applied=false.

Headers

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

Path parameters

Name
`uetr`

Example

Response: GenericResponseIsoPaymentTrackerResponse

curl -X GET "https://api.bridgemoni.com/iso20022/payment/value" \
  -H "Authorization: Bearer $BRIDGEMONI_TOKEN" \
  -H "X-Tenant: $BRIDGEMONI_TENANT" \
  -H "X-Environment: $BRIDGEMONI_ENV"

{
  "data": {
    "uetr": "3f6b8c1e-2d4a-4b7f-9e1c-5a8d2f0b7c34",
    "endToEndId": "string",
    "instructionId": "string",
    "paymentInformationId": "string",
    "direction": "string",
    "amount": 0,
    "currencyCode": "string",
    "status": "ACSC",
    "reasonCode": "string",
    "reasonDetail": "string",
    "debtorAccount": "string",
    "creditorAccount": "string",
    "creditorAgent": "string",
    "messageReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
    "bridgeTargetReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
    "bridgeBatchReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
    "history": [
      {
        "status": "ACSP",
        "reasonCode": "AC04",
        "source": "string",
        "applied": true,
        "at": "2026-09-25T10:00:00Z"
      }
    ]
  },
  "description": "Payment retrieved"
}

Responses

Status	When
`200`	Payment retrieved
`404`	No such payment in your scope

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