{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-products/namirialsignenterprise/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"API Reference","description":"Integration and usage documentation."},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"api-reference","__idx":0},"children":["API Reference"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Namirial Sign Enterprise API (v1) is a RESTful API that lets you create, manage, and monitor electronic signature workflows programmatically. You can use it to integrate NSE into your own applications, automate envelope dispatching, or build custom signing portals."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The interactive API specification is available below — use it to explore endpoints, inspect request and response schemas, and try calls directly."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"base-url","__idx":1},"children":["Base URL"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["All API endpoints are relative to your NSE instance base URL:"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["E.g."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"https://demo-eu-ie1-api.namirialsign.com/api/\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Most of the endpoint includes ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["organizationId"]}," as a required path parameter (make sure to have it available whenever using the api). This is the identifier of the organization in your NSE instance that owns the resource being operated on."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"principles-of-api-v1","__idx":2},"children":["Principles of API v1"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Full REST semantics"]}," — uses GET, POST, PUT, PATCH, and DELETE verbs according to standard REST conventions."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Organization-scoped resources"]}," — all resources beside reference data are scoped under ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/organizations/{organizationId}/"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Stage-based workflow"]}," — signing workflows are modelled as ordered ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Stages"]},". Recipients within the same stage sign in parallel; stages are processed sequentially in sort order."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Separation of structure and content"]}," — files, stages, and recipients are managed as independent sub-resources of an envelope or template, allowing fine-grained control over each part of the workflow."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Artifacts for completed documents"]}," — once an envelope is completed, signed documents and the audit trail are accessible as ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Artifacts"]},"."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"authentication","__idx":3},"children":["Authentication"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["API authentication uses OAuth 2.0 Client Credentials via MyNamirial as the Identity Provider."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"setup","__idx":4},"children":["Setup"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Create an ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["IdP application"]}," (Service Account)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Note the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Client ID"]}," and ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Client Secret"]}," assigned to the application."]}]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Note:"]}," The creation of an IdP in MyNamirial and the release of ClientID and ClientSecret can be completed in the UI in the section for Service Accounts. For more information see: ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/namirialsignenterprise/namirialsignenterprise-knowledge-center/02-products-and-modules/01-nse/02-nse-settings/users"},"children":["Service Account"]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"obtaining-a-token","__idx":5},"children":["Obtaining a token"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use the Client Credentials grant to obtain a JWT Bearer token."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"personal-access-token","__idx":6},"children":["Personal Access Token"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Additionally a Personal access token can be created in order to use the API. For more information see: ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/namirialsignenterprise/namirialsignenterprise-knowledge-center/02-products-and-modules/01-nse/02-nse-settings/user-account-settings"},"children":["Access Token"]},". Add as headers the \"Personal-Access-Token\" and the token retrieved as value."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"using-the-token","__idx":7},"children":["Using the token"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Include the token as a Bearer token in the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Authorization"]}," header of every API request:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"Authorization: Bearer <access_token>\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Unauthenticated or expired-token requests return ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["401 Unauthorized"]},"."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"core-concepts","__idx":8},"children":["Core Concepts"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"envelope","__idx":9},"children":["Envelope"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["An envelope represents a single signature request. It contains one or more documents (files), a signing workflow (stages), and envelope options such as name, expiration date, and reminder configuration."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Envelope lifecycle:"]},{"$$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":"Status"},"children":["Status"]},{"$$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":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Draft"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Created but not yet sent. All configuration can be modified."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["InProgress"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Sent to recipients. The signing workflow is in progress."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Completed"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["All recipients have finished their activities. Artifacts are available for download."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Canceled"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Manually canceled. No further activity is possible."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Expired"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The expiration date was reached before completion. Can be resumed with a new date."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Rejected"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The envelope was rejected by one or more recipients."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"template","__idx":10},"children":["Template"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A template is a reusable envelope configuration — pre-loaded with documents, stages, recipients, and field placements. Creating an envelope from a template copies the full configuration into a new Draft envelope, which can be customised before sending."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"stage","__idx":11},"children":["Stage"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A stage represents one step in the signing workflow. Each stage contains one or more recipients who act in parallel. Stages are processed sequentially in ascending ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sortOrder"]},". Use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["requiredRecipientCompletions"]}," to allow a stage to advance when a minimum number of recipients (out of the total) have completed their activity — useful for group signing scenarios."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"recipient","__idx":12},"children":["Recipient"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A recipient is a person assigned to a stage. Each recipient has contact details (email, name, phone), a notification channel (Email, SMS, WhatsApp, or None), a language preference, optional authentication requirements (access code, SMS OTP, OAuth), and an optional signature configuration (signature type and any required pre-filled data)."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"file-and-tasks","__idx":13},"children":["File and Tasks"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A file is a document attached to an envelope or template. ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Tasks"]}," are the interactive elements assigned to recipients — signature fields, text inputs, checkboxes, dropdowns, attachment requests, and confirmation reads. Most tasks are positioned on a specific page of a file, but some (such as confirmation reads) operate at the file or page level without a fixed position."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"artifact","__idx":14},"children":["Artifact"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Once an envelope reaches ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Completed"]}," status, its output files become available as Artifacts. There are two artifact types: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CompletedFile"]}," (the signed document) and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AuditTrail"]}," (the full event log as a PDF)."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"supported-signature-types","__idx":15},"children":["Supported Signature Types"]},{"$$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":"Type"},"children":["Type"]},{"$$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":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ClickToSignSignature"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Simple click-to-confirm signature — no cryptographic certificate."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["DrawToSignSignature"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Freehand drawn signature captured in the browser or on a touch device."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["TypeToSignSignature"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Signature created by typing the recipient's name in a chosen font."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["LocalCertificateSignature"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Signature using a certificate installed on the recipient's local device."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["DisposableCertificateSignature"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Signature using a short-lived (one-time) qualified certificate generated at signing time."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["BiometricSignature"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Signature captured via a biometric tablet (pen pressure and dynamics)."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["RemoteCertificateSignature"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Signature using a remote qualified certificate (requires ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["userId"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["deviceId"]},")."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["OneTimePasswordSignature"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Signature confirmed via SMS OTP sent to the recipient's phone number."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AutomaticSignature"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Signature applied without any interaction needed"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PluginSignature"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Signature delegated to a custom signing plugin configured on the instance."]}]}]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"error-handling","__idx":16},"children":["Error Handling"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["All error responses follow a consistent structure:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"errors\": [\n    {\n      \"errorId\": \"string\",\n      \"field\": \"string\",\n      \"message\": \"string\",\n      \"messageEn\": \"string\",\n      \"additionalData\": {}\n    }\n  ]\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":"HTTP Status"},"children":["HTTP Status"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Meaning"},"children":["Meaning"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["200 OK"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Request succeeded."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["201 Created"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Resource was created. The new resource ID is returned in the response body."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["204 No Content"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Request succeeded with no response body (update or delete)."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["400 Bad Request"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The request is invalid or malformed."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["401 Unauthorized"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Authentication is missing or the token is expired."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["403 Forbidden"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The authenticated user does not have permission to access this resource."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["404 Not Found"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The requested resource does not exist."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["422 Unprocessable Entity"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The request is valid but violates a business rule."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["500 Internal Server Error"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["An unexpected error occurred on the server."]}]}]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"typical-integration-workflow","__idx":17},"children":["Typical Integration Workflow"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A typical integration for sending a signature request follows these steps:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Create an envelope"]}," — ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /organizations/{organizationId}/envelopes"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Upload a document"]}," — ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /organizations/{organizationId}/envelopes/{envelopeId}/files"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Add a signing stage"]}," — ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /organizations/{organizationId}/envelopes/{envelopeId}/stages"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Add a recipient to the stage"]}," — ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /organizations/{organizationId}/envelopes/{envelopeId}/stages/{stageId}/recipients"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Place field tasks on the document"]}," — ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PUT /organizations/{organizationId}/envelopes/{envelopeId}/files/{fileId}/tasks"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Send the envelope"]}," — ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /organizations/{organizationId}/envelopes/{envelopeId}/send"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Check the envelope"]}," — ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /organizations/{organizationId}/envelopes/{envelopeId}"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Download artifacts"]}," — ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /organizations/{organizationId}/envelopes/{envelopeId}/artifacts"]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To create from a template, replace steps 1–5 with:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Create an envelope from a template"]}," — ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /organizations/{organizationId}/templates/{templateId}/create-envelope"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Optionally update recipients or files in the draft, then proceed to send."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"api-specification","__idx":18},"children":["API Specification"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The full interactive API specification is available on the Swagger UI of your NSE instance. Contact your Namirial representative to obtain the correct URL for your environment."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The DEMO SwaggerUI is available at this URL:"," ","https://demo-eu-ie1-api.namirialsign.com/api/swagger/index.html"]}]},"headings":[{"value":"API Reference","id":"api-reference","depth":1},{"value":"Base URL","id":"base-url","depth":2},{"value":"Principles of API v1","id":"principles-of-api-v1","depth":2},{"value":"Authentication","id":"authentication","depth":2},{"value":"Setup","id":"setup","depth":3},{"value":"Obtaining a token","id":"obtaining-a-token","depth":3},{"value":"Personal Access Token","id":"personal-access-token","depth":3},{"value":"Using the token","id":"using-the-token","depth":3},{"value":"Core Concepts","id":"core-concepts","depth":2},{"value":"Envelope","id":"envelope","depth":3},{"value":"Template","id":"template","depth":3},{"value":"Stage","id":"stage","depth":3},{"value":"Recipient","id":"recipient","depth":3},{"value":"File and Tasks","id":"file-and-tasks","depth":3},{"value":"Artifact","id":"artifact","depth":3},{"value":"Supported Signature Types","id":"supported-signature-types","depth":2},{"value":"Error Handling","id":"error-handling","depth":2},{"value":"Typical Integration Workflow","id":"typical-integration-workflow","depth":2},{"value":"API Specification","id":"api-specification","depth":2}],"frontmatter":{"seo":{"title":"API Reference"}},"lastModified":"2026-10-19T09:46:49.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/products/namirialsignenterprise/namirialsignenterprise-knowledge-center/03-developer-documentation/01-api-reference/api-reference","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}