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

# Get a funding account

`GET /onramp/accounts/{id}`

## Request

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

## 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`

The account

- OnrampAccount
  - `id` string, uuid, required
  - `currency` 'EUR' | 'USD', required: Supported ISO 4217 fiat currency
  - `status` 'pending' | 'active' | 'disabled', 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
- `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`: 24 warning, 7 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 `500`
  - …27 more
- **2026-10-07** `8b74181ef9e2`: 6 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 `500` status
  - …2 more
- **2026-10-02** `2a4550fcca0f`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/rhinestonewtf/apis/deposit-service-api/changes/onramp/accounts/:id/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)