---
title: "Attach signature on annotation"
method: POST
path: "/omni/attach-signature-on-annotation"
tags: ["Electronic signature"]
---

# Attach signature on annotation

`POST /omni/attach-signature-on-annotation`

Attach signature from interview to previously uploaded PDF contracts at all places annotated with text from request,
with desired height on pdf. Annotations must contain text with either preselected values, or alternative can be supplied.
If user wishes to use signature supplied during onboarding, DEFAULT signature type should be used.

Preselected values are: DEFAULT, INITIALS, PATIENTS_SIGNATURE, NON_MEDICAL_SIGNATURE_1, NON_MEDICAL_SIGNATURE_2,
MEDICAL_SIGNATURE_1, MEDICAL_SIGNATURE_2

Endpoint is intended to be used as fluent api. One call to the api gives in responses id of the signed document which
can then be used in the subsequent call to continuously add another signature on a different annotation.

## Query parameters

- `interviewId` string

## Headers

- `api-version` string, required

## Request body

- AttachSignatureOnAnnotationRequest
  - `contractId` string, required — IDs of previously added contract (ID is returned on /add/document?imageType=contract)
  - `signedContractId` string — IDs of previously signed contract (ID is returned as response from the previous /attach/signature/on/annotation)
  - `signatureType` 'DEFAULT' | 'INITIALS' | 'PATIENTS_SIGNATURE' | 'NON_MEDICAL_SIGNATURE_1' | 'NON_MEDICAL_SIGNATURE_2' | 'MEDICAL_SIGNATURE_1' | 'MEDICAL_SIGNATURE_2' | 'MEDICAL_SIGNATURE_3' | 'PATIENTS_SIGNATURE_NAME' | 'NON_MEDICAL_SIGNATURE_1_NAME' | 'NON_MEDICAL_SIGNATURE_2_NAME' | 'MEDICAL_SIGNATURE_1_NAME' | 'MEDICAL_SIGNATURE_2_NAME' — One of the preselected values for annotation text
  - `alternativeSignatureType` string — If annotation text is none of the preselected values, pass in here the alternative value (signature must be inserted with the alternative value into database as it's signature type)

## Response `200`

OK

- ExtendedResponse
  - `success` boolean — Flag indicating request passed successfully.
  - `sessionStatus` 'Alive' | 'Closed' | 'Deleted' — Session status
  - `additionalInformation` object

## Other responses

- `400` — Bad Request

---

[API](https://skmtc.net/incode/apis/incode-omni-api.md) · [All operations](https://skmtc.net/incode/apis/incode-omni-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/incode/incode-omni-api/versions/30cd6d926ea3/schema)