Sign in
GET/calculators/savings-growth

Savings growth calculator

A starting balance and monthly deposits growing at a fixed rate: end balance, total paid in, interest, and the balance at the end of each year.

View as Markdown
All endpoints

EndpointsChangelog

Up to 50 years.

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-growth

  • rate*query · number

    AER, e.g. 4.5.

    Example: 4.5

  • months*query · integer

    How long, 1 to 600 months.

    Example: 60

  • amountquery · number

    Starting balance in pounds.

    Example: 10000

  • monthlyquery · number

    Paid in at the end of every month, in pounds.

    Example: 200

  • compoundingquery · enum

    annual (rate is an AER, the default) or monthly (rate ÷ 12 each month).

    annualmonthly

Example

shell
curl "https://depositscout.com/api/developer/v1/calculators/savings-growth?rate=4.5&months=60&amount=10000&monthly=200" \
  -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-growth?rate=4.5&months=60
as curl
curl "/api/developer/v1/calculators/savings-growth?rate=4.5&months=60" \
  -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.