Get Bill Items for an Account
get
/bcws/webresources/v1.0/items/account/{id}
Gets all bill items for the specified account.
Request
Path Parameters
-
id(required): string
The ID of the account, such as 0.0.0.1+-account+123123, to get bill items for.
Query Parameters
-
count(required): integer(int32)
The number of bill items to return.
-
expand(required): string
The additional details to include in the response. Enter all to return bill items for the parent account and all of its child accounts. Enter childonly to return bill items for only the child accounts associated with a parent account.
-
type(required): string
The type of bill items to retrieve:
- open retrieves all bill items regardless of the due date.
- past retrieves only bill items whose due date has already passed.
There's no request body for this operation.
Back to TopResponse
Supported Media Types
- application/xml
- application/json
200 Response
The bill items were returned successfully.
Nested Schema : billItem
Type:
object
The bill item details.
Show Source
-
accountName: string
The name of the account.
-
accountNumber: string
The account number associated with the bill item.
-
accountRef: object
ResourceRef
-
adjusted: number
The total amount from debit and credit adjustments made to the bill item.
-
aliasList: array
aliasList
The list of aliases in the bill item.
-
amount(required): number
The amount of the bill item.
-
arBillinfoRef: object
ResourceRef
-
arBillRef: object
ResourceRef
-
billInfoId: string
The ID of the /billinfo object.
-
billinfoRef: object
ResourceRef
-
billNo: string
The bill number.
-
billRef: object
ResourceRef
-
closedDate: string
(date-time)
The date and time the bill item was closed. If the bill item is reopened for an adjustment, this is reset until the bill item is closed again.
-
creationDate: string
(date-time)
The date and time the bill item was created.
-
currency: integer
(int32)
The currency for the bill item, copied from the currency of the associated account.
-
deltaDue: number
The delta amount due.
-
discount: number
The amount discounted for the bill item.
-
disputed: number
The total amount from disputes associated with the bill item.
-
due: number
The amount due for the bill item.
-
dueDate: string
(date-time)
The date when the amount in the bill item is due.
-
extension: object
extension
The extended attributes.
-
firstName: string
The first name of the account holder.
-
id(required): string
The ID.
-
itemNo: string
The bill item's number.
-
lastName: string
The last name of the account holder.
-
login: string
The username associated with the bill item.
-
name: string
The bill item's name.
-
received: number
The amount of payments or credits applied to the bill item.
-
serviceRef: object
ResourceRef
-
serviceTypeName: string
The name of the service type.
-
status: string
The status of the bill item: active (10100), inactive (10102), or closed (10103)
-
transfered: number
The amount transferred out of the bill item.
-
type: string
The bill item's type.
-
writeoff: number
The amount written off for the bill item.
Nested Schema : ResourceRef
Type:
Show Source
object
-
id(required): string
The ID.
-
uri: string
The Uniform Resource Identifier (URI) associated with the resource.
Nested Schema : aliasList
Type:
array
The list of aliases in the bill item.
Show Source
-
Array of:
object AliasList
The list of aliases associated with the service.
Nested Schema : extension
Type:
object
The extended attributes.
500 Response
An internal server error occurred.
Examples
This example shows how to get two bill items with a past due date for an account by submitting a GET request on the REST resource using cURL. For more information about cURL, see "Use cURL".
cURL Command
curl -X GET 'http://hostname:port/bcws/webresources/version/items/account/0.0.0.1+-account+57615?type=past&count=2'
where:
- hostname is the URL for the Billing Care REST server.
- port is the port for the Billing Care REST server.
- version is the version of the API you're using, such as v1.0.
Example of Response Body
This example shows the contents of the response body in JSON format.
[
{
"extension": null,
"id": "0.0.0.1+-item-cycle_forward+215497",
"name": "Cycle forward",
"type": "/item/cycle_forward",
"accountRef": {
"id": "0.0.0.1+-account+57615",
"uri": null
},
"arBillinfoRef": null,
"arBillRef": {
"id": "0.0.0.1+-bill+211720",
"uri": null
},
"billRef": {
"id": "0.0.0.1+-bill+211720",
"uri": null
},
"serviceRef": {
"id": "0.0.0.1+-service-ip+166570",
"uri": null
},
"billinfoRef": null,
"creationDate": null,
"closedDate": null,
"currency": null,
"deltaDue": null,
"disputed": 0,
"adjusted": 0,
"due": 29.95,
"dueDate": 1610265600000,
"itemNo": "B1-646,3",
"login": "IP_Service",
"received": 0,
"transfered": 0,
"writeoff": 0,
"amount": null,
"discount": null,
"billNo": "B1-646",
"billInfoId": "Bill Unit(1)",
"accountName": null,
"firstName": null,
"lastName": null,
"serviceTypeName": "ip",
"accountNumber": "0.0.0.1-57615",
"aliasList": [],
"status": null
},
{
"extension": null,
"id": "0.0.0.1+-item-cycle_forward+216105",
"name": "Cycle forward",
"type": "/item/cycle_forward",
"accountRef": {
"id": "0.0.0.1+-account+57615",
"uri": null
},
"arBillinfoRef": null,
"arBillRef": {
"id": "0.0.0.1+-bill+211720",
"uri": null
},
"billRef": {
"id": "0.0.0.1+-bill+211720",
"uri": null
},
"serviceRef": {
"id": "0.0.0.1+-service-ip+156801",
"uri": null
},
"billinfoRef": null,
"creationDate": null,
"closedDate": null,
"currency": null,
"deltaDue": null,
"disputed": 0,
"adjusted": 0,
"due": 10,
"dueDate": 1610265600000,
"itemNo": "B1-646,6",
"login": "ip0",
"received": 0,
"transfered": 0,
"writeoff": 0,
"amount": null,
"discount": null,
"billNo": "B1-646",
"billInfoId": "Bill Unit(1)",
"accountName": null,
"firstName": null,
"lastName": null,
"serviceTypeName": "ip",
"accountNumber": "0.0.0.1-57615",
"aliasList": [],
"status": null
}
]