---
title: "Get Account Allocation"
method: GET
path: "/digital-banking/v1/accounts/{account_id}/allocation"
tags: ["Accounts"]
---

# Get Account Allocation

`GET /digital-banking/v1/accounts/{account_id}/allocation`

## Request

- Base URL: `https://api.modernfi.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.modernfi.com/digital-banking/v1/accounts/{account_id}/allocation`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/modernfi/apis/endpoints/docs/digital-banking/v1/accounts/:account_id/allocation/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns an account's allocations for a run date. Allocations are produced only on business days, so a weekend or holiday `run_date` returns an empty `allocations` list. When `run_date` is omitted, the most recent approved allocation run is used. To get the latest allocations, omit `run_date`; if you pass a date, use a business day.

## Path parameters

- `account_id` union, required
  - string, uuid
  - string

## Query parameters

- `id_type` 'INSTITUTION': Type of the account id. Institution accounts ids are external ids and come from the institution.
- `run_date` string, date, nullable: The date for which to retrieve allocation data. Must be a business day to return allocations; weekend and holiday dates return an empty list. If not provided, uses the most recent approved allocation run date.

## Response `200`

Successful Response

- AllocationResponse
  - `account_id` string, required
  - `run_date` string, required
  - `allocations` AllocationData[], required
    - `amount` string, required
    - `institution` InstitutionData, required
      - `name` string, required
      - `state` string, required

## Other responses

- `400`: Bad Request - Invalid input or validation error
- `401`: Unauthenticated - Invalid or missing authentication credentials
- `403`: Unauthorized - Insufficient permissions to access resource
- `422`: Validation Error
- `500`: Internal Server Error

---

[API](https://skmtc.dev/modernfi/apis/endpoints.md) - [All operations](https://skmtc.dev/modernfi/apis/endpoints/llms.txt) - [OpenAPI document](https://skmtc.dev/modernfi/apis/endpoints/revisions/4bf4ac474dc0?raw)