List Credit Applications
An introudction ot the List Credit Applications endpoint.
Early AccessCredit API endpoints are currently being finalised as part of ongoing product development. While we do not anticipate significant changes, some interfaces, behaviours, and documentation may be refined before general availability.
The List Credit Applications endpoint retrieves a list of all credit applications submitted by the client. Each item in the list is a summary of the application, including the application ID, product details, applicant name, email address, and the date the application was created.
An example of how you could use this functionality is to build a page in your user interface that displays a list of submitted applications, allowing a user to see all current and previous applications at a glance.
More InformationTo view the full status history of a specific application, use the Get Credit Application Timeline endpoint, passing the
applicationIdfrom this response.
Prerequisites
To integrate calls to the List Credit Applications endpoint, you need:
- Your own user interface, such as a mobile app or web page, to display application information to a user.
- A subscription to Thredd webhooks so that you can receive application status updates in real time and communicate them to an applicant via your user interface.
Example Request
Retrieve a list of credit applications by making a GET request to the List Credit Applications endpoint.
GET {{baseUrl}}/api/v1/credit/applications
Example Response
A successful request returns a 200 HTTP code and the response includes a creditApplications array.
Each item in the list is a summary of the application, including the application ID, current status, product details, applicant name, email address, associated account ID (if one exists), and the date the application was created.
{
"creditApplications": [
{
"applicationId": "app_123456",
"productId": "prod_123456",
"productName": "Standard Credit Card",
"productDescription": "A standard revolving line of credit.",
"firstName": "Known",
"lastName": "Person",
"email": "[email protected]",
"status": "PENDED",
"nationalId": {
"idNumber": "123-45-6789",
"idType": "SSN"
},
"createdAt": 1736238041798277,
"accountId": null
},
{
"applicationId": "app_789012",
"productId": "prod_789012",
"productName": "Premium Credit Card",
"productDescription": "A premium revolving line of credit.",
"firstName": "Known",
"lastName": "Person",
"email": "[email protected]",
"status": "APPROVED",
"nationalId": {
"idNumber": "123-45-6790",
"idType": "SSN"
},
"createdAt": 1738581330123456,
"accountId": "acc_456789"
}
]
}Response Fields
Each object in the creditApplications array contains the following fields:
| Field | Type | Description |
|---|---|---|
applicationId | string | The unique ID of the application. |
productId | string | The unique ID of the credit product. |
productName | string | The name of the credit product. |
productDescription | string | A description of the credit product. |
firstName | string | The first name of the applicant. |
lastName | string | The last name of the applicant. |
email | string | The email address of the applicant. |
createdAt | integer | Unix timestamp in microseconds when the application was created. |
status | string | The current status of the application. |
nationalId | object | The national identification details of the applicant. Contains idNumber (string) and idType (string). |
accountId | string | The unique ID of the line of credit account associated with this application. null until the application is approved and an account is created. |
More informationFor more information about the application process, see: Credit Applications and Origination.
Updated 4 days ago
