---
title: "Get issuance"
method: GET
path: "/issuances/{issuance_id}"
tags: ["Issuances"]
---

# Get issuance

`GET /issuances/{issuance_id}`

Get an issuance by id.

## Response `200`

The retrieved issuance.

- GetIssuanceResponse
  - `issuance` union
    - AssetIssuance — An entity that represents an issuance of an asset. An asset is a fungible resource tokenized on the blockchain.
      - `id` string, required — The id of the issuance.
      - `issuance_type` 'ASSET' | 'FINANCIAL_INSTRUMENT', required
      - `company_id` string, required — The id of the company that issued the issuance.
      - `token_amount` integer, required — The amount of token issued within the issuance.
      - `created_at` string, date-time, required — When the issuance has been created.
      - `name` string, required — The name shown of the issuance.
      - `external_reference` string, required — The external reference via which the issuance was created.
      - `terms_of_contract_url` string, uri, required — The URL where to find the terms of the contract.
      - `frozen_token_amount` integer, required — The amount of tokens that has been frozen. A token is frozen when it is sold to an investor but the investor decides to let the company have the custody of the token. The company cannot sell the token to another investor.
      - `asset_type` 'GOLD' | 'PALLADIUM' | 'SILVER', required
      - `circulating_token_amount` integer, required — The total amount of tokens that are circulating among the investors.
      - `burnt_token_amount` integer, required — The total amount of tokens that have been burnt. Tokens are usually burnt when the investors decide to redeem them for the underlying asset. The redemption process includes the burning of the tokens indeed.
    - FinancialInstrumentIssuance
      - `id` string, required — The id of the issuance.
      - `issuance_type` 'ASSET' | 'FINANCIAL_INSTRUMENT', required
      - `company_id` string, required — The id of the company that issued the issuance.
      - `token_amount` integer, required — The amount of token issued within the issuance.
      - `created_at` string, date-time, required — When the issuance has been created.
      - `name` string, required — The name shown of the issuance.
      - `external_reference` string, required — The external reference via which the issuance was created.
      - `terms_of_contract_url` string, uri, required — The URL where to find the terms of the contract.
      - `frozen_token_amount` integer, required — The amount of tokens that has been frozen. A token is frozen when it is sold to an investor but the investor decides to let the company have the custody of the token. The company cannot sell the token to another investor.
      - `nominal_value` number, double, required — The nominal value of the issuance.
      - `currency` string, required — The currency of the issuance.
      - `yearly_interest_rate` number, double, required — The yearly interest rate of the issuance expressed as a rate from 0 to 1.
      - `type` string, required — The type of the issuance.
      - `total_nominal_value` number, double, required — The total value of the issuance.
      - `returned_nominal_value` number, double, required — The returned face value of the issuance.
      - `paid_interest` number, double, required — The total interest paid.
      - `interest_to_be_paid` number, double, required — The total interest to be paid.
      - `paid_interest_percentage` number, double, required — The percentage of the paid interest.
      - `maturity_date` string, date-time, required — The maturity date of the issuance.
      - `elapsed_months` integer, required — The elapsed months from the creation date until the current date.
      - `maturity_in_months` integer, required — The number of months from the starting date [createdAt] until the maturity date [maturityDate].
      - `months_until_maturity` integer, required — The number of months from the current date until the maturity date.
      - `is_matured` boolean, required — Whether the issuance has matured, i.e., the current date is after the maturity date.
  - `investors` object
  - `investments` unknown[]
    - unknown

## Other responses

- `400` — The format of the request is not valid.
- `404` — 404 Not found.

---

[API](https://skmtc.net/morpheus-finance/apis/morpheus-server-api-2.md) · [All operations](https://skmtc.net/morpheus-finance/apis/morpheus-server-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/morpheus-finance/morpheus-server-api-2/versions/d139a4f66c78/schema)