{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-full-integration/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"📄Fetch Individual Investors' Registry Extracts via API","llmstxt":{"hide":true}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"fetch-individual-investors-registry-extracts-via-api","__idx":0},"children":["📄Fetch Individual Investors' Registry Extracts via API"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Under the German Electronic Securities Act (eWpG), which governs most securities we issue, each investor in a tokenized security must receive a registry extract upon receiving tokens in their wallet. This extract is a one-page PDF document containing essential investment information, including the token name, number of tokens purchased, nominal value (if applicable), and the investor's blockchain wallet address."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You must ensure this document remains accessible to investors at all times, either through a customer portal upload or via email delivery."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To retrieve these extracts via API, first generate them using the following endpoint:"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["POST Generate registry extract for a specified project and institution"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/api/Project/{institutionId}/{projectId}/registry-extract"]}]},{"$$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 {projectId} is 40ff9e56-cf2a-499a-9fe7-706e0e136eb7\n\ncurl -X POST {{BASE_URL}}/api/Project/{institutionId}/{projectId}/registry-extract \\\n-H \"X-API-KEY: YOUR_API_KEY\" \\\n-H \"Content-Type: application/json\" \\\n-d '{}'\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Response Example"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n    \"errorMessageCodes\": null,\n    \"data\": true\n}\n","lang":"json"},"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":["projectID"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The ID of the specific project you want to generate new extracts for."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Then, you can call the same endpoint to fetch the generated registry extracts. You will need to send the project ID in the payload again."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["GET Download all the registry extracts for a project"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/api/Project/{{institution_id}}/{{project_id}}/registry-extract"]}]},{"$$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":["projectID"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The ID of the specific project you want to generate new extracts for."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"You can also retrieve specific extracts for a set project and customer via this other endpoint:"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["GET Download the registry extract for a specific project and customer"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/api/Customer/{{institutionId}}/{{customerId}}/registry-extract/{{customerId}}_{{unitName}}.pdf"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Note:"]}," For external wallets please use the following postfix \".../{{customerId}}_{{unitName}}_Ext\""]},{"$$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# {institutionId} = 8c8f78bc-78e0-47a7-b4e0-a793343175f0\n# {customerId} = 745f5542-c288-4c49-8284-40cfb69ee52e\n# {unitName} = TK6976\n\ncurl -X GET {{BASE_URL}}/api/Customer/8c8f78bc-78e0-47a7-b4e0-a793343175f0/745f5542-c288-4c49-8284-40cfb69ee52e/registry-extract/745f5542-c288-4c49-8284-40cfb69ee52e_TK6976.pdf \\\n-H \"X-API-KEY: YOUR_API_KEY\"\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Response Example"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"%PDF-1.4\n1 0 obj\n<< /Title (Registry Extract) /Creator (Nyala Digital Systems) >>\n... [Binary Data] ...\n%%EOF\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The documents will be returned in the field ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["data"]},"."," ","You can then send them to your investors however you see fit."]}]},"headings":[{"value":"📄Fetch Individual Investors' Registry Extracts via API","id":"fetch-individual-investors-registry-extracts-via-api","depth":1}],"frontmatter":{"seo":{"title":"📄Fetch Individual Investors' Registry Extracts via API"}},"lastModified":"2026-04-23T13:37:58.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/full-integration/fetch-registry-extracts","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}