API Reference Overview - SG Cars Trends API

Base URL

All API requests should be made to:

https://api.sgcarstrends.com

Authentication

Most endpoints require authentication using Bearer tokens. See the Authentication guide for details.

Authorization: Bearer YOUR_API_KEY

Response Format

All API responses follow a consistent JSON structure:

Success Response

{
  "success": true,
  "data": [...],
  "total": 100,
  "page": 1,
  "limit": 50
}

Error Response

{
  "success": false,
  "error": "Error message",
  "code": 400
}

Endpoint Categories

Health Check

Monitor API and service health

Cars Data

Access vehicle registration statistics

COE Data

Get Certificate of Entitlement results

Workflows

Manage data update workflows

Rate Limits

Authentication	Rate Limit	Window
Authenticated	100 requests	1 minute
Unauthenticated	10 requests	1 minute

Common Query Parameters

Pagination

Parameter	Type	Description	Default
`page`	integer	Page number (1-based)	1
`limit`	integer	Results per page (max 100)	50

Filtering

Parameter	Type	Description	Example
`month`	string	Filter by month (YYYY-MM)	`2024-01`
`make`	string	Filter by car manufacturer	`Toyota`
`fuel_type`	string	Filter by fuel type	`Electric`
`vehicle_type`	string	Filter by vehicle type	`Passenger Cars`

Date Range

Parameter	Type	Description	Example
`from`	string	Start date (YYYY-MM)	`2024-01`
`to`	string	End date (YYYY-MM)	`2024-12`

HTTP Status Codes

Code	Status	Description
200	OK	Request successful
400	Bad Request	Invalid request parameters
401	Unauthorized	Authentication required or invalid
404	Not Found	Resource not found
429	Too Many Requests	Rate limit exceeded
500	Internal Server Error	Server error

Data Types

Car Registration Data

{
  "month": "2024-01",
  "make": "Toyota",
  "fuel_type": "Petrol",
  "vehicle_type": "Passenger Cars",
  "number": 245
}

COE Bidding Data

{
  "month": "2024-01",
  "bidding_no": 1,
  "vehicle_class": "Category A",
  "quota": 1000,
  "bids_success": 950,
  "bids_received": 1200,
  "premium": 85000
}

COE PQP Data

{
  "month": "2024-01",
  "vehicle_class": "Category A",
  "pqp": 87500
}

OpenAPI Specification

The complete OpenAPI specification is available at:

https://api.sgcarstrends.com/docs/openapi.json

You can also access the interactive API documentation at:

https://api.sgcarstrends.com/docs

SDKs and Libraries

Currently, the API is accessed via standard HTTP requests. We recommend using your preferred HTTP client library:

JavaScript: fetch(), axios
Python: requests, httpx
PHP: cURL, Guzzle
Java: OkHttp, HttpClient
Go: net/http

Next Steps

Quick Start

Make your first API call

Data Models

Understand the data structure

Examples

See practical examples

Guides

Learn advanced techniques

API Reference

​Base URL

​Authentication

​Response Format

​Success Response

​Error Response

​Endpoint Categories

Health Check

Cars Data

COE Data

Workflows

​Rate Limits

​Common Query Parameters

​Pagination

​Filtering

​Date Range

​HTTP Status Codes

​Data Types

​Car Registration Data

​COE Bidding Data

​COE PQP Data

​OpenAPI Specification

​SDKs and Libraries

​Next Steps