Developer REST API (v1)
The Supply Chains Canada REST API provides programmatic access to verified Canadian manufacturing, processing, stocking, and warehousing facilities. All responses are returned as lightweight JSON with semantic HTTP status codes.
Obtain a Free API Access Key
AUTHENTICATION SPECIFICATION
------------------------------------------------------------------------
Header: X-API-Key: <your_api_key>
Query Param: ?api_key=<your_api_key> (convenience fallback)
Public Demo: sc_live_demo_key_2026 (shared read-only testing key)
Rate Limit: 60 requests / minute per key
Format: application/json; charset=utf-8
------------------------------------------------------------------------
Endpoints Overview
| Method & Path | Description |
|---|---|
GET /api/v1/suppliers |
Query and filter verified Canadian facilities. Parameters: q (search), province (e.g. ON), pillar, limit, offset. |
GET /api/v1/suppliers/:slug |
Retrieve full profile, equipment specs, and verified status for a single facility. |
GET /api/v1/categories |
Retrieve full hierarchical catalog taxonomy tree with NAICS codes. |
GET /api/v1/pillars |
List primary industrial sector classifications. |
GET /api/v1/stats |
Public health metrics: count of indexed facilities by province and server telemetry. |
POST /api/v1/keys |
Programmatically register and provision a new API access key (Accepts JSON { "name": "...", "email": "..." }). |
Example Query: Searching Suppliers via curl
# Querying custom box manufacturers in Ontario with your API key
curl -s "https://supplychains.ca/api/v1/suppliers?q=corrugated&province=ON" \
-H "X-API-Key: sc_live_demo_key_2026" | jq .
{
"status": "success",
"query_time_ms": 2.41,
"count": 1,
"results": [
{
"id": 2,
"name": "Great Lakes Corrugated Box & Packaging Corp.",
"slug": "great-lakes-corrugated-box",
"city": "Mississauga",
"province": "ON",
"postal_fsa": "L5T",
"is_verified": true,
"website_url": "https://example.com/great-lakes-corrugated",
"min_order_tier": "Low MOQ (100+ boxes)",
"certifications": ["FSC Certified Recycled Paper"]
}
]
}