Accounts

Guru Pay allows you to fetch account information for customers via two endpoints:

• One for listing all accounts tied to a specific customer.

• One for retrieving detailed data about a single account.

You must include your Bearer token in the request header.

Get Customer Accounts List

get

https://public-api.gurupay.euhttps://public-api-dev.gurupay.eu

/api/v1/customers/{customer_uuid}/accounts

Retrieves a paginated list of accounts associated with the given customer UUID.

Authorizations

BearerAuth

AuthorizationstringRequired

Authentication using a Bearer token.

Path parameters

customer_uuidstring · uuidRequired

Universally Unique Identifier (UUID) as defined by RFC 4122.

Example: e1f8a3b1-7d6c-4e9a-9b2e-3f8d1a9c5f2gPattern: ^[a-zA-Z0-9]{8}-[a-zA-Z0-9]{4}-[a-zA-Z0-9]{4}-[a-zA-Z0-9]{4}-[a-zA-Z0-9]{12}$

Query parameters

per_pageinteger · min: 1 · max: 100Optional

Number of items to return per page in a paginated response.

Default: 15Example: 15

pageinteger · min: 1Optional

The current page number for paginated results.

Default: 1Example: 1

Responses

200

Successful retrieval of customer accounts.

application/json

401

Unauthorized.

application/json

422

Unprocessable.

application/json

get

/api/v1/customers/{customer_uuid}/accounts

HTTPcURLJavaScriptPython

GET /api/v1/customers/{customer_uuid}/accounts HTTP/1.1
Host: public-api.gurupay.eu
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

[
  {
    "uuid": "123e4567-e89b-12d3-a456-426614174000",
    "status": "created",
    "customer_uuid": "123e4567-e89b-12d3-a456-426614174000",
    "account_name": "My account",
    "account_number": "LT433400015000036002",
    "currency": "EUR",
    "opening_date": "2025-04-11",
    "opening_date_unix": 1744373843,
    "balance": 100.5,
    "balance_national": 100.5,
    "book_balance": 0,
    "book_balance_national": 0,
    "available_balance": 100.5,
    "available_balance_national": 100.5,
    "hold": 0,
    "cards_reserved_amount": 0,
    "cards_reserved_amount_national": 0,
    "created_at": 1744373843,
    "updated_at": 1744373843,
    "account_type": "current",
    "virtual_account_holder": {
      "name": "John Doe",
      "person_type": "natural",
      "external_id": "3a13204d-6d69-431f-89d5-da11b1c99686",
      "citizenship": "US",
      "address": "123 Main St, Anytown, USA",
      "parent_uuid": "374d7a86-a126-41ae-a6e1-f0d4ce78f333",
      "parent_iban": "LT433400015000016020"
    }
  }
]

Get Specific Account Details

get

https://public-api.gurupay.euhttps://public-api-dev.gurupay.eu

/api/v1/customers/{customer_uuid}/accounts/{account_uuid}

Retrieves the full details for a single account identified by its UUID, scoped to a specific customer.

Authorizations

BearerAuth

AuthorizationstringRequired

Authentication using a Bearer token.

Path parameters

customer_uuidstring · uuidRequired

Universally Unique Identifier (UUID) as defined by RFC 4122.

Example: e1f8a3b1-7d6c-4e9a-9b2e-3f8d1a9c5f2gPattern: ^[a-zA-Z0-9]{8}-[a-zA-Z0-9]{4}-[a-zA-Z0-9]{4}-[a-zA-Z0-9]{4}-[a-zA-Z0-9]{12}$

account_uuidstring · uuidRequired

Universally Unique Identifier (UUID) as defined by RFC 4122.

Example: e1f8a3b1-7d6c-4e9a-9b2e-3f8d1a9c5f2gPattern: ^[a-zA-Z0-9]{8}-[a-zA-Z0-9]{4}-[a-zA-Z0-9]{4}-[a-zA-Z0-9]{4}-[a-zA-Z0-9]{12}$

Responses

200

Successful retrieval of account details.

application/json

401

Unauthorized.

application/json

422

Unprocessable.

application/json

get

/api/v1/customers/{customer_uuid}/accounts/{account_uuid}

HTTPcURLJavaScriptPython

GET /api/v1/customers/{customer_uuid}/accounts/{account_uuid} HTTP/1.1
Host: public-api.gurupay.eu
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "uuid": "123e4567-e89b-12d3-a456-426614174000",
  "status": "created",
  "customer_uuid": "123e4567-e89b-12d3-a456-426614174000",
  "account_name": "My account",
  "account_number": "LT433400015000036002",
  "currency": "EUR",
  "opening_date": "2025-04-11",
  "opening_date_unix": 1744373843,
  "balance": 100.5,
  "balance_national": 100.5,
  "book_balance": 0,
  "book_balance_national": 0,
  "available_balance": 100.5,
  "available_balance_national": 100.5,
  "hold": 0,
  "cards_reserved_amount": 0,
  "cards_reserved_amount_national": 0,
  "created_at": 1744373843,
  "updated_at": 1744373843,
  "account_type": "current",
  "virtual_account_holder": {
    "name": "John Doe",
    "person_type": "natural",
    "external_id": "3a13204d-6d69-431f-89d5-da11b1c99686",
    "citizenship": "US",
    "address": "123 Main St, Anytown, USA",
    "parent_uuid": "374d7a86-a126-41ae-a6e1-f0d4ce78f333",
    "parent_iban": "LT433400015000016020"
  }
}