---
slug: "/docs/v1/api"
title: "API reference"
description: "Find real API v1 endpoints, errors, contract tools and signing requirements without following a tutorial."
section: "API reference"
order: 50
audience: "all"
level: "beginner"
last_updated: "2026-10-20"
version: "v1"
related: []
draft: false
layout: "hub"
---
## What you can do here
Find real API v1 endpoints, errors, contract tools and signing requirements without following a tutorial.

- [API conventions](/docs/v1/api/conventions) — Use KDPika API v1 with the correct credentials, JSON envelopes, [request IDs](/docs/v1/start/glossary#request-id), environment boundaries and safe retry assumptions.
- [Retrieve the public key](/docs/v1/api/public-key) — Retrieve the current [public verification key](/docs/v1/start/glossary#public-verification-key).
- [Create a license](/docs/v1/api/create-license) — Issue a license after your backend verifies the buyer purchase.
- [Activate an installation](/docs/v1/api/activate) — Bind a [customer](/docs/v1/start/glossary#customer) license to one persisted installation.
- [Validate an installation](/docs/v1/api/validate) — Refresh the signed state of an activated installation.
- [Deactivate an installation](/docs/v1/api/deactivate) — Release this installation [device](/docs/v1/start/glossary#device) seat.
- [Retrieve a license](/docs/v1/api/get-license) — Read a scoped unsigned license summary.
- [Revoke a license](/docs/v1/api/revoke) — Revoke a license and its active tokens.
- [Suspend a license](/docs/v1/api/suspend) — Suspend an eligible license and invalidate its active tokens.
- [Restore a license](/docs/v1/api/restore) — Restore an eligible license without reviving old tokens.
- [Renew a license](/docs/v1/api/renew) — Extend license expiry without charging or changing its plan.
- [Reset license devices](/docs/v1/api/reset-devices) — Release [active devices](/docs/v1/start/glossary#active-devices) and revoke their tokens.
- [Errors and safe user messages](/docs/v1/api/errors) — Handle every current licensing error, distinguish SDK-local and operational codes, and give users a safe next step.
- [Rate limits and bounded retries](/docs/v1/api/rate-limits) — Use exact licensing API windows and headers, avoid request loops, and distinguish rate limits from monthly usage allowances.
- [Idempotency and uncertain outcomes](/docs/v1/api/idempotency) — Choose stable creation keys, understand actual 24-hour replay limits, and avoid repeating uncertain license mutations.
- [OpenAPI specification](/docs/v1/api/openapi) — Download the complete source-validated OpenAPI 3.1 licensing contract, including actual statuses, errors, headers and examples.
- [Contract testing](/docs/v1/api/contract-testing) — Test every licensing operation and error shape against OpenAPI using a safe isolated [Sandbox](/docs/v1/start/glossary#sandbox) fixture and reproducible checks.
- [API client collections](/docs/v1/api/collections) — Download Postman, Insomnia and Bruno collections with Sandbox variables, assertions and a complete11-operation test sequence.
- [Try the Sandbox API](/docs/v1/api/try-it) — Inspect real same-origin Sandbox licensing requests without storing credentials, using [Live](/docs/v1/start/glossary#live) keys or requiring a [developer](/docs/v1/start/glossary#developer) account to read.
- [API v1 changelog](/docs/v1/api/api-changelog) — Track source-verifiable API documentation snapshots separately from [product](/docs/v1/start/glossary#product) releases and SDK versions.
- [Versioning and deprecation](/docs/v1/api/versioning-and-deprecation) — Understand API v1 compatibility boundaries, current notification limitations and a practical upgrade checklist.

## Next steps
[Follow the Complete Integration Guide](/docs/v1/integration-guide)