---
title: "Get OSH Accounts for Customer"
method: GET
path: "/customers/{id}/osh/accounts"
---

# Get OSH Accounts for Customer

`GET /customers/{id}/osh/accounts`

## Request

- Base URL: `https://api.open-finance.ai/v3/loans`
- URL: `https://api.open-finance.ai/v3/loans/customers/{id}/osh/accounts`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://api.open-finance.ai/oauth/token` scopes: `read:customers`

## Path parameters

- `id` string, required

## Query parameters

- `sort` 1 | -1
- `limit` number
- `nextPage` string

## Response `200`

List of OSH accounts

- object
  - `count` number: Total number of accounts
  - `nextPage` string: Token for the next page of results
  - `items` 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`: Bad Request
- `403`: Forbidden
- `404`: Not Found
- `500`: Internal Server Error

---

[API](https://skmtc.dev/open-finance/apis/loans.md) - [All operations](https://skmtc.dev/open-finance/apis/loans/llms.txt) - [OpenAPI document](https://skmtc.dev/open-finance/apis/loans/revisions/915c69e62042?raw)