List Credit Applications

An introudction ot the List Credit Applications endpoint.

📘

Early Access

Credit 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 Information

To view the full status history of a specific application, use the Get Credit Application Timeline endpoint, passing the applicationId from 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:

FieldTypeDescription
applicationIdstringThe unique ID of the application.
productIdstringThe unique ID of the credit product.
productNamestringThe name of the credit product.
productDescriptionstringA description of the credit product.
firstNamestringThe first name of the applicant.
lastNamestringThe last name of the applicant.
emailstringThe email address of the applicant.
createdAtintegerUnix timestamp in microseconds when the application was created.
statusstringThe current status of the application.
nationalIdobjectThe national identification details of the applicant. Contains idNumber (string) and idType (string).
accountIdstringThe unique ID of the line of credit account associated with this application. null until the application is approved and an account is created.
📘

More information

For more information about the application process, see: Credit Applications and Origination.



Did this page help you?