{
  "openapi": "3.0.3",
  "info": {
    "title": "RentOS Public API",
    "version": "1.0.0",
    "description": "Read-only public API for RentOS — B2B equipment rental and cargo logistics in the UAE. No authentication required. Rate limited to 60 requests/minute per IP. All responses are cached for 1 hour."
  },
  "servers": [
    {
      "url": "https://ataad.ae/api/public"
    }
  ],
  "paths": {
    "/v1/scaffolding": {
      "get": {
        "summary": "List scaffolding types and pricing",
        "description": "Returns published scaffolding types with per-city daily, weekly and monthly rates in AED.",
        "responses": {
          "200": {
            "description": "Array of scaffolding types",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/Scaffolding"
                  }
                },
                "example": [
                  {
                    "id": "a1b2",
                    "name": "Frame Scaffolding",
                    "slug": "frame-scaffolding",
                    "category": "Frame",
                    "pricing": [
                      {
                        "city": "Dubai",
                        "daily_aed": 280,
                        "weekly_aed": 1650,
                        "monthly_aed": 6200
                      }
                    ]
                  }
                ]
              }
            }
          }
        }
      }
    },
    "/v1/equipment": {
      "get": {
        "summary": "List heavy equipment",
        "description": "Returns published heavy equipment with category, emirate and daily AED rate.",
        "responses": {
          "200": {
            "description": "Array of equipment items",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/Equipment"
                  }
                },
                "example": [
                  {
                    "id": "c3d4",
                    "name": "Liebherr LTM 1090-4.2 Mobile Crane",
                    "slug": "liebherr-ltm-1090",
                    "category": "RentOS Heavy Lift",
                    "emirate": "Dubai",
                    "daily_rate_aed": 4800
                  }
                ]
              }
            }
          }
        }
      }
    },
    "/v1/cargo-routes": {
      "get": {
        "summary": "List active cargo corridors",
        "description": "Returns active cargo corridors (origin → destination) with the container options offered on each.",
        "responses": {
          "200": {
            "description": "Array of corridors",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/CargoCorridor"
                  }
                },
                "example": [
                  {
                    "id": "e5f6",
                    "origin": "China",
                    "destination": "United Arab Emirates",
                    "slug": "china-to-united-arab-emirates",
                    "containers": [
                      {
                        "size": "40ft High Cube",
                        "available": true
                      }
                    ]
                  }
                ]
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "Scaffolding": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "slug": {
            "type": "string"
          },
          "category": {
            "type": "string",
            "nullable": true
          },
          "pricing": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "city": {
                  "type": "string"
                },
                "daily_aed": {
                  "type": "number"
                },
                "weekly_aed": {
                  "type": "number"
                },
                "monthly_aed": {
                  "type": "number"
                }
              }
            }
          }
        }
      },
      "Equipment": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "slug": {
            "type": "string"
          },
          "category": {
            "type": "string",
            "nullable": true
          },
          "emirate": {
            "type": "string",
            "nullable": true
          },
          "daily_rate_aed": {
            "type": "number"
          }
        }
      },
      "CargoCorridor": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "origin": {
            "type": "string"
          },
          "destination": {
            "type": "string"
          },
          "slug": {
            "type": "string"
          },
          "containers": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "size": {
                  "type": "string"
                },
                "available": {
                  "type": "boolean"
                }
              }
            }
          }
        }
      }
    }
  }
}