Get bill import rules. Supports filtering by vendor name, account name, and rule definition.
Paginated endpoint — This API returns paginated results. Use the pageNumber and pageSize query parameters to control which page of results is returned. The response includes pagination metadata in the response headers. See the Pagination guide for details.
Request Headers
| Header | Value | Required | Description |
|---|---|---|---|
| ECI-ApiKey | string | Yes | Your API key. See Authentication. |
| Content-Type | application/json | Yes | All requests must specify JSON content type. |
Query Parameters
| Name | Description | Type | Required |
|---|---|---|---|
| filter | Filter criteria | string (string) | Optional |
| orderBy | Order by criteria | string (string) | Optional |
| pageSize | The number of elements to return in a page | integer (int32) | Optional |
| pageNumber | The current page number | integer (int32) | Optional |
Filters
| Filter | Description | Type | Operators |
|---|---|---|---|
| accountName | Account Name | String | equals not equals one of like not like not one of |
| description | Description | String | equals not equals one of like not like not one of |
| vendorName | Vendor Name | String | equals not equals one of like not like not one of |
Order By Options
| Name | Description |
|---|---|
| description | Description |
| vendorName | Vendor Name |
| accountName | Account Name |
Response Headers
This endpoint returns pagination metadata in the response headers.
| Header | Type | Description |
|---|---|---|
| PageNumber | integer | The current page number (1-based). |
| PageSize | integer | The maximum number of items per page. |
| TotalNumberOfRecords | integer | The total number of records matching the query across all pages. |
| TotalPages | integer | The total number of pages. Increment pageNumber until it equals this value to retrieve all results. |
See the Pagination guide for iteration examples and best practices.
Responses
200
OK
The request succeeded and the response body contains the requested data.
Response Body Parameters
Array of:
BillImportRuleResponseV202604
| Property | Description | Type | ||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| account | AccountChild | |||||||||||||||||||||||||||||||||||||||||||||||||
|
AccountChild properties
|
||||||||||||||||||||||||||||||||||||||||||||||||||
| billImportRuleId | The unique identifier of the bill import rule | integer (int32) | ||||||||||||||||||||||||||||||||||||||||||||||||
| billImportRuleTemplateId | If set, the bill import rule template associated with the rule | integer (int32) | ||||||||||||||||||||||||||||||||||||||||||||||||
| createdBy | UserChild | |||||||||||||||||||||||||||||||||||||||||||||||||
|
UserChild properties
|
||||||||||||||||||||||||||||||||||||||||||||||||||
| createdDate | The date and time the rule was created | string (date-time) | ||||||||||||||||||||||||||||||||||||||||||||||||
| description | A human-readable description of what the rule does | string | ||||||||||||||||||||||||||||||||||||||||||||||||
| modifiedBy | UserChild | |||||||||||||||||||||||||||||||||||||||||||||||||
|
UserChild properties
|
||||||||||||||||||||||||||||||||||||||||||||||||||
| modifiedDate | The date and time the rule was last modified | string (date-time) | ||||||||||||||||||||||||||||||||||||||||||||||||
| priority | The execution priority of the rule within its scope. Lower values execute first. | integer (int32) | ||||||||||||||||||||||||||||||||||||||||||||||||
| ruleDefinition | The JavaScript rule definition executed by the rules engine | string | ||||||||||||||||||||||||||||||||||||||||||||||||
| vendor | VendorChild | |||||||||||||||||||||||||||||||||||||||||||||||||
|
VendorChild properties
|
||||||||||||||||||||||||||||||||||||||||||||||||||
Example Response
[
{ "account": { "accountCode": "string", "accountId": 1, "accountInfo": "string", "active": false, "hasCalculatedMeter": false, "hasSplitChildMeter": false, "hasSplitParentMeter": false, "hasSubAccount": false, "isSubAccount": false, "vendor": {}
}, "billImportRuleId": 1, "billImportRuleTemplateId": 1, "createdBy": { "fullName": "string", "userCode": "string", "userId": 1
}, "createdDate": "2026-05-01", "description": "string", "modifiedBy": { "fullName": "string", "userCode": "string", "userId": 1
}, "modifiedDate": "2026-05-01", "priority": 1, "ruleDefinition": "string", "vendor": { "vendorCode": "string", "vendorId": 1, "vendorInfo": "string"
}
}
]