Sign in
GET/calculators/isa-allowance

ISA allowance calculator

What's left of this tax year's ISA allowance after what's been paid in, for an adult, Junior or Lifetime ISA, with the Lifetime ISA bonus and upcoming allowance changes.

View as Markdown
All endpoints

EndpointsChangelog

Cost

1 DS Credit

per request

Scope

any key

Same data as

—

the DepositScout website

Request

GET https://depositscout.com/api/developer/v1/calculators/isa-allowance

  • typequery · enum

    Which allowance. Defaults to adult.

    Example: adult

    adultjuniorlifetime
  • paidInquery · number

    Paid in so far this tax year, in pounds. Defaults to 0.

    Example: 8000

Example

shell
curl "https://depositscout.com/api/developer/v1/calculators/isa-allowance?type=adult&paidIn=8000" \
  -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/isa-allowance
as curl
curl "/api/developer/v1/calculators/isa-allowance" \
  -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.