Bills: Bill Inquiry

Partner use this method to retrieve information of a bill account. This method is limited only to certain billers (Please refer to Appendix 2). By providing the bill account number together with the biller code, GloRemit will return the information such as account name, amount due and other relevant information. However the availability of the information is dependent on the biller’s response.


GET /v1/payments/bills/requests/{transID}?sIdType={sIdType}&sIdNum={sIdNum}&sFirstName={sFirstName}&sLastName={sLastName}&bCountry={bCountry}&bCurrency={bCurrency}&bAmount={bAmount}&bIssuerCode={bIssuerCode}&bAccNum={bAccNum}

Sample Request:

curl -v "
&bIssuerCode=61161&bAccNum=1111" \
-H "AuthorizationGLOREMIT <UID>:<PWD>:<rspSign>"

Request Description

Parameter NameRequiredMin/Max LengthTypeRemark
UIDM5/50AlphanumericUsername for validation.
PWDM5/50AlphanumericPassword for validation, 3DES encrypted.
rspSignM32/50AlphanumericDigital signature of RSP, see Section 4 for more info.
transIDM6/16Alphanumeric6 digits or more unique transaction ID from RSP.
sFirstNameM1/100AlphanumericSender’s first name. (max 100 characters)
sLastNameM1/100AlphanumericSender’s last name. (max 100 characters)
sIdTypeO1/30NumericSender Identification Type.
(Please refer to Section 3 for full list)
sIdNumO8/16AlphanumericSender Identification Number.
bCountryM2/5AlphanumericBill country code.
(Please refer to ISO 3166 Country Code)
Accept ISO 3166-1 Alpha-2 ONLY
bCurrencyM3/6AlphanumericBill Currency Code.
(Please refer to ISO 4217 Currency Code)
bAmountM1/16NumericTotal amount to pay for the bill.
(Please refer to Section 2.7 for exception note)
bIssuerCodeM3/16AlphanumericBiller Issuer Code.
(Please refer to Appendix 2)
bAccNumM1/18AlphanumericBill Account Number or any other unique account identifier as determined by biller.

Response Description

GloRemit server will return a JSON format with response code when RSP request is accepted.

Sample Response:

    "Description":"Transaction Rejected",
Parameter NameRequiredTypeRemark
InquiryStatusMNumericTransaction request status response code.
(Please see Section 3.5 for full records.)
transIDMAlphanumericUnique Transaction ID from RSP.
DescriptionMAlphanumericTransaction description or advice.
AccountNameOAlphanumericThe bill account holder name as returned by account issuer/biller.
StatementDateOAlphanumericBill Statement Date.
Date Format: MM/dd/YYYY
DueDateOAlphanumericBill Statement Due Date.
Date Format: MM/dd/YYYY
AmountOAlphanumericBill Statement Amount in bCurrency.
BillTypeOAlphanumericBill Type.
(Please refer to Appendix 2)
CustomInfo1OAlphanumericBill Custom Information 1.
(Please refer to Appendix 2)
CustomInfo2OAlphanumericBill Custom Information 2.
(Please refer to Appendix 2)
CustomInfo3OAlphanumericBill Custom Information 3.
(Please refer to Appendix 2)
CustomInfo4OAlphanumericBill Custom Information 4.
(Please refer to Appendix 2)
CustomInfo5OAlphanumericBill Custom Information 5.
(Please refer to Appendix 2)
CustomInfo6OAlphanumericBill Custom Information 6.
(Please refer to Appendix 2)
CustomInfo7OAlphanumericBill Custom Information 7.
(Please refer to Appendix 2)
CustomInfo8OAlphanumericBill Custom Information 8.
(Please refer to Appendix 2)
CustomInfo9OAlphanumericBill Custom Information 9.
(Please refer to Appendix 2)
CustomInfo10OAlphanumericBill Custom Information 10.
(Please refer to Appendix 2)

M= Mandatory, C= Conditional, O= Optional