Developer API

SIDINGS exposes a public read-only machine API for listings discovery and ontology-aware interpretation. Contracts are versioned and served as live runtime OpenAPI artifacts.

Public Read APIContract: v1Auth: Anonymous

Quickstart

Base API URL

https://fast-track-api-gfhkaygncygbcpde.canadacentral-01.azurewebsites.net/api

Read-only endpoints for listings, facets, ontology, and changelog.
Responses include X-API-Version and X-Contract-Version.
Canonical values are emitted for ontology-backed fields.

OpenAPI

Endpoint Catalog

Use Case	Endpoint
Build listings search pages or agent fetchers	GET /api/public/listings
Fetch available machine filter vocabulary and policy classes	GET /api/public/facets
Interpret canonical terms and aliases by listing family	GET /api/public/ontology
Track non-breaking vs breaking contract changes	GET /api/public/changelog

GET /api/public/listings

https://fast-track-api-gfhkaygncygbcpde.canadacentral-01.azurewebsites.net/api/public/listings

Canonical public listing record set with stable pagination envelope.

GET /api/public/facets

https://fast-track-api-gfhkaygncygbcpde.canadacentral-01.azurewebsites.net/api/public/facets

Machine-usable discovery/filter surface and listing-type counts.

GET /api/public/ontology

https://fast-track-api-gfhkaygncygbcpde.canadacentral-01.azurewebsites.net/api/public/ontology

Stable canonical vocabulary for interpreting machine records.

GET /api/public/changelog

https://fast-track-api-gfhkaygncygbcpde.canadacentral-01.azurewebsites.net/api/public/changelog

Contract evolution log and compatibility expectations.

Example Request

Query published transload listings in Texas:

curl -s "https://fast-track-api-gfhkaygncygbcpde.canadacentral-01.azurewebsites.net/api/public/listings?listingType=transload&state=TX&limit=20" \
  -H "Accept: application/json"

Example Response

Typical response envelope for /api/public/listings:

{
  "status": "success",
  "data": {
    "version": "2026-03-11.v1",
    "generatedAt": "2026-03-11T16:10:25.120Z",
    "data": [
      {
        "id": 123,
        "name": "Houston Transload Terminal",
        "listingType": "transload",
        "state": "TX"
      }
    ],
    "pagination": {
      "page": 1,
      "limit": 20,
      "totalItems": 214,
      "totalPages": 11,
      "hasNextPage": true,
      "hasPrevPage": false
    },
    "nextPage": 2
  },
  "message": "Machine-readable public listings retrieved successfully",
  "timestamp": "2026-03-11T16:10:25.120Z"
}

Versioning Policy

Non-breaking additive changes are allowed.
Renames/removals require contract version bump and changelog entry.
Equivalent alias inputs are expected to resolve to stable canonical outputs.

For support and partnership questions, contact the SIDINGS team.