---
title: "Sign a PDF (file upload)"
method: POST
path: "/api/signatures/sign/upload"
tags: ["Digital Signatures"]
---

# Sign a PDF (file upload)

`POST /api/signatures/sign/upload`

## Request

- Base URL: `https://api.dokmatiq.com`
- URL: `https://api.dokmatiq.com/api/signatures/sign/upload`
- Auth: API key in header `X-API-Key`

Upload a PDF and a PKCS#12 certificate to sign the document. Alternative to the Base64-based endpoint.

## Query parameters

- `password` string, required
- `reason` string
- `location` string
- `contactInfo` string
- `signerName` string
- `timestampUrl` string

## Response `200`

Signed PDF

## Other responses

- `400`: Invalid request or certificate

---

[API](https://skmtc.dev/dokmatiq/apis/docgen-api.md) · [All operations](https://skmtc.dev/dokmatiq/apis/docgen-api/llms.txt) · [OpenAPI document](https://skmtc.dev/dokmatiq/apis/docgen-api/revisions/3fa1a922764d?raw)