Get Top-up Balances
get
/topupBalance
Gets top-up balances that match the query criteria.
Request
Query Parameters
-
fields: string
The list of comma-separated fields to return in the response.Example:
isAutoTopup,paymentMethod
-
limit: integer
The maximum number of results to return. For example, use limit=10 to return the first 10 results only.Example:
10
-
offset: integer
The number of results to offset the response by. For example, use offset=10 to return results 10 and higher.Example:
10
There's no request body for this operation.
Back to TopResponse
Supported Media Types
- application/json;charset=utf-8
200 Response
Success
Headers
-
X-Result-Count:
The number of items returned in the response body.
-
X-Total-Count:
The total number of items that matched the criteria.
Root Schema : schema
Type:
Show Source
array
-
Array of:
object Topup Balance
Title:
Topup Balance
A top-up.
Nested Schema : Topup Balance
Type:
object
Title:
Topup Balance
A top-up.
Show Source
-
@baseType: string
Title:
Base Type
The object's superclass. -
@schemaLocation: string
(uri)
Title:
Schema Location
A URI to a JSON-Schema file that defines additional attributes and relationships. -
@type: string
Title:
Type
The object's subclass. -
amount: object
Quantity
An amount in a given unit.
-
balanceTopup: object
Related Topup Balance
Title:
Related Topup Balance
A relationship between balance top-ups, that defines whether a balance is the parent or child of another. -
bucket: object
Bucket Ref
Title:
Bucket Ref
A reference to a bucket. -
channel: object
Channel Ref
Title:
Channel Ref
A reference to a channel. -
confirmationDate: string
(date-time)
Title:
Confirmation Date
The date the top-up was confirmed. -
description: string
Title:
Description
The top-up's description. -
href: string
Title:
Href
The top-up balance's href. -
id: string
Title:
ID
The top-up balance's ID. -
isAutoTopup: boolean
Title:
Is Auto Topup
Whether the top-up is automatic (true) or not (false). -
logicalResource: array
logicalResource
Logical resources associated with the top-up.
-
numberOfPeriods: integer
Title:
Number of Periods
The number of billing periods for which an automatic top-up occurs. If this property is not specified, then the top-up will continue automatically indefinitely. -
partyAccount: object
Party Account Ref
Title:
Party Account Ref
A reference to a party account. -
paymentMethod: object
Payment Method Ref
Title:
Payment Method Ref
A reference to a payment method. -
product: array
product
Products associated with the top-up.
-
reason: string
Title:
Reason
The reason for the top-up. -
recurringPeriod: string
Title:
Recurring Period Type
Allowed Values:[ "weekly", "fortnightly", "monthly" ]
A type of recurring period. - relatedParty: array relatedParty
-
requestedDate: string
(date-time)
Title:
Requested Date
The date that the top-up request was made. -
requestor: object
Related Party
Title:
Related Party
A party related to another object. -
status(required): string
Title:
Action Status Type
Allowed Values:[ "created", "failed", "cancelled", "completed" ]
The status of an action. -
usageType: string
Title:
Usage Type
Allowed Values:[ "monetary", "voice", "data", "sms", "other" ]
The type of usage. For BRM REST Services Manager, only monetary and other are supported. -
validFor: object
TimePeriod
A period of time.
-
voucher: string
Title:
Voucher
The voucher used for the top-up.
Nested Schema : Quantity
Type:
object
An amount in a given unit.
Show Source
-
amount: number
(float)
Default Value:
1
Numeric value in a given unit. -
units: string
Unit
Nested Schema : Related Topup Balance
Type:
object
Title:
Related Topup Balance
A relationship between balance top-ups, that defines whether a balance is the parent or child of another.
Show Source
-
@baseType: string
Title:
Base Type
The object's superclass. -
@referredType(required): string
Title:
Referred Type
The object's type in the target system, if baseType and type need further disambiguation. -
@schemaLocation: string
(uri)
Title:
Schema Location
A URI to a JSON-Schema file that defines additional attributes and relationships. -
@type: string
Title:
Type
The object's subclass. -
href: string
Title:
Href
The balance's href. -
id(required): string
Title:
ID
The balance's ID. -
name: string
Title:
Name
The balance's name. -
role: string
Title:
Role
The balance's role. For example, parent or child.
Nested Schema : Bucket Ref
Type:
object
Title:
Bucket Ref
A reference to a bucket.
Show Source
-
@baseType: string
Title:
Base Type
The object's superclass. -
@referredType: string
Title:
Referred Type
The object's type in the target system, if baseType and type need further disambiguation. -
@schemaLocation: string
(uri)
Title:
Schema Location
A URI to a JSON-Schema file that defines additional attributes and relationships. -
@type: string
Title:
Type
The object's subclass. -
href: string
Title:
Bucket Href
The bucket's href. -
id(required): string
Title:
Bucket ID
The bucket's ID. -
name: string
Title:
Bucket Name
The bucket's name.
Nested Schema : Channel Ref
Type:
object
Title:
Channel Ref
A reference to a channel.
Show Source
-
@baseType: string
Title:
Base Type
The object's superclass. -
@referredType: string
Title:
Referred Type
The object's type in the target system, if baseType and type need further disambiguation. -
@schemaLocation: string
(uri)
Title:
Schema Location
A URI to a JSON-Schema file that defines additional attributes and relationships. -
@type: string
Title:
Type
The object's subclass. -
href: string
Title:
Channel Href
The channel's href. -
id(required): string
Title:
Channel ID
The channel's ID. -
name: string
Title:
Channel Name
The channel's name.
Nested Schema : logicalResource
Type:
array
Logical resources associated with the top-up.
Show Source
-
Array of:
object Logical Resource Ref
Title:
Logical Resource Ref
A reference to a logical resource.
Nested Schema : Party Account Ref
Type:
object
Title:
Party Account Ref
A reference to a party account.
Show Source
-
@baseType: string
Title:
Base Type
The object's superclass. -
@referredType: string
Title:
Referred Type
The object's type in the target system, if baseType and type need further disambiguation. -
@schemaLocation: string
(uri)
Title:
Schema Location
A URI to a JSON-Schema file that defines additional attributes and relationships. -
@type: string
Title:
Type
The object's subclass. -
description: string
Title:
Description
The party account's description. -
href: string
Title:
Href
The party account's href. -
id(required): string
Title:
Account ID
The party account's ID. -
name: string
Title:
Name
The party account's name. -
status: string
Title:
Status
The overall status of the account. For example, due, paid, or in arrears.
Nested Schema : Payment Method Ref
Type:
object
Title:
Payment Method Ref
A reference to a payment method.
Show Source
-
@baseType: string
Title:
Base Type
The object's superclass. -
@referredType: string
The object's type in the target system, if baseType and type need further disambiguation.
-
@schemaLocation: string
(uri)
Title:
Schema Location
A URI to a JSON-Schema file that defines additional attributes and relationships. -
@type: string
Title:
Type
The object's subclass. -
href: string
Title:
Href
The payment method's href. -
id(required): string
Title:
ID
The payment method's ID. -
name: string
Title:
Name
The payment method's name.
Nested Schema : product
Type:
array
Products associated with the top-up.
Show Source
-
Array of:
object Product Ref
Title:
Product Ref
A reference to a product.
Nested Schema : Related Party
Type:
object
Title:
Related Party
A party related to another object.
Show Source
-
@baseType: string
Title:
Base Type
The object's superclass. -
@referredType(required): string
Title:
Referred Type
The object's type in the target system, if baseType and type need further disambiguation. -
@schemaLocation: string
(uri)
Title:
Schema Location
A URI to a JSON-Schema file that defines additional attributes and relationships. -
@type: string
Title:
Type
The object's subclass. -
href: string
Title:
Href
The party's href. -
id(required): string
Title:
Party ID
The party's ID. -
name: string
Title:
Party Name
The party's name. -
role: string
Title:
Party Role
The party's role.
Nested Schema : TimePeriod
Type:
object
A period of time.
Show Source
-
endDateTime: string
(date-time)
Title:
End Time Period
The end of the time period in IETC-RFC-3339 format. -
startDateTime: string
(date-time)
Title:
Start Time Period
The start of the time period in IETC-RFC-3339 format.
Nested Schema : Logical Resource Ref
Type:
object
Title:
Logical Resource Ref
A reference to a logical resource.
Show Source
-
@baseType: string
Title:
Base Type
The object's superclass. -
@referredType: string
Title:
Referred Type
The object's type in the target system, if baseType and type need further disambiguation. -
@schemaLocation: string
(uri)
Title:
Schema Location
A URI to a JSON-Schema file that defines additional attributes and relationships. -
@type: string
Title:
Type
The object's subclass. -
href: string
Title:
Href
The resource's href. -
id(required): string
Title:
ID
The resource's ID. -
name: string
Title:
Name
The resource's name.
Nested Schema : Product Ref
Type:
object
Title:
Product Ref
A reference to a product.
Show Source
-
@baseType: string
Title:
Base Type
The object's superclass. -
@referredType: string
Title:
Referred Type
The object's type in the target system, if baseType and type need further disambiguation. -
@schemaLocation: string
(uri)
Title:
Schema Location
A URI to a JSON-Schema file that defines additional attributes and relationships. -
@type: string
Title:
Type
The object's subclass. -
href: string
Title:
Product Href
The product's href. -
id(required): string
Title:
Product ID
The product's ID. -
name: string
Title:
Product Name
The product's name.
400 Response
Bad Request
Root Schema : Error
Type:
object
This is used when an API throws an error, typically with a HTTP error response-code (3xx, 4xx, 5xx).
Show Source
-
@baseType: string
This defines the super-class when sub-classing.
-
@schemaLocation: string
(uri)
A URI to a JSON-schema file that defines additional attributes and relationships.
-
@type: string
This defines the sub-class entity name when sub-classing.
-
code(required): string
Refers to application relevant detail, defined in the API or a common list.
-
message: string
More details and corrective actions related to the error which can be shown to a client user.
-
reason(required): string
Explanation of the reason for the error which can be shown to a client user.
-
referenceError: string
(uri)
URI of documentation describing the error.
-
status: string
Displays the HTTP error code extension.
401 Response
Unauthorized
Root Schema : Error
Type:
object
This is used when an API throws an error, typically with a HTTP error response-code (3xx, 4xx, 5xx).
Show Source
-
@baseType: string
This defines the super-class when sub-classing.
-
@schemaLocation: string
(uri)
A URI to a JSON-schema file that defines additional attributes and relationships.
-
@type: string
This defines the sub-class entity name when sub-classing.
-
code(required): string
Refers to application relevant detail, defined in the API or a common list.
-
message: string
More details and corrective actions related to the error which can be shown to a client user.
-
reason(required): string
Explanation of the reason for the error which can be shown to a client user.
-
referenceError: string
(uri)
URI of documentation describing the error.
-
status: string
Displays the HTTP error code extension.
403 Response
Forbidden
Root Schema : Error
Type:
object
This is used when an API throws an error, typically with a HTTP error response-code (3xx, 4xx, 5xx).
Show Source
-
@baseType: string
This defines the super-class when sub-classing.
-
@schemaLocation: string
(uri)
A URI to a JSON-schema file that defines additional attributes and relationships.
-
@type: string
This defines the sub-class entity name when sub-classing.
-
code(required): string
Refers to application relevant detail, defined in the API or a common list.
-
message: string
More details and corrective actions related to the error which can be shown to a client user.
-
reason(required): string
Explanation of the reason for the error which can be shown to a client user.
-
referenceError: string
(uri)
URI of documentation describing the error.
-
status: string
Displays the HTTP error code extension.
404 Response
Not Found
Root Schema : Error
Type:
object
This is used when an API throws an error, typically with a HTTP error response-code (3xx, 4xx, 5xx).
Show Source
-
@baseType: string
This defines the super-class when sub-classing.
-
@schemaLocation: string
(uri)
A URI to a JSON-schema file that defines additional attributes and relationships.
-
@type: string
This defines the sub-class entity name when sub-classing.
-
code(required): string
Refers to application relevant detail, defined in the API or a common list.
-
message: string
More details and corrective actions related to the error which can be shown to a client user.
-
reason(required): string
Explanation of the reason for the error which can be shown to a client user.
-
referenceError: string
(uri)
URI of documentation describing the error.
-
status: string
Displays the HTTP error code extension.
405 Response
Method Not Allowed
Root Schema : Error
Type:
object
This is used when an API throws an error, typically with a HTTP error response-code (3xx, 4xx, 5xx).
Show Source
-
@baseType: string
This defines the super-class when sub-classing.
-
@schemaLocation: string
(uri)
A URI to a JSON-schema file that defines additional attributes and relationships.
-
@type: string
This defines the sub-class entity name when sub-classing.
-
code(required): string
Refers to application relevant detail, defined in the API or a common list.
-
message: string
More details and corrective actions related to the error which can be shown to a client user.
-
reason(required): string
Explanation of the reason for the error which can be shown to a client user.
-
referenceError: string
(uri)
URI of documentation describing the error.
-
status: string
Displays the HTTP error code extension.
409 Response
Conflict
Root Schema : Error
Type:
object
This is used when an API throws an error, typically with a HTTP error response-code (3xx, 4xx, 5xx).
Show Source
-
@baseType: string
This defines the super-class when sub-classing.
-
@schemaLocation: string
(uri)
A URI to a JSON-schema file that defines additional attributes and relationships.
-
@type: string
This defines the sub-class entity name when sub-classing.
-
code(required): string
Refers to application relevant detail, defined in the API or a common list.
-
message: string
More details and corrective actions related to the error which can be shown to a client user.
-
reason(required): string
Explanation of the reason for the error which can be shown to a client user.
-
referenceError: string
(uri)
URI of documentation describing the error.
-
status: string
Displays the HTTP error code extension.
500 Response
Internal Server Error
Root Schema : Error
Type:
object
This is used when an API throws an error, typically with a HTTP error response-code (3xx, 4xx, 5xx).
Show Source
-
@baseType: string
This defines the super-class when sub-classing.
-
@schemaLocation: string
(uri)
A URI to a JSON-schema file that defines additional attributes and relationships.
-
@type: string
This defines the sub-class entity name when sub-classing.
-
code(required): string
Refers to application relevant detail, defined in the API or a common list.
-
message: string
More details and corrective actions related to the error which can be shown to a client user.
-
reason(required): string
Explanation of the reason for the error which can be shown to a client user.
-
referenceError: string
(uri)
URI of documentation describing the error.
-
status: string
Displays the HTTP error code extension.
Examples
The following example shows how to get top-up balances by submitting a GET request on the REST resource using cURL. For more information about cURL, see Use cURL.
The request uses query parameters to show two top-up balances for a specified account.
curl -X GET 'http://host:port/brm/prepayBalanceManagement/version/topupBalance?partyAccount.id=0.0.0.1+-account+6340627&limit=2'
Example of the Response Body
The following example shows the contents of the response body in JSON format.
[ { "@baseType": "TopupBalance", "@schemaLocation": null, "@type": "TopupBalance", "amount": { "amount": 2.0, "units": "USD", "@baseType": null, "@schemaLocation": null, "@type": null }, "bucket": { "id": "0.0.0.1+-balance_group+6344211+840+0", "href": "http://host:port/brm/prepayBalanceManagement/v4/bucket/0.0.0.1+-balance_group+6344211+840+0", "name": null, "@baseType": "BucketRef", "@schemaLocation": null, "@type": "BucketRef", "@referredType": null }, "channel": null, "confirmationDate": "2021-09-20T11:45:02+05:30", "description": null, "href": "http://host:port/brm/prepayBalanceManagement/v4/topupBalance/0.0.0.1+-topup+6448982", "id": "0.0.0.1+-topup+6448982", "impactedBucket": [ { "@baseType": "ImpactedBucket", "@schemaLocation": null, "@type": "ImpactedBucket", "amountAfter": { "amount": -2.0, "units": "USD", "@baseType": null, "@schemaLocation": null, "@type": null }, "amountBefore": { "amount": 0.0, "units": "USD", "@baseType": null, "@schemaLocation": null, "@type": null }, "bucket": { "id": "0.0.0.1+-balance_group+6344211+840+0", "href": "http://host:port/brm/prepayBalanceManagement/v4/bucket/0.0.0.1+-balance_group+6344211+840+0", "name": null, "@baseType": "BucketRef", "@schemaLocation": null, "@type": "BucketRef", "@referredType": null }, "confirmationDate": null, "description": null, "item": [ { "@baseType": "ImpactedBucketItem", "@schemaLocation": null, "@type": "ImpactedBucketItem", "amount": { "amount": 2.0, "units": "USD", "@baseType": null, "@schemaLocation": null, "@type": null }, "description": null, "itemType": null, "name": null, "reason": null } ], "name": null, "requestedDate": null } ], "isAutoTopup": false, "logicalResource": { "@baseType": null, "@referredType": null, "@schemaLocation": null, "@type": null, "href": null, "id": null, "name": null, "value": "" }, "numberOfPeriods": null, "partyAccount": { "id": "0.0.0.1+-account+6340627", "href": null, "description": null, "name": "Alice Rose", "status": "active", "@baseType": null, "@schemaLocation": null, "@type": "PartyAccountRef", "@referredType": null }, "payment": { "id": "0.0.0.1+-item-payment+6450518", "href": "http://host:port/brm/payment/v4/payment/0.0.0.1+-item-payment+6450518", "name": "Billing Event Log", "amount": { "unit": "USD", "value": 2.0 }, "paymentDate": "2021-09-20T11:45:01+05:30", "@baseType": "Payment", "@schemaLocation": null, "@type": "Payment", "@referredType": null }, "paymentMethod": { "id": "0.0.0.1+-payinfo-cc+6342675", "href": "http:/host:port/brm/paymentMethods/v1/paymentMethod/0.0.0.1+-payinfo-cc+6342675", "description": null, "isPreferred": true, "name": "PIN Payinfo Object", "status": null, "statusDate": null, "account": [ { "id": "0.0.0.1+-account+6340627", "href": null, "description": null, "name": "aa aa", "@baseType": null, "@schemaLocation": null, "@type": null, "@referredType": null } ], "relatedParty": null, "validFor": null, "@baseType": null, "@schemaLocation": null, "@type": "tokenizedCard", "@referredType": null }, "product": { "id": "0.0.0.1+-service-telco-gsm-telephony+6343955", "href": null, "name": "ServiceTelcoGsmTelephony", "@baseType": null, "@schemaLocation": null, "@type": "ProductRef", "@referredType": null }, "reason": null, "recurringPeriod": null, "relatedParty": null, "relatedTopupBalance": null, "requestedDate": "2021-09-20T11:45:02+05:30", "requestor": null, "status": "CONFIRMED", "usageType": "monetary", "voucher": "" }, { "@baseType": "TopupBalance", "@schemaLocation": null, "@type": "TopupBalance", "amount": { "amount": 20.0, "units": "USD", "@baseType": null, "@schemaLocation": null, "@type": null }, "bucket": { "id": "0.0.0.1+-balance_group+4097444+840+0", "href": "http://host:port/brm/prepayBalanceManagement/v4/bucket/0.0.0.1+-balance_group+4097444+840+0", "name": null, "@baseType": "BucketRef", "@schemaLocation": null, "@type": "BucketRef", "@referredType": null }, "channel": null, "confirmationDate": "2021-09-20T10:41:44+05:30", "description": null, "href": "http://host:port/brm/prepayBalanceManagement/v4/topupBalance/0.0.0.1+-topup+6442543", "id": "0.0.0.1+-topup+6442543", "impactedBucket": [ { "@baseType": "ImpactedBucket", "@schemaLocation": null, "@type": "ImpactedBucket", "amountAfter": { "amount": 643.0, "units": "USD", "@baseType": null, "@schemaLocation": null, "@type": null }, "amountBefore": { "amount": 663.0, "units": "USD", "@baseType": null, "@schemaLocation": null, "@type": null }, "bucket": { "id": "0.0.0.1+-balance_group+4097444+840+0", "href": "http://host:port/brm/prepayBalanceManagement/v4/bucket/0.0.0.1+-balance_group+4097444+840+0", "name": null, "@baseType": "BucketRef", "@schemaLocation": null, "@type": "BucketRef", "@referredType": null }, "confirmationDate": null, "description": null, "item": [ { "@baseType": "ImpactedBucketItem", "@schemaLocation": null, "@type": "ImpactedBucketItem", "amount": { "amount": 20.0, "units": "USD", "@baseType": null, "@schemaLocation": null, "@type": null }, "description": null, "itemType": null, "name": null, "reason": null } ], "name": null, "requestedDate": null } ], "isAutoTopup": false, "logicalResource": { "@baseType": null, "@referredType": null, "@schemaLocation": null, "@type": null, "href": null, "id": null, "name": null, "value": "056-20210812-035011-1-20412--146856192-cagbu-phx-175" }, "numberOfPeriods": null, "partyAccount": { "id": "0.0.0.1+-account+6340627", "href": null, "description": null, "name": "Alice Rose", "status": "active", "@baseType": null, "@schemaLocation": null, "@type": "PartyAccountRef", "@referredType": null }, "payment": { "id": "0.0.0.1+-item-payment+6439471", "href": "http://host:port/brm/payment/v4/payment/0.0.0.1+-item-payment+6439471", "name": "Billing Event Log", "amount": { "unit": "USD", "value": 20.0 }, "paymentDate": "2021-09-20T10:41:43+05:30", "@baseType": "Payment", "@schemaLocation": null, "@type": "Payment", "@referredType": null }, "paymentMethod": { "id": "0.0.0.1+-payinfo-cc+6306114", "href": "http://host:port/brm/paymentMethods/v1/paymentMethod/0.0.0.1+-payinfo-cc+6306114", "description": null, "isPreferred": false, "name": "PIN Payinfo Object", "status": null, "statusDate": null, "account": [ { "id": "0.0.0.1+-account+6340627", "href": null, "description": null, "name": "Alice Rose", "@baseType": null, "@schemaLocation": null, "@type": null, "@referredType": null } ], "relatedParty": null, "validFor": null, "@baseType": null, "@schemaLocation": null, "@type": "tokenizedCard", "@referredType": null }, "product": { "id": "0.0.0.1+-service-telco-gsm-sms+4099940", "href": null, "name": "ServiceTelcoGsmSms", "@baseType": null, "@schemaLocation": null, "@type": "ProductRef", "@referredType": null }, "reason": null, "recurringPeriod": null, "relatedParty": null, "relatedTopupBalance": null, "requestedDate": "2021-09-20T10:41:44+05:30", "requestor": null, "status": "CONFIRMED", "usageType": "monetary", "voucher": "" } ]