> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ecrop.de/llms.txt
> Use this file to discover all available pages before exploring further.

# Asset

> This API endpoint allows you to create new asset.

This chapter provides a step-by-step guide to creating and managing assets using ecrop's API. Creating an asset is the crucial first step in issuing a security on the ecrop platform. The asset represents the real-world item or project underlying the security, holding key information about its nature, quantity, and ownership. This is a critical step as it lays the groundwork for tokenization and subsequent investor offerings. It defines the core properties of the security offering before it is presented to potential investors. The asset you create will be linked to the tokens issued and the campaign used to distribute them. This section focuses on using the API for asset creation, providing the details you need for successful integration with your systems.


## OpenAPI

````yaml POST /omni-omni/v1/assets
openapi: 3.0.1
info:
  contact:
    email: developers@ecrop.com
    name: ecrop OmniOmni API Support
    url: https://ecrop.de/contact/
  description: >
    # Preparation Guide

    Welcome to the comprehensive API Documentation. This document provides a
    detailed list of available APIs and methods. Before beginning your
    integration, it’s recommended to review the following essential documents:


    - **API Service Guide (Essential, Pro):** Designed for non-technical users,
    this guide helps in selecting the best API package based on business needs.
    Review it
    [here](https://youki.atlassian.net/wiki/spaces/mar/pages/534183949/API+Service+Guide).


    - **Integration Handbook:** Targeted at developers, this handbook includes
    crucial details such as endpoint URLs, authentication methods,
    request/response formats, and error handling. It is essential for successful
    integration. Access the handbooks here:

      - [🌳 Pro Package Integration Handbook]

      - [🌱 Essential Package Integration Handbook]

    Familiarizing yourself with these documents will ensure a smoother
    integration process.
  license:
    name: ecrop OmniOmni
    url: https://developers.ecrop.de/api-license/
  termsOfService: https://developers.ecrop.de/terms-of-use/
  title: OmniOmni API Catalogue
  version: 1.0.0
  x-logo:
    backgroundColor: '#DDDDDD'
    url: >-
      https://static.wixstatic.com/media/fd3e8b_a57864adb1084dea94c9fab462a8f52c~mv2.png/v1/crop/x_0,y_131,w_1253,h_295/fill/w_233,h_55,al_c,q_85,usm_0.66_1.00_0.01,enc_auto/fd3e8b_a57864adb1084dea94c9fab462a8f52c~mv2.png
servers:
  - description: Default
    url: https://backend.sandbox.ecrop.de/ecrop-command
security:
  - Bearer Authentication: []
tags:
  - name: Auth
    description: Endpoints for OmniOmni security
  - name: Offers
    description: >
      Opportunities establishment to transfer securities between parties,
      including User interactions expressing interest in an offer
  - name: Assets
    description: >-
      Financial or non-financial instruments that can be transferred between two
      parties
  - name: Investments
    description: Asset displacement among 2 parties under offer conditions
  - name: Transfers
    description: Asset displacement among 2 parties
  - name: Documents
    description: Any document that is generated for any user action
  - name: Parties
    description: >
      A representative of individuals or any registered company, organization,
      etc...
paths:
  /omni-omni/v1/assets:
    post:
      tags:
        - Assets
      summary: 🌳 Creates new asset
      description: This API endpoint allows you to create new asset.
      operationId: createAsset
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/OmniOmniAssetDto'
        required: true
      responses:
        '201':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OmniOmniAssetDto'
          description: Asset retrieved
components:
  schemas:
    OmniOmniAssetDto:
      type: object
      properties:
        assetType:
          type: string
          enum:
            - BEARER_BOND
            - COMMON_SHARE
            - PREFERRED_SHARE
            - CRYPTO_FUND_SHARE
        clientToken:
          type: string
        clientWebhook:
          type: string
        description:
          type: string
        emailBody:
          type: string
        emailSubject:
          type: string
        entryType:
          type: string
          enum:
            - SINGLE
            - CUMULATIVE
        essentialContentOfRight:
          type: string
        eventualRightOfThirdParties:
          type: string
        extraOrdinaryTerminationRights:
          type: string
        files:
          type: array
          items:
            $ref: '#/components/schemas/OmniOmniFileDto'
          readOnly: true
        individualShare:
          type: boolean
        interestCalculationMethod:
          type: string
        interestPayBackDate:
          type: string
          format: date-time
        interestRate:
          type: number
        investmentCondition:
          type: string
        isin:
          type: string
        key:
          type: string
          readOnly: true
        loanPayBackDate:
          type: string
          format: date-time
        mark:
          type: string
          readOnly: true
        name:
          type: string
        numberOfVotingRight:
          type: integer
          format: int32
        ordinaryTerminationRights:
          type: string
        ownerEmail:
          type: string
        quantity:
          type: number
        restrictedShare:
          type: boolean
        restrictionsOnBehalfOfThirdParties:
          type: string
        signingEndDate:
          type: string
          format: date-time
        signingStartDate:
          type: string
          format: date-time
        status:
          type: string
          enum:
            - INACTIVE
            - ACTIVE
            - DRAFT
          readOnly: true
        subordinationAgreement:
          type: string
        valuePerShare:
          type: number
        webhookResult:
          type: string
          readOnly: true
    OmniOmniFileDto:
      type: object
      properties:
        content:
          type: string
          writeOnly: true
        description:
          type: string
        fileExtension:
          type: string
          writeOnly: true
        fileType:
          type: string
          enum:
            - PICTURE
            - DOCUMENT
            - VIDEO
            - TEMPLATE
        id:
          type: integer
          format: int64
          readOnly: true
        title:
          type: string
        url:
          type: string
          readOnly: true
      required:
        - description
        - fileExtension
        - fileType
        - title
  securitySchemes:
    Bearer Authentication:
      bearerFormat: JWT
      scheme: bearer
      type: http

````