🚧 The Signature.nc API documentation in under construction, feel free to contact-us.
docs
v3.0
API
Submissions
Get a submission

Get a submission

GET/submissions/{uuid}

The API endpoint returns a single submission by its uuid, including signer signing details and the audit document (when generated). The submission must belong to the token's user.

Parameters

  • uuid String
    The unique identifier of the submission.
NodeJS
var axios = require("axios").default;
 
var options = {
  method: 'GET',
  url: 'https://api.signature.nc/api/v3/submissions/27f4235b-e0a5-47fd-a3a3-723462f57a7c',
  headers: {'Authorization': 'Bearer {apiKey}'}
};
 
axios.request(options).then(function (response) {
  console.log(response.data);
}).catch(function (error) {
  console.error(error);
});
json
{
    "name": "Acme NDA",
    "uuid": "27f4235b-e0a5-47fd-a3a3-723462f57a7c",
    "createdAt": "2026-06-22T10:00:00.000Z",
    "updatedAt": "2026-06-22T10:05:00.000Z",
    "senderInformation": {
        "ipAddress": "172.20.0.1",
        "userAgent": "PostmanRuntime/7.43.3",
        "locale": null
    },
    "template": {
        "name": "Acme NDA",
        "uuid": "f58749b1-4416-4618-80ea-bf12e5e1e1c4",
        "createdAt": "2026-06-22T10:00:00.000Z",
        "updatedAt": "2026-06-22T10:00:00.000Z"
    },
    "createdBy": {
        "firstname": "Owner",
        "lastname": "User",
        "email": "owner@acme.com"
    },
    "submitters": [
        {
            "email": "jane@acme.com",
            "firstname": "Jane",
            "lastname": "Doe",
            "uuid": "b68ccfd3-1717-4f6e-9a25-17a574db5e9f",
            "signatureLink": "http://localhost:3000/sign/b68ccfd3-1717-4f6e-9a25-17a574db5e9f",
            "status": "completed",
            "signedDocuments": [
                {
                    "name": "contract.pdf",
                    "ext": ".pdf",
                    "mime": "application/pdf",
                    "url": "https://signaturencdevelopment.s3-accelerate.amazonaws.com/contract_b43702b0e1.pdf?X-Amz-Signature=..."
                }
            ],
            "signerInformation": {
                "ipAddress": "172.20.0.1",
                "userAgent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15) Firefox/136.0",
                "locale": "en-US,en;q=0.5"
            },
            "completedAt": "2026-06-22T10:05:00.000Z"
        }
    ]
}

Errors

  • 400 "Submission unknown" — no submission matches the uuid.
  • 401 "This action is unauthorized." — the submission is not owned by the token's user.