---
title: "Get security of account"
method: GET
path: "/rest/accounts/{account-id}/securities/{security-id}"
tags: ["Securities"]
---

# Get security of account

`GET /rest/accounts/{account-id}/securities/{security-id}`

## Request

- Base URL: `https://api.nrich.qwist.cloud`
- URL: `https://api.nrich.qwist.cloud/rest/accounts/{account-id}/securities/{security-id}`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/qwist/apis/finx-api/docs/rest/accounts/:account-id/securities/:security-id/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieve a single security associated to a specific account by its `security-id`.

## Path parameters

- `security-id` string, required: nrich ID of security.

## Parameters

- `#/paths/~1rest~1accounts~1{account-id}/get/parameters/0` (unresolved $ref)

## Response `200`

Security details.

- union
  - Security
    - `account_id` Schema (unresolved $ref)
    - `security_id` Schema (unresolved $ref)
    - `amount` number: Monetary value in account currency.
    - `amount_original_currency` Amount (unresolved $ref)
    - `created_at` CreatedAt (unresolved $ref)
    - `currency` Currency (unresolved $ref)
    - `exchange_rate` number, float: Exchange rate between trading and account price.
    - `isin` string, ISO 6166: International Securities Identification Number.
    - `market` string: Market the security is traded on.
    - `modified_at` ModifiedAt (unresolved $ref)
    - `name` string: Name of the security.
    - `price` number, float: Trading price.
    - `price_currency` Currency (unresolved $ref)
    - `purchase_price` number, float: Purchase price.
    - `purchase_price_currency` Currency (unresolved $ref)
    - `traded_at` string, date-time: Trading timestamp.
    - `wkn` string: Domestic security identification number.
    - `quantity` number, float: Quantity in stock.
    - `operations` object[]: List of operations associated with this security.
      - `amount` number, float: Operation amount.
      - `purpose` string: Purpose or description of the operation.
      - `quantity` number, float: Quantity involved in the operation.
      - `executed_at` EndedAt (unresolved $ref)
      - `type` string: Type of operation (e.g. BUY, SELL).
      - `isin` string, ISO 6166: International Securities Identification Number.
    - `type` 'STOCK' | 'FUND' | 'BOND' | 'TREASURY_BILL' | 'OTHER' | 'UNKNOWN', required: Type of security. This is not always returned by the bank so it is set as `UNKNOWN` in those cases
  - FixedIncome
    - `account_id` Schema (unresolved $ref)
    - `security_id` Schema (unresolved $ref)
    - `amount` number: Monetary value in account currency.
    - `amount_original_currency` Amount (unresolved $ref)
    - `created_at` CreatedAt (unresolved $ref)
    - `currency` Currency (unresolved $ref)
    - `exchange_rate` number, float: Exchange rate between trading and account price.
    - `isin` string, ISO 6166: International Securities Identification Number.
    - `market` string: Market the security is traded on.
    - `modified_at` ModifiedAt (unresolved $ref)
    - `name` string: Name of the security.
    - `price` number, float: Trading price.
    - `price_currency` Currency (unresolved $ref)
    - `purchase_price` number, float: Purchase price.
    - `purchase_price_currency` Currency (unresolved $ref)
    - `traded_at` string, date-time: Trading timestamp.
    - `wkn` string: Domestic security identification number.
    - `quantity` number, float: Quantity in stock.
    - `operations` object[]: List of operations associated with this security.
      - `amount` number, float: Operation amount.
      - `purpose` string: Purpose or description of the operation.
      - `quantity` number, float: Quantity involved in the operation.
      - `executed_at` EndedAt (unresolved $ref)
      - `type` string: Type of operation (e.g. BUY, SELL).
      - `isin` string, ISO 6166: International Securities Identification Number.
    - `type` 'STOCK' | 'FUND' | 'BOND' | 'TREASURY_BILL' | 'OTHER' | 'UNKNOWN', required: Type of security. This is not always returned by the bank so it is set as `UNKNOWN` in those cases
    - `matures_on` Schema (unresolved $ref)
    - `face_value` number, float: The nominal value of the security repaid to the investor by the issuer upon reaching the maturity date. For zero-coupon instruments (such as treasury bills), returns are realized through the discount between purchase price and face value. For coupon-bearing instruments (such as bonds), periodic coupon payments are calculated as a percentage of this face value. Denominated in the security currency.
  - Bond
    - `account_id` Schema (unresolved $ref)
    - `security_id` Schema (unresolved $ref)
    - `amount` number: Monetary value in account currency.
    - `amount_original_currency` Amount (unresolved $ref)
    - `created_at` CreatedAt (unresolved $ref)
    - `currency` Currency (unresolved $ref)
    - `exchange_rate` number, float: Exchange rate between trading and account price.
    - `isin` string, ISO 6166: International Securities Identification Number.
    - `market` string: Market the security is traded on.
    - `modified_at` ModifiedAt (unresolved $ref)
    - `name` string: Name of the security.
    - `price` number, float: Trading price.
    - `price_currency` Currency (unresolved $ref)
    - `purchase_price` number, float: Purchase price.
    - `purchase_price_currency` Currency (unresolved $ref)
    - `traded_at` string, date-time: Trading timestamp.
    - `wkn` string: Domestic security identification number.
    - `quantity` number, float: Quantity in stock.
    - `operations` object[]: List of operations associated with this security.
      - `amount` number, float: Operation amount.
      - `purpose` string: Purpose or description of the operation.
      - `quantity` number, float: Quantity involved in the operation.
      - `executed_at` EndedAt (unresolved $ref)
      - `type` string: Type of operation (e.g. BUY, SELL).
      - `isin` string, ISO 6166: International Securities Identification Number.
    - `type` 'STOCK' | 'FUND' | 'BOND' | 'TREASURY_BILL' | 'OTHER' | 'UNKNOWN', required: Type of security. This is not always returned by the bank so it is set as `UNKNOWN` in those cases
    - `matures_on` Schema (unresolved $ref)
    - `face_value` number, float: The nominal value of the security repaid to the investor by the issuer upon reaching the maturity date. For zero-coupon instruments (such as treasury bills), returns are realized through the discount between purchase price and face value. For coupon-bearing instruments (such as bonds), periodic coupon payments are calculated as a percentage of this face value. Denominated in the security currency.
    - `coupons` object[]: List of coupon payments associated with the bond.
      - `paid_at` EndedAt, required (unresolved $ref)
      - `amount` number, float, required: Coupon payment amount.

## Other responses

- `400` (unresolved $ref)
- `401` (unresolved $ref)
- `404` (unresolved $ref)
- `4XX` (unresolved $ref)

## Changes

- **2026-11-03** `398592d93b1f`: 3 breaking, 18 warning, 1 info
  - added the new path request parameter `account-id`
  - added `#/components/schemas/Security, #/components/schemas/FixedIncome, #/components/schemas/Bond` to the response body `oneOf` list for the response status `200`
  - the response's body type changed from `object` to no type for status `200`
  - removed the optional property `account_id` from the response with the `200` status
  - …18 more

[Operation history](https://skmtc.dev/qwist/apis/finx-api/changes/rest/accounts/:account-id/securities/:security-id/get.md)

---

[API](https://skmtc.dev/qwist/apis/finx-api.md) - [All operations](https://skmtc.dev/qwist/apis/finx-api/llms.txt) - [OpenAPI document](https://skmtc.dev/qwist/apis/finx-api/revisions/398592d93b1f?raw)