GET /accounts

Lists accounts with filtering and pagination options.

GET/accounts

Get multiple accounts

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.

Query parameters

Parent's account Id

Account number of the specific account

External Id of the specific account

Identity Id owner of the account

Filters accounts by account type.

CHECKINGASSETSAVINGSESCROWFEE

Filters accounts by currency code (ISO 4217).

Status of the account

Created at start (DD/MM/YYYY)

Created at end (DD/MM/YYYY)

Specifies the maximum number of items to return in a single request.

A cursor indicating the position of the last retrieved item.

A cursor indicating how many items to skip from the request

Responses

paginationobjectrequired

Request

GET /sandbox/accounts 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", 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")
        .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

{
  "pagination": {
    "pagination": {
      "count": 0,
      "next": 0,
      "previous": 0,
      "total": 0
    },
    "results": [
      {
        "id": null,
        "identityId": null,
        "externalId": null,
        "type": null,
        "custody": null,
        "balance": null,
        "availableFunds": null,
        "currency": null,
        "name": null,
        "accountNumber": null
      }
    ]
  }
}