Sign in
GET/calculators/savings-tax

Savings tax calculator

The UK Income Tax due on savings interest for a given income: Personal Allowance (with the £100k taper), the starting rate for savings, the Personal Savings Allowance, tax on the interest, net interest, how much interest is tax-free and the rate on the next £1.

View as Markdown
All endpoints

EndpointsChangelog

Pass interest, or amount and rate. Scotland supported. An estimate, not tax advice.

Cost

1 DS Credit

per request

Scope

any key

Same data as

—

the DepositScout website

Request

GET https://depositscout.com/api/developer/v1/calculators/savings-tax

  • income*query · number

    Yearly income other than savings interest, in pounds.

    Example: 45000

  • interestquery · number

    Yearly taxable savings interest, in pounds. Pass this, or amount and rate.

  • amountquery · number

    A balance in pounds, with rate.

    Example: 50000

  • ratequery · number

    The balance's AER, e.g. 4.5.

    Example: 4.5

  • regionquery · enum

    Where you pay Income Tax. Defaults to rest_of_uk.

    rest_of_ukscotland

Example

shell
curl "https://depositscout.com/api/developer/v1/calculators/savings-tax?income=45000&amount=50000&rate=4.5" \
  -H "Authorization: Bearer $DS_API_KEY"

Try it

Runs against this site. A ds_test_ key is free and returns sample data in the real shape; a live key returns real data and spends credits. The key is kept in this tab only.

No key yet? Create an account or sign in for a free test key.
GET /api/developer/v1/calculators/savings-tax?income=45000
as curl
curl "/api/developer/v1/calculators/savings-tax?income=45000" \
  -H "Authorization: Bearer ds_test_…"

Response

data is a single object. Every 2xx also sets X-DS-Request-Id, X-DS-Credits-Charged, X-DS-Credits-Balance, the X-RateLimit-* trio and an ETag.

response.json
{
  "data": {
    "…": "the item"
  },
  "meta": {
    "requestId": "req_7f3a9c2d1b4e5a6f7c8d",
    "generatedAt": "2026-09-21T09:00:00.000Z",
    "creditsCharged": 1,
    "creditsBalance": 199,
    "attribution": "Rates powered by DepositScout — depositscout.com"
  }
}

Errors

What this endpoint can return instead of data. Every error has the same shape: error (a stable code to branch on), message (what to do next), requestId and a docs link, plus the extra fields shown. None of them is charged.

401missing_api_key— No Authorization header, or it isn't a Bearer token.
401 missing_api_key.json
{
  "error": "missing_api_key",
  "message": "Send your key as 'Authorization: Bearer ds_live_…'. Create one at https://depositscout.com/developer.",
  "requestId": "req_7f3a9c2d1b4e5a6f7c8d",
  "docs": "https://depositscout.com/developers/docs#missing_api_key"
}
402insufficient_credits— Balance is lower than the call's cost. A list whose page you can't fully afford is cut to the rows your balance covers instead (meta.limit and X-DS-Limit-Reduced say so), so this only happens below one row's price. Body has required, balance and topUp.
402 insufficient_credits.json
{
  "error": "insufficient_credits",
  "message": "Not enough DS Credits for this request. Top up at https://depositscout.com/developer/credits.",
  "requestId": "req_7f3a9c2d1b4e5a6f7c8d",
  "docs": "https://depositscout.com/developers/docs#insufficient_credits",
  "required": 1,
  "balance": 0,
  "topUp": "https://depositscout.com/developer/credits"
}
429rate_limited— Burst or daily limit hit. Retry-After tells you when.
429 rate_limited.json
{
  "error": "rate_limited",
  "message": "Too many requests. Retry after 12s.",
  "requestId": "req_7f3a9c2d1b4e5a6f7c8d",
  "docs": "https://depositscout.com/developers/docs#rate_limited",
  "retryAfter": 12
}

Every code is listed in the shared error contract. Back to all endpoints.