API Library
This section includes the three (3) Transaction History API endpoints listed below. Each page offers a brief summary of the API endpoint in question, common use-case scenarios, and sample request/response messages with response codes.
API endpoints
Health Check
Test and confirm that the Transaction History API is up and ready to process requests.
Collector Request
Retrieve the transaction history for a logged in Collector.
Sponsor Request
Retrieve the transaction history for a specified Collector number and filter by sponsor.
Handling request/response messages
As described above, the RESTful specification defines a transaction as a pair of request and response messages that are used for information interchange.
Note
Mandatory parameters will be marked with an asterisk (*) in the subsequent pages.Message Type | Description |
---|---|
Request | |
Response | Content-Type is specified in the Header (e.g., application/json .responseCode .null or ’empty’ values are automatically excluded from the response body. |
Status codes
Status Code | Description |
---|---|
200 |
The transaction was successful. |
401 |
The Collector account is not active. |
408 |
The transaction timed out. |
401 |
The Collector number is invalid. |
400 |
A mistake was made when submitting the request. Please correct the error and try again. |
503 |
The system is unavailable due to scheduled maintenance. No requests can be sent. |
500 |
An unknown error occurred |
none | No valid Bearer token present. Please generate a valid Bearer token and submit to continue. |