Taxovation API

The Taxovation API allows you to exchange data with our platform to automate your tax obligations. With our API, developers and companies connect to Taxovation once to gain access to various tax automation products, including Tax Calculator and Tax Investigator for different transactions. This API documentation provides information about each endpoint in the API. Using this documeny you can see and try out sample requests and responses for each endpoint compatible with various programming languages.

Login

Request: POST

URL:

http://www.taxovation.com/auth/jwt/create/

Parameter Type Position #
username string Body Required
password string Body Required

Sample

{
"username": "User",
"password": "Pass123456"
}

Response

{
  "refresh": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ0b2tlbl90eXBlIjoicmVmcmVzaCIsImV4cCI6MTY5NTYyOTk0MiwianRpIjoiNWM0ZTU4Y2M1NjY1NDhlNWFjN2Q4N2IzODUyOTExOGYiLCJ1c2VyX2lkIjoxfQ.4ApSir00v6J9XPdKdDmYqZa45QuuVRL7QU9hXuWP83g",
  "access": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ0b2tlbl90eXBlIjoiYWNjZXNzIiwiZXhwIjoxNjY2Njg1OTQyLCJqdGkiOiI2NDM1MTcyZTU2ODQ0MDMzOThlMDA2ZDk1MmE2ZmFhZSIsInVzZXJfaWQiOjF9.6mEYGVxTxVB62VD0gcjMZHCUebbRFa9l_7RqhehMLic"
}

ATL API

Request: POST

URL:

http://www.taxovation.com/atl/atl_api/

Parameter Type Position #
ntn_cnic string Body Required
task string Body Required

Sample

{
"ntn_cnic": "7613991-0",
"task": "atl_st_fbr",
}

Response

{
    "data": {
        "Registration No": "6992086",
        "Name": "XPERT SUPPORT SERVICES (PRIVATE) LIMITED",
        "Business Name": "XPERT SUPPORT SERVICES (PRIVATE) LIMITED",
        "Status": "Active",
        "Jurisdiction": "FBR"
    }
}

Tax Calculator API

Request: POST

URL:

http://www.taxovation.com/calculator/tc_api/

Parameter Type Position #
seller_ntn string body Required
purchaser_ntn string Body Required
gross string Body Required
turnover string Body Required
type string Body Required
province string Body Required
schedule_item string Body Required

Sample

{
"seller_ntn": "0710622-0",
"purchaser_ntn": "0711579-2",
"gross": "250000",
"turnover": "checked",
"type": "services",
"province": "pra",
"schedule_item": "375"
}

Response

{
    "seller_data_it": {
        "ntn": "0710622",
        "name": "HASHWANI HOTELS LIMITED",
        "category": "Company formed and registered under the Companies Ordinance, 1984 or any other law repealed thereunder",
        "tax_office": "LTO KARACHI",
        "income_tax_status": "Active",
        "sales_tax_status": "  OPERATIVE",
        "principal_activities": "890113-Other service activities/SERVICES/HOTELS (SERVICES)",
        "evidence_seller_it": "FBR Company Details 0710622.png",
        "evidence_seller_atl": "FBR Company Status 0710622.png"
    },
    "purchaser_data_it": {
        "ntn": "0711579",
        "name": "CMPAK LIMITED",
        "category": "Company formed and registered under the Companies Ordinance, 1984 or any other law repealed thereunder",
        "tax_office": "LTO ISLAMABAD",
        "income_tax_status": "Active",
        "sales_tax_status": "  OPERATIVE",
        "principal_activities": "619000-Information and communication/Other telecommunications activities/Other telecommunications activities",
        "evidence_purchaser_it": "FBR Company Details 0711579.png",
        "evidence_purchaser_atl": "FBR Company Status 0711579.png"
    },
    "selected_data": {
        "seller_ntn": "0710622-0",
        "purchaser_ntn": "0711579-2",
        "gross": "250000",
        "turnover": "checked"
    },
    "seller_data_st": {
        "ntn": "0710622-0",
        "status": "INACTIVE",
        "principal_activity": "9801.1000 - Services provided or rendered by Hotels",
        "compliance_level": "Not Available",
        "evidence_seller_st": "PRA Sales Tax Details 0710622-0.png"
    },
    "purchaser_data_st": {
        "ntn": "0711579-2",
        "status": "ACTIVE",
        "principal_activity": "9812.1210 - CELLULAR TELEPHONE",
        "compliance_level": "Not Available",
        "evidence_purchaser_st": "PRA Sales Tax Details 0711579-2.png"
    },
    "description": "390. Fertilizers ",
    "table_data": {
        "gross_amount": "250,000.0",
        "sales_tax_rate": "0.0 %",
        "sales_tax": "0.0",
        "further_tax": 0,
        "exclusive_amount": "250,000.0",
        "income_tax_withheld": "20,000.0",
        "sales_tax_withheld": "0.0",
        "immediate_cash_movement": "230,000.0",
        "sales_tax_Remarks": "SALES TAX ACT 1990 - THE SIXTH SCHEDULE (TABLE-1).",
        "income_tax_withholding_remarks": "SERVICES  -  Seller's Catagory: COMPANY  -  Seller's Status: ACTIVE  -  Rate: 8 %",
        "sales_tax_withholding_remarks": "SERVICES - PRA - Seller's Catagory: COMPANY  -  Seller's Status: INACTIVE - Rate: Exempt Item (0%)",
        "income_tax_withholding_rate": 8.0,
        "sales_tax_withholding_rate": 0.0,
        "applicable_sales_tax_rate": 0.0
    }
}

Tax Investigator API

Request: POST

URL:

http://www.taxovation.com/investigator/ti_api/

Parameter Type Position #
ntn_cnic string Body Required
stin string Body Required
stid string Body Required
nature string Body Required
rate string Body Required
st string Body Required
province string Body Required

Sample

{
"ntn_cnic": "7613991-0",
"stin": "0231-PRA",
"stid": "2022-4-7",
"nature": "services",
"rate": "16",
"st": "244521",
"province": "PRA"
}

Response

{
    "ntn": "7613991-0",
    "ntn_portal": "None",
    "supplier": "",
    "sti": "0231-PRA",
    "sti_portal": "None",
    "date": "7/4/2022",
    "date_portal": "None",
    "nature": "SERVICES",
    "nature_portal": "",
    "rate": 16.0,
    "rate_portal": "None",
    "st": "244,521",
    "st_portal": "0",
    "jur": "FBR",
    "jur_portal": "FBR",
    "remarks": "FBR - NOT MATCHED",
    "stwh_portal": "0",
    "matched_pool": [],
    "accuracy": "N/A"
}

Check login status

Request: GET

URL:

http://www.taxovation.com/auth/users/me/

Response

{
"email": "user@gmail.com",
"id": 1,
"username": "User"
}