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

ASC 842 lease accounting API

Lessee accounting under US GAAP ASC 842: lease liability, right-of-use asset and the schedule for a finance or an operating lease.

POST https://api.curatedapi.com/v1/calc/accounting/lease/asc842

Both classes start the same way: the liability is the present value of the unpaid lease payments, and the right-of-use asset adds initial direct costs and payments made at or before commencement, less incentives received. A finance lease then has interest on the liability and straight-line amortization of the asset. An operating lease has one straight-line lease cost (all payments plus initial direct costs, less incentives, spread evenly), and the asset is reduced by that cost less the interest on the liability (ASC 842-20-25-6 and 35-3).

Formula

liability = Σ payment × (1 + i)^−t; operating cost = (payments + IDC − incentives) / periods
  • By default (schedule_rounding: ledger) each period's interest and depreciation is rounded and the next period starts from the rounded balance, as when the entries are booked. With schedule_rounding: exact, each balance is the exact balance rounded and each charge is the change between rounded balances. Either way every row adds up and the last row ends at exactly zero; the two can differ by one unit in a period. The FASB's ASC 842 examples round the first way, the IASB's IFRS 16 examples and HMRC's the second.
  • Not covered: variable payments, remeasurement after a change in the lease, short-term and low-value exemptions, and sale-and-leaseback.
  • Asset retirement obligations are outside ASC 842 (ASC 410) and are not added to the asset here.

Inputs

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

InputTypeDescription
classification required finance | operating Lease classification. Options: finance: finance lease; operating: operating lease
payment required decimal (string) The first lease payment. Later payments rise by annual_increase_percent once a year. Allowed: >= 0 and <= 1000000000000000. Unit: currency.
payments_per_year 1 | 2 | 4 | 12
default 1
How often payments are made. Options: 1: yearly; 2: half-yearly; 4: quarterly; 12: monthly
number_of_payments required integer Number of payments over the lease term. Allowed: >= 1 and <= 600.
timing arrears | advance
default arrears
When each payment is made within its period. Options: arrears: at the end of each period; advance: at the start of each period (the first at commencement)
discount_rate_percent required decimal (string) Annual discount rate: the rate implicit in the lease or your incremental borrowing rate. Allowed: >= 0 and <= 100. Unit: percent.
rate_convention nominal | effective
default nominal
How the annual rate becomes a rate per period when payments are more often than yearly. Options: nominal: annual rate ÷ payments a year; effective: (1 + annual rate)^(1 / payments a year) − 1, to 15 decimals
annual_increase_percent decimal (string)
default 0
Fixed yearly increase in the payments (each new year's payment is rounded like the results). Allowed: >= 0 and <= 100. Unit: percent.
end_payment decimal (string)
default 0
Paid at the end of the term: a purchase option you are reasonably certain to exercise, a termination penalty, or the amount expected under a residual value guarantee. Allowed: >= 0 and <= 1000000000000000. Unit: currency.
initial_direct_costs decimal (string)
default 0
Initial direct costs (added to the asset). Allowed: >= 0 and <= 1000000000000000. Unit: currency.
lease_incentives decimal (string)
default 0
Lease incentives received (taken off the asset). Allowed: >= 0 and <= 1000000000000000. Unit: currency.
prepaid_payments decimal (string)
default 0
Lease payments made before commencement, other than the first payment in advance. Allowed: >= 0 and <= 1000000000000000. Unit: currency.
rou_life_periods integer Periods to depreciate the asset over: the lease term (the default) or the useful life when ownership transfers or a purchase option is reasonably certain. Allowed: >= 1 and <= 1200.
commencement_date required date (YYYY-MM-DD) Commencement date of the lease.
schedule_rounding ledger | exact
default ledger
How the schedule is rounded. Options: ledger: each period's interest and depreciation is rounded and the next period works from the rounded balance, as in a ledger; exact: each balance is the exact balance rounded, and each period's charge is the change in the rounded balances
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
classificationstringLease classification.
periodic_rate_percentstringDiscount rate per period, in percent.
initial_liabilitydecimal (string)Lease liability at commencement. Unit: currency.
initial_rou_assetdecimal (string)Right-of-use asset at commencement. Unit: currency.
total_paymentsdecimal (string)All payments in the schedule. Unit: currency.
total_interestdecimal (string)Interest over the term. Unit: currency.
rou_asset_end_of_termdecimal (string)Right-of-use asset left at the end of the term (above 0 when it is depreciated over a longer useful life). Unit: currency.
total_depreciationdecimal (string)Finance lease: amortization over the term. Unit: currency.
total_lease_costdecimal (string)Operating lease: total straight-line lease cost. Unit: currency.
schedulelist of objectOne row per payment period.

Examples

ASC 842 Example 4: operating lease, $10,000 rising 5% a year, 10 years at 6%

Requestcurl
curl https://api.curatedapi.com/v1/calc/accounting/lease/asc842 \
  -H "Authorization: Bearer $CURATEDAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "classification": "operating",
    "payment": "10000",
    "number_of_payments": 10,
    "annual_increase_percent": "5",
    "discount_rate_percent": "6",
    "initial_direct_costs": "5000",
    "lease_incentives": "10000",
    "commencement_date": "2026-01-01",
    "options": {"decimals": 0}
  }'
200 OKResponse
{
  "calculator": "accounting/lease/asc842@1",
  "result": {
    "classification": "operating",
    "periodic_rate_percent": "6",
    "initial_liability": "90434",
    "initial_rou_asset": "85434",
    "total_payments": "125779",
    "total_interest": "35345",
    "rou_asset_end_of_term": "0",
    "total_lease_cost": "120779",
    "schedule": [
      {
        "period": 1,
        "start": "2026-01-01",
        "end": "2026-12-31",
        "payment": "10000",
        "interest": "5426",
        "liability": "85860",
        "lease_cost": "12078",
        "rou_amortization": "6652",
        "rou_asset": "78782"
      },
      {
        "period": 2,
        "start": "2027-01-01",
        "end": "2027-12-31",
        "payment": "10500",
        "interest": "5152",
        "liability": "80512",
        "lease_cost": "12078",
        "rou_amortization": "6926",
        "rou_asset": "71856"
      },
      {
        "period": 3,
        "start": "2028-01-01",
        "end": "2028-12-31",
        "payment": "11025",
        "interest": "4831",
        "liability": "74318",
        "lease_cost": "12078",
        "rou_amortization": "7247",
        "rou_asset": "64609"
      },
      {
        "period": 4,
        "start": "2029-01-01",
        "end": "2029-12-31",
        "payment": "11576",
        "interest": "4459",
        "liability": "67201",
        "lease_cost": "12078",
        "rou_amortization": "7619",
        "rou_asset": "56990"
      },
      {
        "period": 5,
        "start": "2030-01-01",
        "end": "2030-12-31",
        "payment": "12155",
        "interest": "4032",
        "liability": "59078",
        "lease_cost": "12078",
        "rou_amortization": "8046",
        "rou_asset": "48944"
      },
      {
        "period": 6,
        "start": "2031-01-01",
        "end": "2031-12-31",
        "payment": "12763",
        "interest": "3545",
        "liability": "49860",
        "lease_cost": "12077",
        "rou_amortization": "8532",
        "rou_asset": "40412"
      },
      {
        "period": 7,
        "start": "2032-01-01",
        "end": "2032-12-31",
        "payment": "13401",
        "interest": "2992",
        "liability": "39451",
        "lease_cost": "12078",
        "rou_amortization": "9086",
        "rou_asset": "31326"
      },
      {
        "period": 8,
        "start": "2033-01-01",
        "end": "2033-12-31",
        "payment": "14071",
        "interest": "2367",
        "liability": "27747",
        "lease_cost": "12078",
        "rou_amortization": "9711",
        "rou_asset": "21615"
      },
      {
        "period": 9,
        "start": "2034-01-01",
        "end": "2034-12-31",
        "payment": "14775",
        "interest": "1665",
        "liability": "14637",
        "lease_cost": "12078",
        "rou_amortization": "10413",
        "rou_asset": "11202"
      },
      {
        "period": 10,
        "start": "2035-01-01",
        "end": "2035-12-31",
        "payment": "15513",
        "interest": "876",
        "liability": "0",
        "lease_cost": "12078",
        "rou_amortization": "11202",
        "rou_asset": "0"
      }
    ]
  },
  "exactness": {
    "initial_liability": "rounded",
    "initial_rou_asset": "rounded",
    "total_payments": "exact",
    "total_interest": "exact",
    "rou_asset_end_of_term": "exact",
    "total_lease_cost": "exact"
  },
  "precision": {
    "rounding": "half_even",
    "decimals": 0
  },
  "inputs": {
    "classification": "operating",
    "payment": "10000",
    "payments_per_year": "1",
    "number_of_payments": 10,
    "timing": "arrears",
    "discount_rate_percent": "6",
    "rate_convention": "nominal",
    "annual_increase_percent": "5",
    "end_payment": "0",
    "initial_direct_costs": "5000",
    "lease_incentives": "10000",
    "prepaid_payments": "0",
    "commencement_date": "2026-01-01",
    "schedule_rounding": "ledger"
  },
  "formula": "liability = Σ payment × (1 + i)^−t; operating cost = (payments + IDC − incentives) / periods",
  "references": [
    {
      "title": "FASB ASC 842-20 Leases, Lessee",
      "url": "https://asc.fasb.org/842/tableOfContent"
    },
    {
      "title": "ASC 842-20-55 Illustrations: Examples 3, 4 and 23 (Deloitte Roadmap: Leases)",
      "url": "https://dart.deloitte.com/USDART/home/codification/broad-transactions/asc842-10/roadmap-leases"
    }
  ],
  "warnings": []
}

ASC 842 Example 23: finance lease with a purchase option, asset amortized over its 7-year life

Requestcurl
curl https://api.curatedapi.com/v1/calc/accounting/lease/asc842 \
  -H "Authorization: Bearer $CURATEDAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "classification": "finance",
    "payment": "59000",
    "number_of_payments": 5,
    "end_payment": "5000",
    "discount_rate_percent": "6.5",
    "rou_life_periods": 7,
    "commencement_date": "2026-01-01",
    "options": {"decimals": 0}
  }'
200 OKResponse
{
  "calculator": "accounting/lease/asc842@1",
  "result": {
    "classification": "finance",
    "periodic_rate_percent": "6.5",
    "initial_liability": "248834",
    "initial_rou_asset": "248834",
    "total_payments": "300000",
    "total_interest": "51166",
    "rou_asset_end_of_term": "71094",
    "total_depreciation": "177740",
    "schedule": [
      {
        "period": 1,
        "start": "2026-01-01",
        "end": "2026-12-31",
        "payment": "59000",
        "interest": "16174",
        "liability": "206008",
        "depreciation": "35548",
        "rou_asset": "213286"
      },
      {
        "period": 2,
        "start": "2027-01-01",
        "end": "2027-12-31",
        "payment": "59000",
        "interest": "13391",
        "liability": "160399",
        "depreciation": "35548",
        "rou_asset": "177738"
      },
      {
        "period": 3,
        "start": "2028-01-01",
        "end": "2028-12-31",
        "payment": "59000",
        "interest": "10426",
        "liability": "111825",
        "depreciation": "35548",
        "rou_asset": "142190"
      },
      {
        "period": 4,
        "start": "2029-01-01",
        "end": "2029-12-31",
        "payment": "59000",
        "interest": "7269",
        "liability": "60094",
        "depreciation": "35548",
        "rou_asset": "106642"
      },
      {
        "period": 5,
        "start": "2030-01-01",
        "end": "2030-12-31",
        "payment": "64000",
        "interest": "3906",
        "liability": "0",
        "depreciation": "35548",
        "rou_asset": "71094"
      }
    ]
  },
  "exactness": {
    "initial_liability": "rounded",
    "initial_rou_asset": "rounded",
    "total_payments": "exact",
    "total_interest": "exact",
    "rou_asset_end_of_term": "exact",
    "total_depreciation": "exact"
  },
  "precision": {
    "rounding": "half_even",
    "decimals": 0
  },
  "inputs": {
    "classification": "finance",
    "payment": "59000",
    "payments_per_year": "1",
    "number_of_payments": 5,
    "timing": "arrears",
    "discount_rate_percent": "6.5",
    "rate_convention": "nominal",
    "annual_increase_percent": "0",
    "end_payment": "5000",
    "initial_direct_costs": "0",
    "lease_incentives": "0",
    "prepaid_payments": "0",
    "rou_life_periods": 7,
    "commencement_date": "2026-01-01",
    "schedule_rounding": "ledger"
  },
  "formula": "liability = Σ payment × (1 + i)^−t; operating cost = (payments + IDC − incentives) / periods",
  "references": [
    {
      "title": "FASB ASC 842-20 Leases, Lessee",
      "url": "https://asc.fasb.org/842/tableOfContent"
    },
    {
      "title": "ASC 842-20-55 Illustrations: Examples 3, 4 and 23 (Deloitte Roadmap: Leases)",
      "url": "https://dart.deloitte.com/USDART/home/codification/broad-transactions/asc842-10/roadmap-leases"
    }
  ],
  "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.