Get Application Metadata

An introduction to the Get Application Metadata 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 Get Application Metadata endpoint retrieves all financial products available to the client. Each product includes a unique ID, a name, and a description.

This endpoint is typically the first call in the credit application flow. Use it to retrieve the available products and populate product selection options in your user interface before submitting an application. The id returned for a product is the value you pass as the productId field when creating a credit application.

📘

More Information

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

Prerequisites

To integrate calls to the Get Application Metadata endpoint, you need:

  • Your own user interface, such as a mobile app or web page, to display available credit products to a user and allow them to select one before beginning an application.

Example Request

Retrieve available financial products by making a GET request to the Get Application Metadata endpoint.

GET {{baseUrl}}/api/v1/credit/applications/metadata

Example Response

A successful request returns a 200 HTTP code and the response includes an available_financial_products array. Each item in the array represents a financial product available to the client.

{
  "available_financial_products": [
    {
      "id": "prod_123456",
      "name": "Standard Credit Card",
      "description": "A standard revolving line of credit with competitive rates."
    },
    {
      "id": "prod_789012",
      "name": "Premium Credit Card",
      "description": "A premium revolving line of credit with enhanced benefits."
    }
  ]
}

Response Fields

FieldTypeDescription
available_financial_productsarrayA list of financial products available to the client.

Each object in the available_financial_products array contains the following fields:

FieldTypeDescription
idstringThe unique ID of the financial product. Pass this value as productId when creating a credit application.
namestringThe name of the financial product.
descriptionstringA description of the financial product.
📘

More Information

Once you have retrieved the available products and the applicant has made their selection, pass the product id as the productId field in a POST request to the Create Credit Application endpoint to begin the application process.



Did this page help you?