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

On this page

Base URL
Authentication
Response Format
Success Response
Error Response
Endpoint Categories
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

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

On this page

Base URL
Authentication
Response Format
Success Response
Error Response
Endpoint Categories
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

​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

Quick Start

Data Models

Examples

Guides

Core Concepts

​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

Quick Start

Data Models

Examples

Guides

Base URL

Authentication

Response Format

Success Response

Error Response

Endpoint Categories

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

Base URL

Authentication

Response Format

Success Response

Error Response

Endpoint Categories

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