---
title: "Get bank details for a funding account"
method: GET
path: "/onramp/accounts/{id}/details"
tags: ["Onramp"]
---

# Get bank details for a funding account

`GET /onramp/accounts/{id}/details`

## Request

- Base URL: `https://v1.orchestrator.rhinestone.dev/deposit-processor`
- URL: `https://v1.orchestrator.rhinestone.dev/deposit-processor/onramp/accounts/{id}/details`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/rhinestonewtf/apis/deposit-service-api/docs/onramp/accounts/:id/details/get.ts> (a function with typed inputs; its response is checked against the schema)

The coordinates to send the transfer to, captured when the account was configured. Served `Cache-Control: no-store`.

## Path parameters

- `id` string, uuid, required

## Headers

- `x-api-key` string: Integrator API key: the project’s orders
- `authorization` string: Customer bearer from `POST /compliance/sessions`, or a project-scoped platform bearer where the route permits tenant access

## Response `200`

Bank instructions for transfers into this account

- OnrampAccountDetails
  - `bankDetails` object, required
    - `schemaVersion` 1, required
    - `capturedAt` string, date-time, required
    - `currency` 'USD' | 'EUR', required
    - `accountHolderName` string, required
    - `bankName` string
    - `bankAddress` object
      - `street` string, required
      - `street2` string
      - `city` string, required
      - `postCode` string, required
      - `state` string, required
      - `country` string, required
    - `reference` string
    - `rails` object[], required
      - `type` 'BankAch' | 'BankFedwire' | 'BankSwift' | 'BankSepa', required
      - `accountNumber` string, required
      - `bankCode` string, required
      - `fee` object, required
        - `currency` 'USD' | 'EUR', required
        - `base` string, required
        - `percent` string, required
        - `minimum` string, required

## Other responses

- `401`: Missing or invalid bearer
- `403`: Not a customer bearer, the bearer no longer matches its customer, or PROVIDER_FORBIDDEN: the provider refuses the customer
- `404`: No such account for this customer, or bank transfer by virtual account is not provisioned for this project
- `409`: Bank instructions are unavailable for this account
- `500`: Internal failure serving the request
- `502`: PROVIDER_UNAVAILABLE: the provider did not answer; or PROVIDER_REJECTED: it refused the request (`providerError`)
- `503`: Onramp is not configured

## Changes

- **2026-11-06** `aa1767d704fa`: 28 warning, 8 info
  - added the new `PROVIDER_FORBIDDEN` enum value to the `code` response property for the response status `401`
  - added the new `PROVIDER_FORBIDDEN` enum value to the `code` response property for the response status `403`
  - added the new `PROVIDER_FORBIDDEN` enum value to the `code` response property for the response status `404`
  - added the new `PROVIDER_FORBIDDEN` enum value to the `code` response property for the response status `409`
  - …32 more
- **2026-10-07** `8b74181ef9e2`: 7 info
  - added the optional property `code` to the response with the `401` status
  - added the optional property `code` to the response with the `403` status
  - added the optional property `code` to the response with the `404` status
  - added the optional property `code` to the response with the `409` status
  - …3 more
- **2026-10-02** `2a4550fcca0f`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/rhinestonewtf/apis/deposit-service-api/changes/onramp/accounts/:id/details/get.md)

---

[API](https://skmtc.dev/rhinestonewtf/apis/deposit-service-api.md) - [All operations](https://skmtc.dev/rhinestonewtf/apis/deposit-service-api/llms.txt) - [OpenAPI document](https://skmtc.dev/rhinestonewtf/apis/deposit-service-api/revisions/aa1767d704fa?raw)