Retrieve an account - OpenFX

GET

/

v3

/

common

/

accounts

/

{accountId}

Retrieve an account

const url = 'https://api.openfx.com/v3/common/accounts/{accountId}';
const options = {
  method: 'GET',
  headers: {Authorization: 'Bearer <token>', 'X-Request-Signature': '<api-key>'}
};

fetch(url, options)
  .then(res => res.json())
  .then(json => console.log(json))
  .catch(err => console.error(err));

import requests

url = "https://api.openfx.com/v3/common/accounts/{accountId}"

headers = {
    "Authorization": "Bearer <token>",
    "X-Request-Signature": "<api-key>"
}

response = requests.get(url, headers=headers)

print(response.text)

HttpResponse<String> response = Unirest.get("https://api.openfx.com/v3/common/accounts/{accountId}")
  .header("Authorization", "Bearer <token>")
  .header("X-Request-Signature", "<api-key>")
  .asString();

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_WRITEDATA, stdout);
curl_easy_setopt(hnd, CURLOPT_URL, "https://api.openfx.com/v3/common/accounts/{accountId}");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer <token>");
headers = curl_slist_append(headers, "X-Request-Signature: <api-key>");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.openfx.com/v3/common/accounts/{accountId}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("X-Request-Signature", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "data": {
    "object": "account",
    "id": "acc_BMY3UenpGBn8ZQ8hio4BgE",
    "status": "ACTIVE",
    "capabilities": [
      {
        "object": "accountCapability",
        "id": "cap_Ji86R1HUP9uUTtp9kdkqBw",
        "status": "ACTIVE",
        "details": {
          "grants": [
            "RECEIVE_PAYOUTS"
          ],
          "currencies": [
            "EUR"
          ]
        },
        "hasActiveAddresses": true
      }
    ],
    "identity": {
      "identityType": "ORGANIZATION",
      "organization": {
        "legalName": "Novalia Handels GmbH",
        "registeredAddress": {
          "country": "DE"
        }
      }
    },
    "archivedAt": null,
    "createdAt": "2026-06-04T10:30:00.000Z",
    "updatedAt": "2026-06-04T10:30:00.000Z"
  }
}

Authorizations

Authorization

string

header

required

ES256 JWT bearer token, minted fresh per request.

See Authentication for the claims, including the nonce, the request signature, the two scopes, and which status means what.

X-Request-Signature

string

header

required

Body-bound ES256 signature over the request, required alongside the bearer token on every call. Base64url of an IEEE P-1363 fixed 64-byte r‖s signature.

See Authentication for the canonical string it signs, including the JWT nonce that binds it to the bearer token.

Headers

X-App-Mode

enum<string>

default:SANDBOX

Which environment this request runs against.

An omitted header means SANDBOX. Send it explicitly on every call rather than relying on that default, so live money movement is never missed because a header was forgotten: a live API key that reaches a live instance without an explicit LIVE value is rejected with AUTH_API_KEY_SANDBOX_REQUIRED. When present, the value must be SANDBOX or LIVE, matched without regard to case. Any other value, including an empty one, returns 400 INVALID_APP_MODE; details.received echoes the value you sent.

Available options:

SANDBOX,

LIVE

Example:

"SANDBOX"

X-Request-Id

string

Your own correlation id for this request, returned on the response exactly as you sent it.

Optional. Where you send none the response omits it, and the X-Trace-Id response header is the handle to correlate on instead.

Example:

"9f2c1b7e-4d3a-4f81-9c2e-6b0a5d7e1f34"

Path Parameters

accountId

string

required

Account id (acc_). A legacy bare UUID (no prefix) is also accepted on this read endpoint for backward compatibility with v2 identifiers; any other malformed or unrecognized-prefix value is rejected as a validation error.

Response

The requested account.

data

object

required

Someone you move money to or from: one identity, and the capabilities it is set up for. An account holds no money with OpenFX: it is a party, not a balance.

Show child attributes

⌘I

Retrieve an account

const url = 'https://api.openfx.com/v3/common/accounts/{accountId}';
const options = {
  method: 'GET',
  headers: {Authorization: 'Bearer <token>', 'X-Request-Signature': '<api-key>'}
};

fetch(url, options)
  .then(res => res.json())
  .then(json => console.log(json))
  .catch(err => console.error(err));

import requests

url = "https://api.openfx.com/v3/common/accounts/{accountId}"

headers = {
    "Authorization": "Bearer <token>",
    "X-Request-Signature": "<api-key>"
}

response = requests.get(url, headers=headers)

print(response.text)

HttpResponse<String> response = Unirest.get("https://api.openfx.com/v3/common/accounts/{accountId}")
  .header("Authorization", "Bearer <token>")
  .header("X-Request-Signature", "<api-key>")
  .asString();

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_WRITEDATA, stdout);
curl_easy_setopt(hnd, CURLOPT_URL, "https://api.openfx.com/v3/common/accounts/{accountId}");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer <token>");
headers = curl_slist_append(headers, "X-Request-Signature: <api-key>");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.openfx.com/v3/common/accounts/{accountId}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("X-Request-Signature", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "data": {
    "object": "account",
    "id": "acc_BMY3UenpGBn8ZQ8hio4BgE",
    "status": "ACTIVE",
    "capabilities": [
      {
        "object": "accountCapability",
        "id": "cap_Ji86R1HUP9uUTtp9kdkqBw",
        "status": "ACTIVE",
        "details": {
          "grants": [
            "RECEIVE_PAYOUTS"
          ],
          "currencies": [
            "EUR"
          ]
        },
        "hasActiveAddresses": true
      }
    ],
    "identity": {
      "identityType": "ORGANIZATION",
      "organization": {
        "legalName": "Novalia Handels GmbH",
        "registeredAddress": {
          "country": "DE"
        }
      }
    },
    "archivedAt": null,
    "createdAt": "2026-06-04T10:30:00.000Z",
    "updatedAt": "2026-06-04T10:30:00.000Z"
  }
}