---
title: "Get Account by Reference"
method: GET
path: "/partners/accounts/{account_ref}"
tags: ["Partners"]
---

# Get Account by Reference

`GET /partners/accounts/{account_ref}`

Retrieve details for a specific account using its reference. Fetch detailed information about an account, including its status and associated metadata, using the provided account reference. This endpoint is useful for verifying account existence and retrieving essential details.

## Path parameters

- `account_ref` string, required

## Response `200`

OK

- PartnersGetAccountByReferenceSuccess — Successfully retrieved the account details.
  - `id` integer — Unique identifier for the account.
  - `org_id` string — Organization ID associated with the account.
  - `reference` string — Reference identifier for the account.
  - `account_type` string — Type of the account.
  - `name` string — Name of the account.
  - `chain_id` integer — Blockchain chain ID for the account.
  - `address` string — Address associated with the account (if applicable).
  - `currencies` string[] — List of supported currencies for the account.
  - `account_number` string — Account number (if applicable).
  - `sort_code` string — Sort code (if applicable).
  - `enabled` boolean — Indicates whether the account is active.
  - `state` string — Current state of the account.
  - `created_at` string, date-time — Timestamp of when the account was created.
  - `updated_at` string, date-time — Timestamp of the last update to the account.
  - `provider` string — Provider managing the account.

## Other responses

- `400` — Bad Request
- `404` — Not Found
- `500` — Internal Server Error

---

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