---
title: "Get account by ID"
method: GET
path: "/data/accounts/{accountId}"
---

# Get account by ID

`GET /data/accounts/{accountId}`

## Path parameters

- `accountId` string, required

## Response `200`

Response

- Account
  - `PK` string — Primary key of the account, combining organization and customer IDs
  - `SK` string — Sort key of the account, unique per account within the customer
  - `orgId` string — The ID of the organization that owns the account
  - `customerId` string — The ID of the customer associated with the account
  - `userId` string — The ID of the user who owns the account
  - `fileId` string — The ID of the file associated with the account
  - `connectionId` string — The ID of the connection associated with the account
  - `accountId` string — Unique identifier for the account
  - `providerId` string — The ID of the provider associated with the account
  - `providerLabel` object
    - `en` string — Provider name in English
    - `he` string — Provider name in Hebrew
  - `accountResourceId` string — Resource identifier for the account provided by the financial institution
  - `accountNumber` string — Account number associated with the account
  - `accountDetails` string — Additional details about the account
  - `accountType` 'CHECKING' | 'CARD' | 'LOAN' | 'SAVINGS' — Type of the account (e.g., CHECKING, CARD, LOAN, SAVINGS)
  - `accountOwnerInfo` object
    - `fullName` string — Full name of the account owner
    - `nationalId` string — National ID of the account owner
  - `accountTransactionNumber` number — Number of transactions associated with the account
  - `accountCurrency` string — Currency of the account
  - `accountBalances` object[]
    - `balanceType` string — Type of balance (e.g., available, current)
    - `balanceAmount` object
      - `currency` string — Currency of the balance amount
      - `amount` string — Amount of the balance
    - `creditLimitIncluded` boolean — Indicates if the credit limit is included in the balance
    - `referenceDate` string, date — Reference date for the balance
    - `lastChangeDateTime` string, date-time — The last date and time when the balance was changed
  - `accountProduct` string — Product associated with the account
  - `accountCashAccountType` string — Type of cash account (e.g., checking, savings)
  - `accountCreditLimit` object
    - `amount` number — Credit limit amount
    - `currency` string — Currency of the credit limit
  - `createdAt` string, date-time — Date when the account was created
  - `updatedAt` string, date-time — Date when the account was last updated

## Other responses

- `400` — orgId was not provided
- `401` — Unauthorized access - Invalid access token
- `403` — Forbidden - Access token missing the required permissions to preform this action
- `404` — Route or entity not found
- `500` — Internal server error

---

[API](https://skmtc.net/open-finance/apis/auth.md) · [All operations](https://skmtc.net/open-finance/apis/auth/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/open-finance/auth/revisions/b4d401b65c3d/schema)