API Documentation

Geolocation API

API Base Path

The API base path is http://vital-saas.com/api.php?key={security-key}&ip={query}

{query} can be a single IPv4/IPv6 address or a domain name. If you don't supply a query the current IP address will be used.

Quick Test

http://vital-saas.com/api.php?key={security-key}&ip=24.48.0.1

You can edit this query and experiment with the options

GET

response
{
  "status": "success",
  "country": "Canada",
  "countryCode": "CA",
  "region": "QC",
  "regionName": "Quebec",
  "city": "Montreal",
  "zip": "H1K",
  "lat": 45.6085,
  "lon": -73.5493,
  "timezone": "America/Toronto",
  "isp": "Le Groupe Videotron Ltee",
  "org": "Videotron Ltee",
  "as": "AS5769 Videotron Ltee",
  "query": "24.48.0.1"
}
        	

Tax Calculation API

API Base Path

The API base path is http://vital-saas.com/api.php?key={security-key}&zip={query}

{query} can be a zip code.

Quick Test

http://vital-saas.com/api.php?key={security-key}&zip=90264

You can edit this query and experiment with the options

GET

response
{
  "version": "v40",
  "rCode": 100,
  "results": [
    {
      "geoPostalCode": "90264",
      "geoCity": "MALIBU",
      "geoCounty": "LOS ANGELES",
      "geoState": "CA",
      "taxSales": 0.095,
      "taxUse": 0.095,
      "txbService": "N",
      "txbFreight": "N",
      "stateSalesTax": 0.06,
      "stateUseTax": 0.06,
      "citySalesTax": 0,
      "cityUseTax": 0,
      "cityTaxCode": "",
      "countySalesTax": 0.0025,
      "countyUseTax": 0.0025,
      "countyTaxCode": "19",
      "districtSalesTax": 0.0325,
      "districtUseTax": 0.0325,
      "district1Code": "218",
      "district1SalesTax": 0,
      "district1UseTax": 0,
      "district2Code": "594",
      "district2SalesTax": 0.0225,
      "district2UseTax": 0.0225,
      "district3Code": "",
      "district3SalesTax": 0,
      "district3UseTax": 0,
      "district4Code": "19",
      "district4SalesTax": 0.01,
      "district4UseTax": 0.01,
      "district5Code": "",
      "district5SalesTax": 0,
      "district5UseTax": 0,
      "originDestination": "D"
    }
  ]
}
        	

Fx Conversion API

API Base Path

The API base path is http://vital-saas.com/api.php?key={seurity-key}&fx={query}

{query} can be a three character code for a currency e.g. EUR

Quick Test

http://vital-saas.com/api.php?key={seurity-key}&fx=EUR

You can edit this query and experiment with the options

GET

response
{
    "success": true,
    "timestamp": 1519296206,
    "base": "EUR",
    "date": "2024-03-17",
    "rates": {
        "AUD": 1.566015,
        "CAD": 1.560132,
        "CHF": 1.154727,
        "CNY": 7.827874,
        "GBP": 0.882047,
        "JPY": 132.360679,
        "USD": 1.23396,
    [...]
    }
}