---
title: "List allocations"
method: GET
path: "/api/v1/savings-goals/{id}/allocations"
tags: ["Finance Management.Savings Goals", "ENTERPRISE"]
---

# List allocations

`GET /api/v1/savings-goals/{id}/allocations`

List allocations by Savings Goal.

## Path parameters

- `id` string, required

## Query parameters

- `page_size` integer
- `page_token` string

## Response `200`

The list of allocations.

- ListAllocationsResponse
  - `allocations` Allocation[]
    - `amount` Amount — Amount moved with the allocation.
      - `currencyCode` string, required — The ISO 4217 currency code of the amount
      - `scale` integer, required — The scale of the amount. <br/>The `unscaledValue` is used with `scale` to accurately represent floating point values. <br/>The formula is `unscaledValue * (10^-scale)`. For example, if scale is 1 and unscaledValue is 1230, the end result would be 123.0.
      - `unscaledValue` integer, required — The unscaled value of the amount. <br/>The `unscaledValue` is used with `scale` to accurately represent floating point values. <br/>The formula is `unscaledValue * (10^-scale)`. For example, if scale is 1 and unscaledValue is 1230, the end result would be 123.0.
    - `createTime` string — Date and time in UTC in which the Allocation was made.
    - `destinationId` string — The ID of the Destination.
    - `destinationType` 'SAVINGS_GOAL' | 'ACCOUNT' — The type of the destination.<br />- ACCOUNT: Destination of type Account.<br />- SAVINGS_GOAL: Destination of type Savings Goal.
    - `id` string — The ID of the new allocation.
    - `sourceId` string — The ID of the Source.
    - `sourceType` string — The type of the source.<br />- ACCOUNT: Source of type Account.<br />- SAVINGS_GOAL: Source of type Savings Goal.
  - `nextPageToken` string — Next page token to be used for pagination, use it with the next request parameter <code>page_token</code> to request the next page of the list.

## Other responses

- `401` — If the user is not authorized.
- `404` — Savings Goal not found.

---

[API](https://skmtc.net/tink/apis/tink-api.md) · [All operations](https://skmtc.net/tink/apis/tink-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tink/tink-api/revisions/23d8982b533d/schema)