---
title: "List transfers"
method: GET
path: "/cases/{case_id}/transfers"
tags: ["Transfers"]
---

# List transfers

`GET /cases/{case_id}/transfers`

## Request

- Base URL: `https://api.example.com/v1`
- URL: `https://api.example.com/v1/cases/{case_id}/transfers`
- Auth: none declared

List every Instant Inheritance transfer on a case, newest first.

## Query parameters

- `page` integer
- `per_page` integer
- `sort_order` 'asc' | 'desc'
- `status` 'requested' | 'verifying' | 'approved' | 'submitted' | 'in_transit' | 'completed' | 'returned' | 'rejected' | 'cancelled'
- `bank_account_id` string

## Response `200`

List of transfers.

- object
  - `data` Transfer[]
    - `id` string
    - `case_id` string
    - `bank_account_id` string: The deceased's bank account the funds are pulled from.
    - `estate_account_id` string: The FDIC-insured Sunset estate account the funds land in.
    - `method` 'ach_debit': Transfer rail. ACH debit is the only method at launch.
    - `amount_requested` number, double
    - `amount_settled` number, double, nullable: Amount actually credited to the estate account. Null until the transfer settles.
    - `currency` string
    - `status` 'requested' | 'verifying' | 'approved' | 'submitted' | 'in_transit' | 'completed' | 'returned' | 'rejected' | 'cancelled'
    - `status_reason` string, nullable: Explanation for a `rejected`, `returned`, or `cancelled` transfer.
    - `return_code` 'R01' | 'R02' | 'R03' | 'R04' | 'R08' | 'R10' | 'R16' | 'R20' | 'R29' | 'null', nullable: NACHA return code when `status` is `returned`.
    - `requested_by` string: User who requested the transfer.
    - `requested_at` string, date-time
    - `submitted_at` string, date-time, nullable
    - `expected_settlement_date` string, date, nullable: Business day the funds are expected in the estate account.
    - `settled_at` string, date-time, nullable
    - `trace_number` string, nullable: ACH trace number, available once submitted.
    - `created_at` string, date-time
    - `updated_at` string, date-time
  - `meta` PaginationMeta
    - `page` integer
    - `per_page` integer
    - `total_count` integer
    - `total_pages` integer
    - `next_cursor` string, nullable: Opaque cursor for fetching the next page. Pass as the `cursor` query parameter. Null when on the last page.
    - `has_more` boolean: Whether more results exist beyond this page.

## Other responses

- `404`: Resource not found.

---

[API](https://skmtc.dev/hellosunset/apis/sunset-api.md) - [All operations](https://skmtc.dev/hellosunset/apis/sunset-api/llms.txt) - [OpenAPI document](https://skmtc.dev/hellosunset/apis/sunset-api/revisions/f128e5526efe?raw)