---
updatedAt: 2026-06-11T11:59:29.000Z
agentTools:
  projectIndex: https://developer.coingate.com/llms.txt
---

# List Accounts

List the ledger accounts that belong to the authenticated account. Ledger accounts hold your funds on CoinGate, with one account per currency and account type. Only visible accounts are returned — those with status `active` or `suspended` — and each includes its current balance and currency details. Results are paginated, 100 per page by default.

<br />

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "v2",
    "version": "2"
  },
  "servers": [
    {
      "url": "https://api.coingate.com/api/v2"
    }
  ],
  "security": [
    {}
  ],
  "paths": {
    "/ledger/accounts": {
      "get": {
        "summary": "List Accounts",
        "description": "List the ledger accounts that belong to the authenticated account. Ledger accounts hold your funds on CoinGate, with one account per currency and account type. Only visible accounts are returned — those with status `active` or `suspended` — and each includes its current balance and currency details. Results are paginated, 100 per page by default.",
        "operationId": "ledger-accounts",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "Page number. Defaults to 1.",
            "schema": {
              "type": "integer",
              "format": "int32",
              "default": 1
            }
          },
          {
            "name": "per_page",
            "in": "query",
            "description": "Records per page. Defaults to 100, maximum 100. Values below 1 are set to 1.",
            "schema": {
              "type": "integer",
              "format": "int32",
              "default": 100
            }
          }
        ],
        "responses": {
          "200": {
            "description": "A paginated list of ledger accounts.",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": {
                      "current_page": 1,
                      "per_page": 100,
                      "total_accounts": 2,
                      "total_pages": 1,
                      "accounts": [
                        {
                          "id": "01KS2DT6X277ZEERSGKRPW8YZV",
                          "balance": "10.88",
                          "status": "active",
                          "account_type": "main",
                          "title": "Euro main account",
                          "currency": {
                            "id": 2,
                            "title": "Euro",
                            "kind": "fiat",
                            "symbol": "EUR",
                            "enabled": true,
                            "disabled_message": null
                          }
                        },
                        {
                          "id": "01KJZ0PM6K2V3ZFV416S17Q6MH",
                          "balance": "1443.060408",
                          "status": "active",
                          "account_type": "main",
                          "title": "USDC main account",
                          "currency": {
                            "id": 22,
                            "title": "USDC",
                            "kind": "crypto",
                            "symbol": "USDC",
                            "enabled": true,
                            "disabled_message": null
                          }
                        }
                      ]
                    }
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "current_page": {
                      "type": "integer",
                      "description": "Current page number.",
                      "example": 1
                    },
                    "per_page": {
                      "type": "integer",
                      "description": "Records per page.",
                      "example": 100
                    },
                    "total_accounts": {
                      "type": "integer",
                      "description": "Total number of visible accounts.",
                      "example": 2
                    },
                    "total_pages": {
                      "type": "integer",
                      "description": "Total number of pages.",
                      "example": 1
                    },
                    "accounts": {
                      "type": "array",
                      "description": "The ledger accounts on this page.",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "string",
                            "description": "The ledger account ID (ULID).",
                            "example": "01KS2DT6X277ZEERSGKRPW8YZV"
                          },
                          "balance": {
                            "type": "string",
                            "description": "Current balance, floored to the currency's precision. Returned as a string to preserve precision.",
                            "example": "10.88"
                          },
                          "status": {
                            "type": "string",
                            "enum": [
                              "active",
                              "disabled",
                              "error_creating",
                              "suspended"
                            ],
                            "description": "Account state. Only active/suspended accounts are listed.",
                            "example": "active"
                          },
                          "account_type": {
                            "type": "string",
                            "enum": [
                              "main",
                              "secondary",
                              "tertiary"
                            ],
                            "description": "Type of the ledger account.",
                            "example": "main"
                          },
                          "title": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "description": "Account title. Defaults to \"{currency title} {account_type} account\" when not set explicitly.",
                            "example": "Euro main account"
                          },
                          "currency": {
                            "type": "object",
                            "properties": {
                              "id": {
                                "type": "integer",
                                "description": "Currency ID.",
                                "example": 2
                              },
                              "title": {
                                "type": "string",
                                "description": "Currency name.",
                                "example": "Euro"
                              },
                              "kind": {
                                "type": "string",
                                "enum": [
                                  "fiat",
                                  "crypto"
                                ],
                                "description": "Whether the currency is fiat or crypto.",
                                "example": "fiat"
                              },
                              "symbol": {
                                "type": "string",
                                "description": "ISO symbol of the currency.",
                                "example": "EUR"
                              },
                              "enabled": {
                                "type": "boolean",
                                "description": "Whether the currency is currently enabled (not temporarily disabled).",
                                "example": true
                              },
                              "disabled_message": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "description": "Reason the currency is temporarily disabled, or null when enabled.",
                                "example": null
                              }
                            }
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid API token.",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": {
                      "message": "Auth Token is not valid",
                      "reason": "BadAuthToken"
                    }
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "message": {
                      "type": "string",
                      "example": "Auth Token is not valid"
                    },
                    "reason": {
                      "type": "string",
                      "example": "BadAuthToken"
                    }
                  }
                }
              }
            }
          }
        },
        "deprecated": false
      }
    }
  },
  "x-readme": {
    "headers": [],
    "explorer-enabled": false,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true
}
```