Car Loan Rates Time Series

Retrieve historical time series data for car loan rates from New Zealand financial institutions.

Endpoint

Field	Value
Method	`GET`
Path	`/api/v1/car-loan-rates/time-series`
Operation ID	`getCarLoanRatesTimeSeries`

Parameters

Parameter	Description
`date`	optional single date in YYYY-MM-DD format
`startDate`	optional range start date in YYYY-MM-DD format
`endDate`	optional range end date in YYYY-MM-DD format
`institutionId`	optional institution ID filter

Responses

Status	Description
`200`	Retrieve car loan rates time series data
`400`	Invalid date parameters
`404`	No data found
`500`	Server error

This endpoint provides historical time series data for car loan rates, allowing you to analyze trends and changes over time. The data is stored in Cloudflare D1 database, enabling efficient querying of historical datasets.

Response Data

Timestamp for each data point
Institution name and ID
Interest rates for new and used vehicles
Fixed and variable rate options
Special rates for specific vehicle types, such as electric vehicles
Minimum and maximum loan amounts
Available loan terms
Any promotional offers or special conditions

Use Cases

Auto Finance Trend Analysis: Track how car loan rates change over time and across institutions
Vehicle Purchase Planning: Help buyers understand the best time to finance vehicle purchases
Dealer Financing Comparison: Compare dealership financing offers with historical bank rates
EV Incentive Tracking: Monitor special financing rates for electric vehicles
Market Seasonality Studies: Identify patterns in seasonal financing offers and promotions

Notes on Data Storage

The time series data is stored in Cloudflare D1, a serverless SQL database built on SQLite. This allows for efficient querying, fast retrieval, reliable persistence, and scalable performance for growing historical datasets.