Versions Compared
Key
- This line was added.
- This line was removed.
- Formatting was changed.
Usage
Excerpt |
---|
Retrieves a list of all closed accounts within a date range. |
This can be specified at a single contract prefix or facility account level.
Note |
---|
Since this API call does not have pagination, our recommendation is to apply smaller date ranges (not more than 30 days) otherwise, you may receive timeout errors. |
Parameters
Name | Data Type | Length | Description | |
---|---|---|---|---|
User | ||||
| String | Required | Provided by Debitsuccess | |
| String | Required | Provided by Debitsuccess | |
RequestInitiator | String | 100 | Optional | Optional – allows requesting user to be logged |
ContractPrefix | String | 6 | Optional | Provided by Debitsuccess (allows customer accounts to be split into different organisational groups if required). |
StartDate | DateTime | Required | Start of the report period | |
EndDate | DateTime | Optional | End of the report period |
If Contract Prefix is not given, then return all the cancelled accounts from the facility/facility account assigned to the user.
The following is a list of the different combinations of parameters which can be used for this method:
- Providing StartDate and EndDate parameters returns account details for all accounts that have had details changed during the specified period.
- Providing the StartDate parameter returns account details for all accounts that have had details changed after the specified date.
Response
Name | Data Type | Description |
---|---|---|
DateCreated | DateTime | Date/time message was processed |
Id | String | Unique ID for message |
ResponseNotes () | Collection of validation messages | |
| String | |
| String | |
| Enum | Error, Warning, Info |
Status | Enum | Failed, Succeed, Unknown |
Accounts () | ||
| String | |
| String | Debitsuccess Reference Number |
| String | External account reference |
| String | |
| String | |
| String | |
| String | |
| Date Time |
Error Messages
Type | Error Code | Error Message |
---|---|---|
Warning | 14202 | Start date is required |
Warning | 14203 | Start date cannot be in the future |
Invalid Value | 13090 | Start date must not be after end date |
Invalid Value | 14109 | Start date and End date cannot be more than 1 month apart |
Invalid Value | 13001 | Invalid Contract Prefix |
Related Pages
Filter by label (Content by label) | ||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Panel | |
---|---|
On this page:
|