Prepare ITR

Income Tax Return (ITR) has prescribed format in which tax payers have to furnish their computation of income and tax including incomes, tax deductions, tax credits, bank accounts etc

Overview

Use this API to generate ITR JSON as prescribed by Income Tax Department

Problem

  • Financial institutions and Fin-Tech organizations have user data related to Capital Gains, Salary, Business and Profession, or other sources, as this data is not linked to the income tax department appropriately, users face difficulty preparing their Income Tax Returns.
  • Tax-payers may face difficulty in calculating and reporting taxes during the tax-filing season due to a disconnect in data.
  • Tax-payers may face problems filing their taxes themselves which can lead to errors, which in turn lead to multiple revisions in tax returns.
  • Tax-payers may miss crucial information while reporting Income Tax and receive notices from the IT department
  • Income Tax Return may be rejected by Income Tax Department due to incorrect, inaccurate and incomplete information.

Solution

  • The API will automate the generation of JSON that can be uploaded directly to the Income Tax portal.

Endpoint

HTTP MethodResource
POSTitr-reporting/taxpayer/{pan}/itrs/{assessment_year}/

API Endpoint  Contact Us  Free Trial

Request

Path Parameter

ParamTypeDescriptionExample
panstringPAN of individualACPPA2608F
assessment_yearstringAY for which ITR is being prepared2021-22, 2022-23

Body

ParamTypeDescriptionExample
RAW_BODYjsonIncome Tax ReturnSee Payload

Sample CURL Request

{
  curl --request POST \
     --url https://api.sandbox.co.in/itr-reporting/taxpayer/pan/itrs/assessment_year/ \
     --header 'accept: application/json' \
     --header 'authorization: xxxxxxxx' \
     --header 'content-type: application/json' \
     --header 'x-api-key: xxxxxxxxxx' \
     --header 'x-api-version: 1.0'
{
    "incomes": [
        {
            "tds": {
                "tax_amount": 365500,
                "tan": "DHGK47639U",
                "financial_year": "FY 2021-22",
                "income_head": "Salary",
                "credit_amount": 1455000,
                "deductor": "Acne Infosoft",
                "id": "F7DD5B81BD471A3EE0530100007F8A86",
                "@entity": "tds"
            },
            "gross_income": 1630000,
            "deductions": [
                {
                    "qualified": 0,
                    "section": "16(ii)",
                    "id": "F7DD92B630DD266AE0530100007F9A70",
                    "is_chapter_vi_a": false,
                    "@entity": "deduction"
                },
                {
                    "qualified": 5000,
                    "section": "16(iii)",
                    "id": "F7DD92B630DE266AE0530100007F9A70",
                    "is_chapter_vi_a": false,
                    "@entity": "deduction"
                },
                {
                    "qualified": 50000,
                    "section": "16(ia)",
                    "id": "F7DD92B630DC266AE0530100007F9A70",
                    "is_chapter_vi_a": false,
                    "@entity": "deduction"
                }
            ],
            "@entity": "salary",
            "head": "Salary",
            "perquisites": 20000,
            "is_foreign": false,
            "is_exempt": false,
            "basic_salary": 1600000,
            "employer": {
                "address": {
                    "area": "Vastrapur",
                    "country": "India",
                    "city": "Ahmedabad",
                    "street": "Vastrapur Lake",
                    "id": "22CD7221504894CDA6B1333BBCC9DA0B",
                    "state": "Gujarat",
                    "postal_code": "380015",
                    "@entity": "address"
                },
                "name": "Acne Infosoft",
                "category": "Other",
                "@entity": "employer"
            },
            "id": "22CD7221504894CDA6B1333BBCC9DA0B",
            "allowances": [
                {
                    "qualified": 80000,
                    "is_exempt": true,
                    "section": "10(5)",
                    "id": "F7DD92B630DF266AE0530100007F9A70",
                    "@entity": "allowance"
                },
                {
                    "qualified": 0,
                    "is_exempt": true,
                    "section": "10(10)",
                    "id": "F7DD92B630E0266AE0530100007F9A70",
                    "@entity": "allowance"
                },
                {
                    "qualified": 0,
                    "is_exempt": true,
                    "section": "10(10AA)",
                    "id": "F7DD92B630E4266AE0530100007F9A70",
                    "@entity": "allowance"
                },
                {
                    "qualified": 0,
                    "is_exempt": true,
                    "section": "10(10A)",
                    "id": "F7DD92B630E2266AE0530100007F9A70",
                    "@entity": "allowance"
                },
                {
                    "qualified": 40000,
                    "is_exempt": true,
                    "section": "10(13A)",
                    "id": "F7DD92B630E3266AE0530100007F9A70",
                    "@entity": "allowance"
                },
                {
                    "qualified": 0,
                    "is_exempt": true,
                    "section": "10",
                    "id": "F7DD92B630E1266AE0530100007F9A70",
                    "@entity": "allowance"
                }
            ],
            "profit": 10000
        },
        {
            "co_owners": [],
            "address": {
                "area": "Navrangpura",
                "country": "India",
                "city": "Ahmedabad",
                "street": "HL College",
                "id": "F7DD92B630E5266AE0530100007F9A70",
                "state": "Gujarat",
                "postal_code": "380015",
                "@entity": "address"
            },
            "deductions": [],
            "@entity": "self_occupied_house_property_income",
            "head": "House Property",
            "exemptions": [
                {
                    "qualified": 0,
                    "section": "24(b)",
                    "id": "F7DD92B630E6266AE0530100007F9A70",
                    "@entity": "exemption"
                }
            ],
            "is_foreign": false,
            "is_exempt": false,
            "sub_head": "Self Occupied",
            "id": "716B8997477AD8B14D64A493A2A68CE9",
        },
        {
            "head": "Other",
            "gross_income": 6982,
            "is_foreign": false,
            "is_exempt": false,
            "sub_head": "Savings Interest",
            "id": "F7DD5B81BD481A3EE0530100007F8A86",
            "deductions": [],
            "@entity": "other_income"
        },
        {
            "head": "Other",
            "gross_income": 25000,
            "is_foreign": false,
            "is_exempt": false,
            "sub_head": "Fixed Deposit Interest",
            "id": "F7DD5B81BD491A3EE0530100007F8A86",
            "deductions": [],
            "@entity": "other_income"
        },
        {
            "head": "Other",
            "gross_income": 0,
            "is_foreign": false,
            "is_exempt": false,
            "sub_head": "Interest on Tax Refund",
            "id": "F7DD5B81BD4A1A3EE0530100007F8A86",
            "deductions": [],
            "@entity": "other_income"
        },
        {
            "head": "Other",
            "gross_income": 0,
            "is_foreign": false,
            "is_exempt": false,
            "sub_head": "Other Interest",
            "id": "F7DD5B81BD4B1A3EE0530100007F8A86",
            "deductions": [],
            "@entity": "other_income"
        },
        {
            "head": "Other",
            "gross_income": 15000,
            "is_foreign": false,
            "is_exempt": true,
            "sub_head": "PPF Interest",
            "id": "F7DD5B81BD521A3EE0530100007F8A86",
            "deductions": [],
            "@entity": "other_income"
        },
        {
            "head": "Other",
            "gross_income": 27000,
            "is_foreign": false,
            "is_exempt": true,
            "sub_head": "Other Exempt Income",
            "id": "F7DD5B81BD531A3EE0530100007F8A86",
            "deductions": [],
            "@entity": "other_income"
        },
        {
            "head": "Other",
            "gross_income": 30000,
            "is_foreign": false,
            "is_exempt": true,
            "sub_head": "Gift",
            "id": "F7DD5B81BD541A3EE0530100007F8A86",
            "deductions": [],
            "@entity": "other_income"
        },
        {
            "head": "Other",
            "gross_income": 12000,
            "is_foreign": false,
            "is_exempt": false,
            "sub_head": "Dividend from Domestic Company",
            "id": "F7DD92B630F1266AE0530100007F9A70",
            "deductions": [],
            "@entity": "dividend_income",
            "quarter": 1
        },
        {
            "head": "Other",
            "gross_income": 12000,
            "is_foreign": false,
            "is_exempt": false,
            "sub_head": "Dividend from Domestic Company",
            "id": "F7DD92B630F2266AE0530100007F9A70",
            "deductions": [],
            "@entity": "dividend_income",
            "quarter": 2
        },
        {
            "head": "Other",
            "gross_income": 15000,
            "is_foreign": false,
            "is_exempt": false,
            "sub_head": "Dividend from Domestic Company",
            "id": "F7DD92B630F3266AE0530100007F9A70",
            "deductions": [],
            "@entity": "dividend_income",
            "quarter": 3
        },
        {
            "head": "Other",
            "gross_income": 17000,
            "is_foreign": false,
            "is_exempt": false,
            "sub_head": "Dividend from Domestic Company",
            "id": "F7DD92B630F4266AE0530100007F9A70",
            "deductions": [],
            "@entity": "dividend_income",
            "quarter": 4
        },
        {
            "head": "Other",
            "gross_income": 0,
            "is_foreign": false,
            "is_exempt": false,
            "sub_head": "Family Pension",
            "id": "F7DD92B630F9266AE0530100007F9A70",
            "deductions": [],
            "@entity": "other_income"
        },
        {
            "head": "Other",
            "gross_income": 20000,
            "is_foreign": false,
            "is_exempt": false,
            "sub_head": "Income From Other Sources",
            "id": "F7DD92B630FA266AE0530100007F9A70",
            "deductions": [],
            "@entity": "other_income"
        },
        {
            "head": "Other",
            "gross_income": 0,
            "is_foreign": false,
            "is_exempt": false,
            "sub_head": "Dividend from Foreign Company",
            "id": "F7DD92B630FB266AE0530100007F9A70",
            "deductions": [],
            "@entity": "other_income"
        }
    ],
    "regime_action": "Opt In",
    "regime": "New",
    "assessment_year": "AY 2022-23",
    "due_date": "31/07/2022",
    "form_10_ie_acknowledgement_number": "746284759374836",
    "type": "Original",
    "tax_credits": [
        {
            "tax_amount": 365500,
            "tan": "DHGK47639U",
            "financial_year": "FY 2021-22",
            "income_head": "Salary",
            "credit_amount": 1455000,
            "deductor": "Acne Infosoft",
            "id": "F7DD5B81BD471A3EE0530100007F8A86",
            "@entity": "tds"
        }
    ],
    "@entity": "itr_1",
    "form": "ITR-1",
    "tax_payer": {
        "address": {
            "area": "Mumatpura",
            "country": "India",
            "city": "Ahmedabad",
            "street": "Mumatpura Road",
            "id": "C31ADB50645E4B94EB68ABEE622C2330",
            "state": "Gujarat",
            "postal_code": "380047",
            "@entity": "address"
        },
        "filing_category": "General",
        "gender": "Male",
        "last_name": "Curram",
        "pan_holder_type": "Individual",
        "@entity": "individual",
        "dob": "25/04/1995",
        "contact": {
            "country_code": "91",
            "mobile": "8226795678",
            "id": "C31ADB50645E4B94EB68ABEE622C2330",
            "email": "[email protected]",
            "@entity": "contact"
        },
        "residential_status": "Resident",
        "aadhaar": "738298734567",
        "id": "C31ADB50645E4B94EB68ABEE622C2330",
        "tax_payer_status": "Active",
        "pan": "AJFPA4867Q",
        "first_name": "Sam",
        "fathers_name": "Jimmy"
    },
    "filed_under_section": "After the due date u/s 139(4)",
    "filed_on": "22/03/2023",
    "id": "49490557E6220D2A96D27ADD46C19723",
    "bank_accounts": [
        {
            "account_number": "231293120",
            "country": "India",
            "is_refund_account": true,
            "bank_name": "SBI",
            "id": "75947736D4717C21C82156B33A93DBD2",
            "type": "Savings",
            "ifsc": "SBIN0021260",
            "is_foreign_account": false,
            "@entity": "bank_account"
        }
    ],
    "chapter_vi_a_deductions": [
        {
            "qualified": 50000,
            "section": "16(ia)",
            "id": "F7DD92B630DC266AE0530100007F9A70",
            "is_chapter_vi_a": false,
            "@entity": "deduction"
        },
        {
            "qualified": 5000,
            "section": "16(iii)",
            "id": "F7DD92B630DE266AE0530100007F9A70",
            "is_chapter_vi_a": false,
            "@entity": "deduction"
        },
        {
            "qualified": 0,
            "section": "16(ii)",
            "id": "F7DD92B630DD266AE0530100007F9A70",
            "is_chapter_vi_a": false,
            "@entity": "deduction"
        }
    ],
    "status": "In Progress",
    "is_audit_liable": false
}

Response

Success: 200

unprocessable entityTypeDescriptionExample
datajsonIncome Tax ReturnSee ITR

Unprocessable entity: 422

unprocessable entityTypeDescriptionExample
datajsonValidate Income Tax ReturnSee Validate ITR