{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-full-integration/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Upload Terms of Issuance (Bonds Only)","llmstxt":{"hide":true}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"upload-terms-of-issuance-bonds-only","__idx":0},"children":["Upload Terms of Issuance (Bonds Only)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If the tokenized asset is a bond, regulatory requirements mandate that complete terms of issuance remain publicly accessible at all times, including within the blockchain metadata. This step is therefore mandatory for bonds."]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["ℹ️ Shares do not require terms of issuance documentation. You may skip this step when tokenizing shares."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Please provide the terms of issuance document in PDF format for upload to our S3 storage. Once uploaded, the document URL will be included in the on-chain metadata."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To submit the PDF document, use the update token endpoint. Since this endpoint requires token data alongside the file, you must include both in your request."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["There is no specific set file size limit, but the server default is usually ~28.6 MB."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If you need to retrieve the token details first, use the \"Get Tokenized Asset Details\" endpoint:"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["GET"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/api/tokenization/tokenized-asset/{tokenizedAssetId}"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Request Example"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"# UAT BASE_URL: https://uat.vault.nyala.de\n# Production BASE_URL: https://vault.nyala.de\n\n# The {tokenizedAssetId} is ef86ea3e-f46f-4274-aad8-e83b1a241360\n\ncurl -X PATCH {{BASE_URL}}/api/tokenization/tokenized-asset/{tokenizedAssetId} \\\n-H \"X-API-KEY: YOUR_API_KEY\" \\\n-H \"Content-Type: multipart/form-data\" \\\n-F \"toiRawFile=@/path/to/your/blank.pdf\" \\\n-F 'tokenizedAssetData={\n    \"id\": \"ef86ea3e-f46f-4274-aad8-e83b1a241360\",\n    \"assetId\": \"0xb665e3470C20e83a8d39781FFcf892E9066040e0\",\n    \"name\": \"TK-United States of America\",\n    \"unitName\": \"TK6976\",\n    \"totalSupply\": 1000,\n    \"blockchain\": 14,\n    \"isin\": \"DE976\",\n    \"isRegulatedSecurity\": true,\n    \"price\": \"100\",\n    \"nominalAmountPerToken\": \"100\",\n    \"duration\": \"2035-01-01\",\n    \"paused\": false\n}'\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Parameter"},"children":["Parameter"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["institutionID"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Your institutionID after having been onboarded on NYALA. InstitutionId is set up in your Postman collection."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["TokenID"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The ID of the tokenized asset returned to you at token creation."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This will give you the token details which you can simply include as is in the next request which is \"Update Tokenized Asset - (Toi File)\""]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["PATCH"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/api/Tokenization/{institutionId}/tokenized-assets/{tokenizedAssetId}"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Request Example"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"# UAT BASE_URL: https://uat.vault.nyala.de\n# Production BASE_URL: https://vault.nyala.de\n\n# The {institutionId} is 8c8f78bc-78e0-47a7-b4e0-a793343175f0\n# The {tokenizedAssetId} is ef86ea3e-f46f-4274-aad8-e83b1a241360\n\ncurl -X GET {{BASE_URL}}/api/Tokenization/{institutionId}/tokenized-assets/{tokenizedAssetId} \\\n-H \"X-API-KEY: YOUR_API_KEY\" \\\n-H \"Content-Type: application/json\"\n","lang":"bash"},"children":[]}]},"headings":[{"value":"Upload Terms of Issuance (Bonds Only)","id":"upload-terms-of-issuance-bonds-only","depth":1}],"frontmatter":{"seo":{"title":"Upload Terms of Issuance (Bonds Only)"}},"lastModified":"2026-06-29T13:54:32.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/full-integration/send-toi","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}