# Overview

The Skribble API lets you integrate legally binding electronic signatures and signature validation directly into your applications, workflows, and systems, whether you're automating contract signing, digitizing HR processes, or building compliance tooling.

## Available APIs

### Sign API v2

**Stable**: the current stable version of the signing API, recommended for all production integrations. Backward compatible with v1, so existing v1 integrations continue to work without changes.

### Sign API v3

:::warning{title="Preview: Subject to Change"}

Sign API v3 is a preview release. The API surface may change before general availability. Do not use it in production without accepting that breaking changes may occur.

:::

The next-generation signing API currently in preview. Key features:

- **Draft workflow**: Create signature requests in DRAFT status before initiating
- **Multi-document support**: Up to 50 documents per signature request
- **Flexible signer management**: Add/remove signers, support for signers without Skribble accounts
- **Multiple signature qualities**: SES, AES, and QES signatures
- **Compliance**: Supports both Swiss (ZertES) and EU (eIDAS) legislation

### Validation API v1

Validate digitally signed documents and certificates:

- **Document validation**: Verify PDF and XML signatures
- **Signature validation**: Validate CMS/CAdES signatures independently
- **Validation reports**: Generate ETSI TS 119 102-2 compliant and PDF validation reports

## Data Hosting Regions

| Region | Base URL | Data Residency |
|--------|----------|----------------|
| Switzerland | `https://api.skribble.com` | Switzerland |
| Germany | `https://api.skribble.de` | Germany / EU |

:::note

Use the region endpoint consistently for all requests. Mixing regions (e.g. creating a request on `api.skribble.com` and querying it on `api.skribble.de`) may cause data residency violations and unexpected errors.

:::

## Environment Overview

| Environment | Purpose | API Key Prefix |
|-------------|---------|----------------|
| Demo | Testing and development | `api_demo` |
| Production | Live transactions (billable) | `api_production` or `api_prod` |

## Quick Start

1. **Get API credentials**: Generate your API username and key in the [Admin UI](https://admin.skribble.com)
2. **Authenticate**: Call `/access/login` to obtain a JWT token
3. **First document to get signed**: Create and submit your first signature request using the [Sign API v2](/api/sign-v2)
4. **Handle responses**: Process results and implement appropriate error handling

## Support

For questions or support, reach us at [info@skribble.com](mailto:info@skribble.com).