{
  "openapi": "3.1.0",
  "info": {
    "title": "Maa Pitambara Biofuel Solutions Public API",
    "version": "1.0.0",
    "summary": "Read-only public data about biomass briquette and pellet supply.",
    "description": "Public, unauthenticated, read-only JSON API published by Maa Pitambara Biofuel Solutions. It exposes verified company, product, industrial application and contact data for biomass briquettes and pellets manufactured from mustard husk in Uttar Pradesh and Madhya Pradesh. No technical fuel specifications (GCV, moisture, ash) are published here; request them from the business. There are no write operations and no authentication.",
    "contact": {
      "name": "Maa Pitambara Biofuel Solutions",
      "email": "info@maapitambarabiofuelsolutions.in",
      "url": "https://www.maapitambarabiofuelsolutions.in/contact"
    },
    "license": {
      "name": "Public data — attribution appreciated",
      "url": "https://www.maapitambarabiofuelsolutions.in/privacy"
    }
  },
  "servers": [
    {
      "url": "https://www.maapitambarabiofuelsolutions.in",
      "description": "Production"
    }
  ],
  "tags": [
    {
      "name": "Company",
      "description": "Group and company level information."
    },
    {
      "name": "Products",
      "description": "Biomass briquette and pellet offerings."
    },
    {
      "name": "Applications",
      "description": "Industries served by the fuel."
    },
    {
      "name": "Contact",
      "description": "Public enquiry contact details."
    }
  ],
  "paths": {
    "/api/public/v1/companies": {
      "get": {
        "operationId": "getCompanies",
        "summary": "List group companies",
        "description": "Returns the umbrella group description plus both operating companies with establishment year, verified locations, raw material, products, supply areas and minimum order quantity.",
        "tags": [
          "Company"
        ],
        "security": [],
        "responses": {
          "200": {
            "description": "List group companies",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CompaniesResponse"
                }
              }
            }
          },
          "404": {
            "description": "No API resource exists at the requested path.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiError"
                }
              }
            }
          },
          "405": {
            "description": "The HTTP method is not supported by this read-only endpoint.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiError"
                }
              }
            }
          },
          "500": {
            "description": "Unexpected server error, returned as structured JSON.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiError"
                }
              }
            }
          }
        }
      }
    },
    "/api/public/v1/products": {
      "get": {
        "operationId": "getProducts",
        "summary": "List biomass fuel products",
        "description": "Returns biomass briquettes (70 mm and 90 mm) and biomass pellets (upcoming) with the offering company, packaging, transportation and minimum order quantity.",
        "tags": [
          "Products"
        ],
        "security": [],
        "responses": {
          "200": {
            "description": "List biomass fuel products",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProductsResponse"
                }
              }
            }
          },
          "404": {
            "description": "No API resource exists at the requested path.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiError"
                }
              }
            }
          },
          "405": {
            "description": "The HTTP method is not supported by this read-only endpoint.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiError"
                }
              }
            }
          },
          "500": {
            "description": "Unexpected server error, returned as structured JSON.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiError"
                }
              }
            }
          }
        }
      }
    },
    "/api/public/v1/applications": {
      "get": {
        "operationId": "getApplications",
        "summary": "List industrial applications",
        "description": "Returns the confirmed industrial applications served: boilers, furnaces, brick kilns, food processing units and textile units.",
        "tags": [
          "Applications"
        ],
        "security": [],
        "responses": {
          "200": {
            "description": "List industrial applications",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApplicationsResponse"
                }
              }
            }
          },
          "404": {
            "description": "No API resource exists at the requested path.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiError"
                }
              }
            }
          },
          "405": {
            "description": "The HTTP method is not supported by this read-only endpoint.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiError"
                }
              }
            }
          },
          "500": {
            "description": "Unexpected server error, returned as structured JSON.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiError"
                }
              }
            }
          }
        }
      }
    },
    "/api/public/v1/contact": {
      "get": {
        "operationId": "getContact",
        "summary": "Get public contact details",
        "description": "Returns the public enquiry channels: phone, WhatsApp, email and verified operating locations.",
        "tags": [
          "Contact"
        ],
        "security": [],
        "responses": {
          "200": {
            "description": "Get public contact details",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ContactResponse"
                }
              }
            }
          },
          "404": {
            "description": "No API resource exists at the requested path.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiError"
                }
              }
            }
          },
          "405": {
            "description": "The HTTP method is not supported by this read-only endpoint.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiError"
                }
              }
            }
          },
          "500": {
            "description": "Unexpected server error, returned as structured JSON.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiError"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "securitySchemes": {},
    "schemas": {
      "ApiError": {
        "type": "object",
        "required": [
          "error"
        ],
        "properties": {
          "error": {
            "type": "object",
            "required": [
              "code",
              "message",
              "hint",
              "status",
              "documentation"
            ],
            "properties": {
              "code": {
                "type": "string",
                "description": "Stable machine-readable error code."
              },
              "message": {
                "type": "string",
                "description": "Human-readable description of the failure."
              },
              "hint": {
                "type": "string",
                "description": "How to resolve or retry the request."
              },
              "status": {
                "type": "integer",
                "description": "HTTP status code."
              },
              "documentation": {
                "type": "string",
                "format": "uri",
                "description": "Link to the API docs."
              }
            }
          }
        }
      },
      "Company": {
        "type": "object",
        "required": [
          "id",
          "name",
          "established",
          "locations",
          "rawMaterial",
          "supplyAreas",
          "products",
          "moq"
        ],
        "properties": {
          "id": {
            "type": "string",
            "enum": [
              "bio-fuels-ii",
              "agro-energy"
            ]
          },
          "name": {
            "type": "string"
          },
          "established": {
            "type": "string"
          },
          "locations": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "rawMaterial": {
            "type": "string"
          },
          "supplyAreas": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "products": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "moq": {
            "type": "string",
            "description": "Minimum order quantity."
          }
        }
      },
      "CompaniesResponse": {
        "type": "object",
        "required": [
          "group",
          "companies"
        ],
        "properties": {
          "group": {
            "type": "object",
            "required": [
              "name",
              "description"
            ],
            "properties": {
              "name": {
                "type": "string"
              },
              "description": {
                "type": "string"
              }
            }
          },
          "companies": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Company"
            }
          }
        }
      },
      "Product": {
        "type": "object",
        "required": [
          "id",
          "name",
          "summary",
          "offerings"
        ],
        "properties": {
          "id": {
            "type": "string",
            "enum": [
              "biomass-briquettes",
              "biomass-pellets"
            ]
          },
          "name": {
            "type": "string"
          },
          "summary": {
            "type": "string"
          },
          "offerings": {
            "type": "array",
            "items": {
              "type": "object",
              "required": [
                "company"
              ],
              "properties": {
                "company": {
                  "type": "string"
                },
                "sizes": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                },
                "notes": {
                  "type": "string"
                },
                "status": {
                  "type": "string"
                }
              }
            }
          },
          "packaging": {
            "type": "string"
          },
          "transportation": {
            "type": "string"
          },
          "moq": {
            "type": "string"
          }
        }
      },
      "ProductsResponse": {
        "type": "object",
        "required": [
          "products"
        ],
        "properties": {
          "products": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Product"
            }
          }
        }
      },
      "ApplicationsResponse": {
        "type": "object",
        "required": [
          "applications"
        ],
        "properties": {
          "applications": {
            "type": "array",
            "items": {
              "type": "object",
              "required": [
                "title",
                "body"
              ],
              "properties": {
                "title": {
                  "type": "string"
                },
                "body": {
                  "type": "string"
                }
              }
            }
          }
        }
      },
      "ContactResponse": {
        "type": "object",
        "required": [
          "call",
          "whatsapp",
          "email",
          "locations"
        ],
        "properties": {
          "call": {
            "type": "string"
          },
          "whatsapp": {
            "type": "string"
          },
          "whatsappLink": {
            "type": "string",
            "format": "uri"
          },
          "email": {
            "type": "string",
            "format": "email"
          },
          "locations": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "note": {
            "type": "string"
          }
        }
      }
    }
  },
  "externalDocs": {
    "description": "Developer documentation",
    "url": "https://www.maapitambarabiofuelsolutions.in/docs"
  }
}