---
title: "/v2/assinaturas"
method: POST
path: "/v2/assinaturas"
---

# /v2/assinaturas

`POST /v2/assinaturas`

## Request

- Base URL: `https://totvssign.staging.totvs.app/identityintegration`
- URL: `https://totvssign.staging.totvs.app/identityintegration/v2/assinaturas`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/totvs/apis/api-identityintegration-autentica-o/docs/v2/assinaturas/post.ts> (a function with typed inputs; its response is checked against the schema)

endpoint para assinar eletronicamente, validar ou testemunhar um documentoendpoint só acessível para usuários com a Role: AssinadorArquivos

## Request body

- object
  - `idDocumento` integer, required: identificador do documento
  - `tipoDeAssinatura` integer, required: Tipo de assinatura (Eletronica = 0 , Validador = 2 , Testemunha = 4 )
  - `enderecoIp` string: Ip do Assinante
  - `enderecoIpV6` string: IPV6 do usuário (se disponível)
  - `geoLocalizacao` string: Coordenada geografica da localização do usuário
  - `papelAssinante` string: Papel do destinatário na assinatura

## Response `200`

200

- object
  - `success` boolean
  - `data` unknown
  - `message` string

## Other responses

- `400`: 400

---

[API](https://skmtc.dev/totvs/apis/api-identityintegration-autentica-o.md) - [All operations](https://skmtc.dev/totvs/apis/api-identityintegration-autentica-o/llms.txt) - [OpenAPI document](https://skmtc.dev/totvs/apis/api-identityintegration-autentica-o/revisions/0f43855140b5?raw)