GET /accounts/{id}

Endpoint to get the accounts by a certain filter, could be the id, identityId, accountNumber.

GET/accounts/{id}

Get Account

Headers

Bearer access token returned by the authentication endpoint.

The API key used for authentication when making requests to the API Gateway.

API version selector for Conomy endpoints. Use 24-04-2025 for the current version.

Identifies the application making the request.

Path parameters

Unique identifier for the account.

Responses

idstringrequired

Unique identifier for the internal service.

identityIdstringrequired

Identifier linking the internal account to an organization or user.

externalIdstringrequired

External reference identifier for integrations.

typestringrequired

CHECKINGFiat liquid account used for spending, withdrawals, or operations.

ASSETTracks non-operational or financial assets.

SAVINGSHolds funds intended for savings or long-term storage.

ESCROWTemporary routing account for incoming funds.

FEEHolds all fees collected via FEE or FEE_INVOICE.

custodystringrequired

Indicates the custody type managing the internal account.

balancestring/^\d+(\.\d+)?$/required

Total balance available in the internal account.

availableFundsstring/^\d+(\.\d+)?$/required

Amount of funds available for transactions.

currencystringrequired

Specifies the currency used, following the ISO 4217 standard for fiat currencies (e.g., CLP, ARS, MXN). Go to the currencies page for the complete list of supported values.

namestringrequired

A friendly name assigned to the internal account.

accountNumberstringrequired

Internal reference number for the account.

accountHolderstringrequired

Name of the entity or user owning the internal account.

statusstringrequired

The current status of the account (e.g., PENDING, ACTIVE, BLOCKED).

parentIdstringrequired

Identifier of the parent account if this is a sub-account.

subAccountsobject

Details of sub-accounts associated with this internal account.

custodyBankAccountobject

Details of the custody bank account linked to this internal account.

Request

GET /sandbox/accounts/{id} HTTP/1.1
Host: api.conomyhq.com
Authorization: Bearer {ACCESS_TOKEN}
x-api-key: {YOUR_API_KEY}
conomyhq-api-version: 24-04-2025
User-Agent: MyApp/1.0

package main

import (
	"encoding/json"
	"net/http"
)

func main() {
	req, _ := http.NewRequest("GET", "https://api.conomyhq.com/sandbox/accounts/{id}", nil)
	req.Header.Set("Authorization", "Bearer {ACCESS_TOKEN}")
	req.Header.Set("x-api-key", "{YOUR_API_KEY}")
	req.Header.Set("conomyhq-api-version", "24-04-2025")
	req.Header.Set("User-Agent", "MyApp/1.0")

	client := &http.Client{}
	resp, _ := client.Do(req)
	defer resp.Body.Close()

	var data map[string]any
	json.NewDecoder(resp.Body).Decode(&data)
}

use reqwest::Client;
use serde_json::json;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let client = Client::new();
    let resp = client
        .get("https://api.conomyhq.com/sandbox/accounts/{id}")
        .header("Authorization", "Bearer {ACCESS_TOKEN}")
        .header("x-api-key", "{YOUR_API_KEY}")
        .header("conomyhq-api-version", "24-04-2025")
        .header("User-Agent", "MyApp/1.0")
        .send()
        .await?;

    let data: serde_json::Value = resp.json().await?;
    Ok(())
}

Response

{
  "id": "string",
  "identityId": "string",
  "externalId": "string",
  "type": "CHECKING",
  "custody": "string",
  "balance": "string",
  "availableFunds": "string",
  "currency": "string",
  "name": "string",
  "accountNumber": "string"
}