---
title: "Get OSH Transactions for Customer Account"
method: GET
path: "/customers/{customer_id}/osh/accounts/{account_id}"
---

# Get OSH Transactions for Customer Account

`GET /customers/{customer_id}/osh/accounts/{account_id}`

## Request

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

## Path parameters

- `customer_id` string, required
- `account_id` string, required

## Query parameters

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

## Response `200`

List of OSH transactions

- object
  - `count` number: Total number of transactions
  - `nextPage` string: Token for the next page of results
  - `items` Transaction[]
    - `id` string: The unique identifier of the transaction
    - `SK` string: Sort key of the transaction
    - `userId` string: The ID of the user associated with the transaction
    - `fileId` string: The ID of the file associated with the transaction
    - `connectionId` string: The ID of the connection associated with the transaction
    - `accountId` string: The ID of the account associated with the transaction
    - `providerId` string: The ID of the provider associated with the transaction
    - `transactionProviderIdentifier` string: Provider-specific identifier for the transaction
    - `accountNumber` string: Account number associated with the transaction
    - `status` string: Status of the transaction
    - `categoryCode` string: Category code of the transaction
    - `amount` object
      - `originalAmount` object
        - `amount` string: Original amount of the transaction
        - `currency` string: Currency of the original amount
      - `chargedAmount` object
        - `amount` string: Charged amount of the transaction
        - `currency` string: Currency of the charged amount
    - `balancePerTransaction` string: Balance per transaction
    - `description` string: Description of the transaction
    - `category` string: Category of the transaction
    - `changedCategory` string: Updated category of the transaction
    - `installments` string: Installment information for the transaction
    - `type` string: Type of the transaction
    - `date` object
      - `valueDate` string: Value date of the transaction
      - `bookingDate` string: Booking date of the transaction
      - `transactionDate` string: Date when the transaction occurred
    - `markupFee` string: Markup fee associated with the transaction
    - `merchantName` string: Name of the merchant associated with the transaction
    - `details` string: Details of the transaction
    - `isInvoiced` boolean: Indicates if the transaction is invoiced
    - `code` string: Transaction code
    - `merchantAddress` string: Address of the merchant
    - `createdAt` string: Date when the transaction was created
    - `updatedAt` string: Date when the transaction was last updated
    - `classification` string: Classification of the transaction
    - `changedClassification` string: Updated classification of the transaction
    - `labels` string[]: Labels associated with the transaction
    - `transactionType` string: The type of the transaction
    - `advisorId` string: The ID of the advisor associated with the transaction

## 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)
