# UANATACA eSAW ONE-SHOT API DOCUMENTATION

eSAW One-Shot combines Uanataca single-use certificate issuance with eSignAnywhere (eSAW) for electronic signatures.

**Testing:** Uanataca `https://api.sandbox.modernpki.com`, eSAW `https://demo.esignanywhere.net`
**Production:** Uanataca `https://api.modernpki.com`, eSAW `https://saas.esignanywhere.net`

Uanataca endpoints use client certificate authentication; eSAW endpoints use the `ApiToken` header.


Version: v1

## Security

### ApiToken

API key for eSignAnywhere (Files and Envelope endpoints). Generated in the eSAW user panel.

Type: apiKey
In: header
Name: ApiToken

## Download OpenAPI description

[UANATACA eSAW ONE-SHOT API DOCUMENTATION](https://docs.namirial.app/_bundle/products/namirialpkiaas/esaw-one-shot/openapi.yaml)

## Create

Create a certificate request and obtain esaw_token for use in the envelope

### Create certificate request

 - [POST /api/v1/esawoneshot](https://docs.namirial.app/products/namirialpkiaas/esaw-one-shot/openapi/create/createesawoneshotrequest.md): Creates a certificate request for the signer. The response includes req_pk and esaw_token.
Use esaw_token as requestToken in the envelope's SignaturePluginData (GenericSigningPluginBit4idOneShot) when sending the envelope.

## Files

Upload files for use in envelopes

### Upload file

 - [POST /Api/v6/file/upload](https://docs.namirial.app/products/namirialpkiaas/esaw-one-shot/openapi/files/uploadfile.md): Uploads a document to the eSAW platform. Call once per document to be signed.
Returns a FileId to use in the envelope send request.

## Envelope

Create and send envelopes

### Create and send envelope

 - [POST /Api/v6/envelope/send](https://docs.namirial.app/products/namirialpkiaas/esaw-one-shot/openapi/envelope/sendenvelope.md): Creates and sends an envelope. Include the FileId from the file upload and, in the Sign activity,
set SignaturePluginData for GenericSigningPluginBit4idOneShot with requestToken set to the esaw_token from the create request.