curatedapi
Browse the docs

Guides

Finance

Excel functions

Late payments

E-invoices

Accounting

Number checks

VAT and GST

Billing and pricing

Money and currencies

Dates and time

Math

Unit conversion

Everyday

Health

MACRS depreciation (IRS tables, GDS) API

US tax depreciation under MACRS (GDS) with the IRS percentage tables, Section 179 and bonus depreciation.

POST https://api.curatedapi.com/v1/calc/accounting/depreciation/macrs

Applies the Publication 946 Appendix A tables: half-year or mid-quarter for personal property (Tables A-1 to A-5), mid-month for residential rental (A-6, 27.5 years) and nonresidential real property (A-7a, 39 years). Section 179 comes off first, then bonus depreciation on what is left, then MACRS on the rest. Each year is basis × the table percentage, rounded; the last year takes whatever rounding left over, so the years add up exactly to the basis.

Formula

depreciation = (basis − §179 − bonus) × table percentage
  • This is the General Depreciation System. ADS, listed property used 50% or less for business, short tax years and dispositions are not covered.
  • Every table column was rebuilt from the IRS method and checked against the printed tables; where the printed table differs (7-year mid-quarter Q2, 20-year mid-quarter Q1), the printed value is used.

Inputs

Send numbers as strings to keep every digit. options sets precision and rounding (see numbers and rounding).

InputTypeDescription
basis required decimal (string) Depreciable basis: the cost, plus costs to get the property ready, less any business-use reduction. Allowed: > 0 and <= 1000000000000000. Unit: currency.
property_class required 3 | 5 | 7 | 10 | 15 | 20 | 27.5 | 39 Recovery period (property class). Options: 3: 3-year property (200% declining balance); 5: 5-year property such as cars, computers and office machinery (200% DB); 7: 7-year property such as office furniture and fixtures (200% DB); 10: 10-year property (200% DB); 15: 15-year property such as land improvements (150% DB); 20: 20-year property such as farm buildings (150% DB); 27.5: 27.5-year residential rental property (straight line, mid-month); 39: 39-year nonresidential real property (straight line, mid-month)
placed_in_service required date (YYYY-MM-DD) The day the property was placed in service.
convention half_year | mid_quarter
default half_year
Convention for personal property. 27.5- and 39-year property always use mid-month, whatever is passed. Options: half_year: half a year of depreciation in the first year (the usual case); mid_quarter: when more than 40% of the year's basis was placed in service in the last quarter
tax_year_start_month integer
default 1
Month your tax year starts (1 = calendar year). Short tax years are not supported. Allowed: >= 1 and <= 12.
section_179 decimal (string)
default 0
Section 179 deduction taken for the property. The dollar limit and business-income limit are not checked. Allowed: >= 0 and <= 1000000000000000. Unit: currency.
bonus_percent decimal (string)
default 0
Special (bonus) depreciation percentage, e.g. 100 or 40, or 0 if you elect out. Allowed: >= 0 and <= 100. Unit: percent.
options.rounding half_even | half_up | half_down | up | down | ceiling | floor Rounding mode applied once to each result. Default half_even.
options.decimals integer Round results to this many digits after the decimal point.

Result

Under result in the answer, next to exactness, precision, inputs, formula, references and warnings.

ResultTypeDescription
conventionstringConvention used.
section_179decimal (string)Section 179 deduction. Unit: currency.
bonus_depreciationdecimal (string)Special depreciation allowance. Unit: currency.
macrs_basisdecimal (string)Basis left for MACRS. Unit: currency.
first_year_totaldecimal (string)Section 179 + bonus + year 1 MACRS. Unit: currency.
schedulelist of objectMACRS by recovery year.

Examples

5-year property, $10,000, half-year: 20%, 32%, 19.2%, 11.52%, 11.52%, 5.76%

Requestcurl
curl https://api.curatedapi.com/v1/calc/accounting/depreciation/macrs \
  -H "Authorization: Bearer $CURATEDAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "basis": "10000",
    "property_class": "5",
    "placed_in_service": "2026-03-15"
  }'
200 OKResponse
{
  "calculator": "accounting/depreciation/macrs@1",
  "result": {
    "convention": "half_year",
    "section_179": "0.00",
    "bonus_depreciation": "0.00",
    "macrs_basis": "10000.00",
    "first_year_total": "2000.00",
    "schedule": [
      {
        "year": 1,
        "tax_year_start": "2026-01-01",
        "percent": "20.00",
        "depreciation": "2000.00",
        "accumulated": "2000.00",
        "remaining": "8000.00"
      },
      {
        "year": 2,
        "tax_year_start": "2027-01-01",
        "percent": "32.00",
        "depreciation": "3200.00",
        "accumulated": "5200.00",
        "remaining": "4800.00"
      },
      {
        "year": 3,
        "tax_year_start": "2028-01-01",
        "percent": "19.20",
        "depreciation": "1920.00",
        "accumulated": "7120.00",
        "remaining": "2880.00"
      },
      {
        "year": 4,
        "tax_year_start": "2029-01-01",
        "percent": "11.52",
        "depreciation": "1152.00",
        "accumulated": "8272.00",
        "remaining": "1728.00"
      },
      {
        "year": 5,
        "tax_year_start": "2030-01-01",
        "percent": "11.52",
        "depreciation": "1152.00",
        "accumulated": "9424.00",
        "remaining": "576.00"
      },
      {
        "year": 6,
        "tax_year_start": "2031-01-01",
        "percent": "5.76",
        "depreciation": "576.00",
        "accumulated": "10000.00",
        "remaining": "0.00"
      }
    ]
  },
  "exactness": {
    "section_179": "exact",
    "bonus_depreciation": "exact",
    "macrs_basis": "exact",
    "first_year_total": "exact"
  },
  "precision": {
    "rounding": "half_even",
    "decimals": 2
  },
  "inputs": {
    "basis": "10000",
    "property_class": "5",
    "placed_in_service": "2026-03-15",
    "convention": "half_year",
    "tax_year_start_month": 1,
    "section_179": "0",
    "bonus_percent": "0"
  },
  "formula": "depreciation = (basis − §179 − bonus) × table percentage",
  "references": [
    {
      "title": "IRS Publication 946, How To Depreciate Property, Appendix A tables",
      "url": "https://www.irs.gov/publications/p946"
    },
    {
      "title": "26 U.S. Code § 168 (MACRS)",
      "url": "https://www.law.cornell.edu/uscode/text/26/168"
    }
  ],
  "warnings": []
}

39-year building placed in service in January: 2.461% in year 1

Requestcurl
curl https://api.curatedapi.com/v1/calc/accounting/depreciation/macrs \
  -H "Authorization: Bearer $CURATEDAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "basis": "1000000",
    "property_class": "39",
    "placed_in_service": "2026-01-10"
  }'
200 OKResponse
{
  "calculator": "accounting/depreciation/macrs@1",
  "result": {
    "convention": "mid_month",
    "section_179": "0.00",
    "bonus_depreciation": "0.00",
    "macrs_basis": "1000000.00",
    "first_year_total": "24610.00",
    "schedule": [
      {
        "year": 1,
        "tax_year_start": "2026-01-01",
        "percent": "2.461",
        "depreciation": "24610.00",
        "accumulated": "24610.00",
        "remaining": "975390.00"
      },
      {
        "year": 2,
        "tax_year_start": "2027-01-01",
        "percent": "2.564",
        "depreciation": "25640.00",
        "accumulated": "50250.00",
        "remaining": "949750.00"
      },
      {
        "year": 3,
        "tax_year_start": "2028-01-01",
        "percent": "2.564",
        "depreciation": "25640.00",
        "accumulated": "75890.00",
        "remaining": "924110.00"
      },
      {
        "year": 4,
        "tax_year_start": "2029-01-01",
        "percent": "2.564",
        "depreciation": "25640.00",
        "accumulated": "101530.00",
        "remaining": "898470.00"
      },
      {
        "year": 5,
        "tax_year_start": "2030-01-01",
        "percent": "2.564",
        "depreciation": "25640.00",
        "accumulated": "127170.00",
        "remaining": "872830.00"
      },
      {
        "year": 6,
        "tax_year_start": "2031-01-01",
        "percent": "2.564",
        "depreciation": "25640.00",
        "accumulated": "152810.00",
        "remaining": "847190.00"
      },
      {
        "year": 7,
        "tax_year_start": "2032-01-01",
        "percent": "2.564",
        "depreciation": "25640.00",
        "accumulated": "178450.00",
        "remaining": "821550.00"
      },
      {
        "year": 8,
        "tax_year_start": "2033-01-01",
        "percent": "2.564",
        "depreciation": "25640.00",
        "accumulated": "204090.00",
        "remaining": "795910.00"
      },
      {
        "year": 9,
        "tax_year_start": "2034-01-01",
        "percent": "2.564",
        "depreciation": "25640.00",
        "accumulated": "229730.00",
        "remaining": "770270.00"
      },
      {
        "year": 10,
        "tax_year_start": "2035-01-01",
        "percent": "2.564",
        "depreciation": "25640.00",
        "accumulated": "255370.00",
        "remaining": "744630.00"
      },
      {
        "year": 11,
        "tax_year_start": "2036-01-01",
        "percent": "2.564",
        "depreciation": "25640.00",
        "accumulated": "281010.00",
        "remaining": "718990.00"
      },
      {
        "year": 12,
        "tax_year_start": "2037-01-01",
        "percent": "2.564",
        "depreciation": "25640.00",
        "accumulated": "306650.00",
        "remaining": "693350.00"
      },
      {
        "year": 13,
        "tax_year_start": "2038-01-01",
        "percent": "2.564",
        "depreciation": "25640.00",
        "accumulated": "332290.00",
        "remaining": "667710.00"
      },
      {
        "year": 14,
        "tax_year_start": "2039-01-01",
        "percent": "2.564",
        "depreciation": "25640.00",
        "accumulated": "357930.00",
        "remaining": "642070.00"
      },
      {
        "year": 15,
        "tax_year_start": "2040-01-01",
        "percent": "2.564",
        "depreciation": "25640.00",
        "accumulated": "383570.00",
        "remaining": "616430.00"
      },
      {
        "year": 16,
        "tax_year_start": "2041-01-01",
        "percent": "2.564",
        "depreciation": "25640.00",
        "accumulated": "409210.00",
        "remaining": "590790.00"
      },
      {
        "year": 17,
        "tax_year_start": "2042-01-01",
        "percent": "2.564",
        "depreciation": "25640.00",
        "accumulated": "434850.00",
        "remaining": "565150.00"
      },
      {
        "year": 18,
        "tax_year_start": "2043-01-01",
        "percent": "2.564",
        "depreciation": "25640.00",
        "accumulated": "460490.00",
        "remaining": "539510.00"
      },
      {
        "year": 19,
        "tax_year_start": "2044-01-01",
        "percent": "2.564",
        "depreciation": "25640.00",
        "accumulated": "486130.00",
        "remaining": "513870.00"
      },
      {
        "year": 20,
        "tax_year_start": "2045-01-01",
        "percent": "2.564",
        "depreciation": "25640.00",
        "accumulated": "511770.00",
        "remaining": "488230.00"
      },
      {
        "year": 21,
        "tax_year_start": "2046-01-01",
        "percent": "2.564",
        "depreciation": "25640.00",
        "accumulated": "537410.00",
        "remaining": "462590.00"
      },
      {
        "year": 22,
        "tax_year_start": "2047-01-01",
        "percent": "2.564",
        "depreciation": "25640.00",
        "accumulated": "563050.00",
        "remaining": "436950.00"
      },
      {
        "year": 23,
        "tax_year_start": "2048-01-01",
        "percent": "2.564",
        "depreciation": "25640.00",
        "accumulated": "588690.00",
        "remaining": "411310.00"
      },
      {
        "year": 24,
        "tax_year_start": "2049-01-01",
        "percent": "2.564",
        "depreciation": "25640.00",
        "accumulated": "614330.00",
        "remaining": "385670.00"
      },
      {
        "year": 25,
        "tax_year_start": "2050-01-01",
        "percent": "2.564",
        "depreciation": "25640.00",
        "accumulated": "639970.00",
        "remaining": "360030.00"
      },
      {
        "year": 26,
        "tax_year_start": "2051-01-01",
        "percent": "2.564",
        "depreciation": "25640.00",
        "accumulated": "665610.00",
        "remaining": "334390.00"
      },
      {
        "year": 27,
        "tax_year_start": "2052-01-01",
        "percent": "2.564",
        "depreciation": "25640.00",
        "accumulated": "691250.00",
        "remaining": "308750.00"
      },
      {
        "year": 28,
        "tax_year_start": "2053-01-01",
        "percent": "2.564",
        "depreciation": "25640.00",
        "accumulated": "716890.00",
        "remaining": "283110.00"
      },
      {
        "year": 29,
        "tax_year_start": "2054-01-01",
        "percent": "2.564",
        "depreciation": "25640.00",
        "accumulated": "742530.00",
        "remaining": "257470.00"
      },
      {
        "year": 30,
        "tax_year_start": "2055-01-01",
        "percent": "2.564",
        "depreciation": "25640.00",
        "accumulated": "768170.00",
        "remaining": "231830.00"
      },
      {
        "year": 31,
        "tax_year_start": "2056-01-01",
        "percent": "2.564",
        "depreciation": "25640.00",
        "accumulated": "793810.00",
        "remaining": "206190.00"
      },
      {
        "year": 32,
        "tax_year_start": "2057-01-01",
        "percent": "2.564",
        "depreciation": "25640.00",
        "accumulated": "819450.00",
        "remaining": "180550.00"
      },
      {
        "year": 33,
        "tax_year_start": "2058-01-01",
        "percent": "2.564",
        "depreciation": "25640.00",
        "accumulated": "845090.00",
        "remaining": "154910.00"
      },
      {
        "year": 34,
        "tax_year_start": "2059-01-01",
        "percent": "2.564",
        "depreciation": "25640.00",
        "accumulated": "870730.00",
        "remaining": "129270.00"
      },
      {
        "year": 35,
        "tax_year_start": "2060-01-01",
        "percent": "2.564",
        "depreciation": "25640.00",
        "accumulated": "896370.00",
        "remaining": "103630.00"
      },
      {
        "year": 36,
        "tax_year_start": "2061-01-01",
        "percent": "2.564",
        "depreciation": "25640.00",
        "accumulated": "922010.00",
        "remaining": "77990.00"
      },
      {
        "year": 37,
        "tax_year_start": "2062-01-01",
        "percent": "2.564",
        "depreciation": "25640.00",
        "accumulated": "947650.00",
        "remaining": "52350.00"
      },
      {
        "year": 38,
        "tax_year_start": "2063-01-01",
        "percent": "2.564",
        "depreciation": "25640.00",
        "accumulated": "973290.00",
        "remaining": "26710.00"
      },
      {
        "year": 39,
        "tax_year_start": "2064-01-01",
        "percent": "2.564",
        "depreciation": "25640.00",
        "accumulated": "998930.00",
        "remaining": "1070.00"
      },
      {
        "year": 40,
        "tax_year_start": "2065-01-01",
        "percent": "0.107",
        "depreciation": "1070.00",
        "accumulated": "1000000.00",
        "remaining": "0.00"
      }
    ]
  },
  "exactness": {
    "section_179": "exact",
    "bonus_depreciation": "exact",
    "macrs_basis": "exact",
    "first_year_total": "exact"
  },
  "precision": {
    "rounding": "half_even",
    "decimals": 2
  },
  "inputs": {
    "basis": "1000000",
    "property_class": "39",
    "placed_in_service": "2026-01-10",
    "convention": "half_year",
    "tax_year_start_month": 1,
    "section_179": "0",
    "bonus_percent": "0"
  },
  "formula": "depreciation = (basis − §179 − bonus) × table percentage",
  "references": [
    {
      "title": "IRS Publication 946, How To Depreciate Property, Appendix A tables",
      "url": "https://www.irs.gov/publications/p946"
    },
    {
      "title": "26 U.S. Code § 168 (MACRS)",
      "url": "https://www.law.cornell.edu/uscode/text/26/168"
    }
  ],
  "warnings": []
}

7-year equipment: $100,000 with $20,000 Section 179 and 40% bonus

Requestcurl
curl https://api.curatedapi.com/v1/calc/accounting/depreciation/macrs \
  -H "Authorization: Bearer $CURATEDAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "basis": "100000",
    "property_class": "7",
    "placed_in_service": "2026-05-01",
    "section_179": "20000",
    "bonus_percent": "40"
  }'
200 OKResponse
{
  "calculator": "accounting/depreciation/macrs@1",
  "result": {
    "convention": "half_year",
    "section_179": "20000.00",
    "bonus_depreciation": "32000.00",
    "macrs_basis": "48000.00",
    "first_year_total": "58859.20",
    "schedule": [
      {
        "year": 1,
        "tax_year_start": "2026-01-01",
        "percent": "14.29",
        "depreciation": "6859.20",
        "accumulated": "6859.20",
        "remaining": "41140.80"
      },
      {
        "year": 2,
        "tax_year_start": "2027-01-01",
        "percent": "24.49",
        "depreciation": "11755.20",
        "accumulated": "18614.40",
        "remaining": "29385.60"
      },
      {
        "year": 3,
        "tax_year_start": "2028-01-01",
        "percent": "17.49",
        "depreciation": "8395.20",
        "accumulated": "27009.60",
        "remaining": "20990.40"
      },
      {
        "year": 4,
        "tax_year_start": "2029-01-01",
        "percent": "12.49",
        "depreciation": "5995.20",
        "accumulated": "33004.80",
        "remaining": "14995.20"
      },
      {
        "year": 5,
        "tax_year_start": "2030-01-01",
        "percent": "8.93",
        "depreciation": "4286.40",
        "accumulated": "37291.20",
        "remaining": "10708.80"
      },
      {
        "year": 6,
        "tax_year_start": "2031-01-01",
        "percent": "8.92",
        "depreciation": "4281.60",
        "accumulated": "41572.80",
        "remaining": "6427.20"
      },
      {
        "year": 7,
        "tax_year_start": "2032-01-01",
        "percent": "8.93",
        "depreciation": "4286.40",
        "accumulated": "45859.20",
        "remaining": "2140.80"
      },
      {
        "year": 8,
        "tax_year_start": "2033-01-01",
        "percent": "4.46",
        "depreciation": "2140.80",
        "accumulated": "48000.00",
        "remaining": "0.00"
      }
    ]
  },
  "exactness": {
    "section_179": "exact",
    "bonus_depreciation": "exact",
    "macrs_basis": "exact",
    "first_year_total": "exact"
  },
  "precision": {
    "rounding": "half_even",
    "decimals": 2
  },
  "inputs": {
    "basis": "100000",
    "property_class": "7",
    "placed_in_service": "2026-05-01",
    "convention": "half_year",
    "tax_year_start_month": 1,
    "section_179": "20000",
    "bonus_percent": "40"
  },
  "formula": "depreciation = (basis − §179 − bonus) × table percentage",
  "references": [
    {
      "title": "IRS Publication 946, How To Depreciate Property, Appendix A tables",
      "url": "https://www.irs.gov/publications/p946"
    },
    {
      "title": "26 U.S. Code § 168 (MACRS)",
      "url": "https://www.law.cornell.edu/uscode/text/26/168"
    }
  ],
  "warnings": []
}

References

Results follow each calculator's documented rules and the sources listed. They are not financial, tax or legal advice. Check that the rules fit your case before you rely on a result. See the terms.

Errors share one format; see errors. Billing, retries and batches work the same for every endpoint.