{
  "info": {
    "_postman_id": "7d9b736b-d890-4c48-8df0-e6fb368ffea3",
    "name": "Ratias Open Math API",
    "description": "Postman Collection for Ratias Open Math API. It contains requests to get all formulas metadata and calculate values for all 13 mathematical percentage formulas.",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "item": [
    {
      "name": "Get Formulas Metadata",
      "request": {
        "method": "GET",
        "header": [],
        "url": {
          "raw": "{{baseUrl}}/api/formulas.json",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "api",
            "formulas.json"
          ]
        },
        "description": "Get the complete catalog of 13 localized percentage formulas, their parameters, and localized descriptions."
      },
      "response": []
    },
    {
      "name": "Calculations",
      "item": [
        {
          "name": "Formula 1 - Percentage Calculator",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/api/calculate?formula=1&val1=150&val2=20&lang=en",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "calculate"
              ],
              "query": [
                {
                  "key": "formula",
                  "value": "1",
                  "description": "Formula ID (1 or formula1)"
                },
                {
                  "key": "val1",
                  "value": "150",
                  "description": "Base Number (A)"
                },
                {
                  "key": "val2",
                  "value": "20",
                  "description": "Percentage Rate (B)"
                },
                {
                  "key": "lang",
                  "value": "en",
                  "description": "Language code (en, tr, de, fr)"
                }
              ]
            },
            "description": "Calculates B percent of A. Equation: (A * B) / 100"
          },
          "response": []
        },
        {
          "name": "Formula 2 - Percentage Add",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/api/calculate?formula=2&val1=100&val2=18&lang=en",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "calculate"
              ],
              "query": [
                {
                  "key": "formula",
                  "value": "2"
                },
                {
                  "key": "val1",
                  "value": "100",
                  "description": "Base Number (A)"
                },
                {
                  "key": "val2",
                  "value": "18",
                  "description": "Percentage to Add (B)"
                },
                {
                  "key": "lang",
                  "value": "en"
                }
              ]
            },
            "description": "Adds B percent to A. Equation: A * (1 + B / 100)"
          },
          "response": []
        },
        {
          "name": "Formula 3 - Reverse Percentage",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/api/calculate?formula=3&val1=118&val2=18&lang=en",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "calculate"
              ],
              "query": [
                {
                  "key": "formula",
                  "value": "3"
                },
                {
                  "key": "val1",
                  "value": "118",
                  "description": "Total Amount (A)"
                },
                {
                  "key": "val2",
                  "value": "18",
                  "description": "Percentage Rate (B)"
                },
                {
                  "key": "lang",
                  "value": "en"
                }
              ]
            },
            "description": "Finds the original value before B percent was added to it (e.g. VAT exclusion calculation). Equation: A / (1 + B / 100)"
          },
          "response": []
        },
        {
          "name": "Formula 4 - Percentage Exclude",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/api/calculate?formula=4&val1=100&val2=15&lang=en",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "calculate"
              ],
              "query": [
                {
                  "key": "formula",
                  "value": "4"
                },
                {
                  "key": "val1",
                  "value": "100",
                  "description": "Base Number (A)"
                },
                {
                  "key": "val2",
                  "value": "15",
                  "description": "Percentage to Subtract (B)"
                },
                {
                  "key": "lang",
                  "value": "en"
                }
              ]
            },
            "description": "Subtracts B percent from A. Equation: A * (1 - B / 100)"
          },
          "response": []
        },
        {
          "name": "Formula 5 - Ratio Calculator",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/api/calculate?formula=5&val1=30&val2=150&lang=en",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "calculate"
              ],
              "query": [
                {
                  "key": "formula",
                  "value": "5"
                },
                {
                  "key": "val1",
                  "value": "30",
                  "description": "Numerator (A)"
                },
                {
                  "key": "val2",
                  "value": "150",
                  "description": "Denominator (B)"
                },
                {
                  "key": "lang",
                  "value": "en"
                }
              ]
            },
            "description": "Finds what percentage of B is represented by A. Equation: (A / B) * 100"
          },
          "response": []
        },
        {
          "name": "Formula 6 - Percentage Increase",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/api/calculate?formula=6&val1=120&val2=100&lang=en",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "calculate"
              ],
              "query": [
                {
                  "key": "formula",
                  "value": "6"
                },
                {
                  "key": "val1",
                  "value": "120",
                  "description": "First Number / New Value (A)"
                },
                {
                  "key": "val2",
                  "value": "100",
                  "description": "Second Number / Original Value (B)"
                },
                {
                  "key": "lang",
                  "value": "en"
                }
              ]
            },
            "description": "Calculates the percentage increase from B to A. Equation: ((A / B) - 1) * 100"
          },
          "response": []
        },
        {
          "name": "Formula 7 - Percentage Decrease",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/api/calculate?formula=7&val1=80&val2=100&lang=en",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "calculate"
              ],
              "query": [
                {
                  "key": "formula",
                  "value": "7"
                },
                {
                  "key": "val1",
                  "value": "80",
                  "description": "First Number / New Value (A)"
                },
                {
                  "key": "val2",
                  "value": "100",
                  "description": "Second Number / Original Value (B)"
                },
                {
                  "key": "lang",
                  "value": "en"
                }
              ]
            },
            "description": "Calculates the percentage decrease from B to A. Equation: (|B - A| / B) * 100"
          },
          "response": []
        },
        {
          "name": "Formula 8 - Large Number Percentage",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/api/calculate?formula=8&val1=20&val2=50&val3=30&lang=en",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "calculate"
              ],
              "query": [
                {
                  "key": "formula",
                  "value": "8"
                },
                {
                  "key": "val1",
                  "value": "20",
                  "description": "Known Percentage (A)"
                },
                {
                  "key": "val2",
                  "value": "50",
                  "description": "Known Value (B)"
                },
                {
                  "key": "val3",
                  "value": "30",
                  "description": "Target Percentage (C)"
                },
                {
                  "key": "lang",
                  "value": "en"
                }
              ]
            },
            "description": "Calculates target percentage C of a number if its A percent is B. Equation: (B / A) * C"
          },
          "response": []
        },
        {
          "name": "Formula 9 - Discount Percentage",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/api/calculate?formula=9&val1=150&val2=120&lang=en",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "calculate"
              ],
              "query": [
                {
                  "key": "formula",
                  "value": "9"
                },
                {
                  "key": "val1",
                  "value": "150",
                  "description": "Original Price (A)"
                },
                {
                  "key": "val2",
                  "value": "120",
                  "description": "Discounted Price (B)"
                },
                {
                  "key": "lang",
                  "value": "en"
                }
              ]
            },
            "description": "Finds the discount percentage rate from A to B. Equation: ((B / A) - 1) * 100"
          },
          "response": []
        },
        {
          "name": "Formula 10 - Compound Growth",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/api/calculate?formula=10&val1=1000&val2=5&val3=10&lang=en",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "calculate"
              ],
              "query": [
                {
                  "key": "formula",
                  "value": "10"
                },
                {
                  "key": "val1",
                  "value": "1000",
                  "description": "Initial Value (A)"
                },
                {
                  "key": "val2",
                  "value": "5",
                  "description": "Growth Rate per period (B)"
                },
                {
                  "key": "val3",
                  "value": "10",
                  "description": "Number of Periods (C)"
                },
                {
                  "key": "lang",
                  "value": "en"
                }
              ]
            },
            "description": "Calculates compound growth of initial value A at rate B for C periods. Equation: A * (1 + B / 100)^C"
          },
          "response": []
        },
        {
          "name": "Formula 11 - Percentage Difference",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/api/calculate?formula=11&val1=120&val2=80&lang=en",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "calculate"
              ],
              "query": [
                {
                  "key": "formula",
                  "value": "11"
                },
                {
                  "key": "val1",
                  "value": "120",
                  "description": "First Value (A)"
                },
                {
                  "key": "val2",
                  "value": "80",
                  "description": "Second Value (B)"
                },
                {
                  "key": "lang",
                  "value": "en"
                }
              ]
            },
            "description": "Calculates the percentage difference between two independent numbers A and B. Equation: (|A - B| / ((A + B) / 2)) * 100"
          },
          "response": []
        },
        {
          "name": "Formula 12 - Percentage Error",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/api/calculate?formula=12&val1=100&val2=105&lang=en",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "calculate"
              ],
              "query": [
                {
                  "key": "formula",
                  "value": "12"
                },
                {
                  "key": "val1",
                  "value": "100",
                  "description": "Actual Value (A)"
                },
                {
                  "key": "val2",
                  "value": "105",
                  "description": "Estimated Value (B)"
                },
                {
                  "key": "lang",
                  "value": "en"
                }
              ]
            },
            "description": "Calculates the percentage error between an estimated value and the actual value. Equation: (|Estimated - Actual| / Actual) * 100"
          },
          "response": []
        },
        {
          "name": "Formula 13 - Net Profit Calculator",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/api/calculate?formula=13&val1=1180&val2=500&val3=18&val4=20&lang=en",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "calculate"
              ],
              "query": [
                {
                  "key": "formula",
                  "value": "13"
                },
                {
                  "key": "val1",
                  "value": "1180",
                  "description": "Sales Price VAT Included (A)"
                },
                {
                  "key": "val2",
                  "value": "500",
                  "description": "Cost (B)"
                },
                {
                  "key": "val3",
                  "value": "18",
                  "description": "VAT Rate percentage (C)"
                },
                {
                  "key": "val4",
                  "value": "20",
                  "description": "Income Tax Rate percentage (D)"
                },
                {
                  "key": "lang",
                  "value": "en"
                }
              ]
            },
            "description": "Calculates the net profit after VAT and income tax. Equation: (Sales / (1 + VAT/100) - Cost) * (1 - Tax/100)"
          },
          "response": []
        }
      ]
    }
  ],
  "variable": [
    {
      "key": "baseUrl",
      "value": "https://www.ratias.com",
      "type": "string"
    }
  ]
}