API Documentation

Complete documentation for the MotorManage Motorcycle Data API. Access our database of 600+ motorcycle brands and 41,000+ models.

← Back to Overview

Quick Start

Base URL

https://motorapi.motormanage.app/api/v1

Authentication

All API requests require an API key to be included in the header:

X-API-KEY: your_api_key_here

API Reference

Brands

GET/brands

Get a list of all motorcycle brands.

Response

[
  {
    "id": "b6a87f0f-fc5f-429d-9b0f-7ca1bb2baf47",
    "name": "Honda"
  },
  // ... more brands
]

GET/brands/search

Search for motorcycle brands.

Query Parameters

query* - Search term (string)

Response

[
  {
    "id": "b6a87f0f-fc5f-429d-9b0f-7ca1bb2baf47",
    "name": "Honda"
  },
  // ... matching brands
]

Motorcycles

GET/brands/:brand/motorcycles

Get all motorcycles for a specific brand.

Path Parameters

brand* - Brand ID (string)

Query Parameters

specs - Include specifications (boolean)

Response

[
  {
    "id": "3b9c913b-be30-41bf-95b4-b62e76700cb1",
    "model": "Honda 250 Rebel",
    "years": "2010",
    "category": "Allround"
  },
  // ... more motorcycles
]

GET/brands/:brand/motorcycles/search

Search motorcycles within a specific brand.

Path Parameters

brand* - Brand ID (string)

Query Parameters

query* - Search term (string)
specs - Include specifications (boolean)

Response

[
  {
    "id": "3b9c913b-be30-41bf-95b4-b62e76700cb1",
    "model": "Honda 250 Rebel",
    "years": "2010",
    "category": "Allround"
  },
  // ... matching motorcycles
]

GET/brands/:brand/motorcycles/:motorcycle

Get detailed information about a specific motorcycle's specifications.

Path Parameters

brand* - Brand ID (string)
motorcycle* - Motorcycle ID (string)

Query Parameters

specs - Include specifications (boolean)

Response

{
  "id": "3b9c913b-be30-41bf-95b4-b62e76700cb1",
  "model": "Honda 250 Rebel",
  "years": "2010",
  "category": "Allround"
}

Response with specs=true

{
  "id": "3b9c913b-be30-41bf-95b4-b62e76700cb1",
  "created": "0001-01-01T00:00:00Z",
  "updated": "0001-01-01T00:00:00Z",
  "brand": {
    "id": "b6a87f0f-fc5f-429d-9b0f-7ca1bb2baf47",
    "name": "Honda"
  },
  "model": "Honda 250 Rebel",
  "years": "2010",
  "description": "Model ID: CMX250C",
  "image": "",
  "category": "Allround",
  "displacement": "234.0 ccm (14.28 cubic inches)",
  "engine_type": "Twin, four-stroke",
  "compression": "9.2:1",
  "bore_x_stroke": "53.0 x 53.0 mm (2.1 x 2.1 inches)",
  "valves_per_cil": "2",
  "fuel_system": "Carburettor. Single 26mm diaphragm-type constant-velocity (CV) carburetor",
  "fuel_control": "Single Overhead Cams (SOHC)",
  "ignition": "CD",
  "cooling_system": "Air",
  "gearbox": "5-speed",
  "transmission_type": "Chain  (final drive)",
  "rake": "",
  "trail": "113 mm (4.4 inches)",
  "front_suspension": "33mm fork",
  "front_wheel_travel": "117 mm (4.6 inches)",
  "rear_suspension": "Dual shocks with five-position spring-preload adjustability",
  "rear_wheel_travel": "74 mm (2.9 inches)",
  "front_tire": "2.00-18",
  "rear_tire": "130/90-15",
  "front_brakes": "Single disc",
  "rear_brakes": "Expanding brake (drum brake)",
  "full_weight": "150.1 kg (331.0 pounds)",
  "dry_weight": "",
  "seat_height": "676 mm (26.6 inches) If adjustable, lowest setting.",
  "wheelbase": "1450 mm (57.1 inches)",
  "fuel_capacity": "9.84 litres (2.60 US gallons)",
  "color_options": "Black, Ultra Blue Metallic",
  "starter": "Electric",
  "comments": "",
  "clutch": "",
  "torque": "",
  "power": "",
  "ground_clearance": "",
  "length": "",
  "height": "",
  "width": "",
  "carbon_dioxide_emission": "",
  "oil_capacity": "",
  "fuel_consumption": "",
  "electrical": "",
  "light": "",
  "top_speed": "",
  "max_rpm": 0
}

GET/motorcycles/search

Search across all motorcycle models.

Query Parameters

query* - Search term (string)
specs - Include specifications (boolean)

Response

[
  {
    "id": "3b9c913b-be30-41bf-95b4-b62e76700cb1",
    "model": "Honda 250 Rebel",
    "years": "2010",
    "category": "Allround"
  },
  // ... search results
]

Rate Limits

Rate limits vary by plan. Check your plan details for specific limits.

Plan	Rate Limit
Starter	10,000 requests/month
Professional	100,000 requests/month
Enterprise	Custom limits

Error Handling

The API uses standard HTTP response codes to indicate the success or failure of requests.

Code	Description
200	Success
400	Bad Request - Invalid parameters
401	Unauthorized - Invalid API key
404	Not Found - Resource doesn't exist
429	Too Many Requests - Rate limit exceeded
500	Internal Server Error - Try again later or contact support

Need Help?

Having trouble integrating our API? Our technical team is here to help.

Contact Support