> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dokstamp.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> Welcome to the DokStamp API — issue, sign, and verify digital credentials at scale.

# DokStamp API

**DokStamp** is a multi-tenant platform for managing and issuing digital credentials — diplomas, academic transcripts, course certificates, and digital badges. The REST API lets you integrate credential issuance directly into your institution's systems.

<CardGroup cols={2}>
  <Card title="Quick Start" icon="bolt" href="/en/getting-started/quickstart">
    Issue your first certificate in under 10 minutes.
  </Card>

  <Card title="Entity Registration Order" icon="list-ol" href="/en/core-concepts/entity-registration-order">
    Understand the correct order to register entities before issuing certificates.
  </Card>

  <Card title="API Reference" icon="code" href="/en/api-reference/authentication/login">
    Full reference for every endpoint, parameter, and response field.
  </Card>

  <Card title="Certificate Lifecycle" icon="arrow-right-arrow-left" href="/en/core-concepts/certificate-lifecycle">
    From draft to issued, revoked, and expired — how certificates change state.
  </Card>
</CardGroup>

***

## What you can do

* **Issue digital certificates** — bind a student, course, and signed PDF into a verifiable credential
* **Sign documents** — route documents to third-party signers or sign institutionally with a digital certificate
* **Verify credentials** — expose a public URL per certificate for third-party verification
* **Issue Open Badges** — emit W3C-compliant digital badges linked to courses
* **Build student portfolios** — let students curate and share their credentials publicly

***

## Base URL

All API requests use the following base URL:

```
https://api.dokstamp.com
```

***

## Authentication overview

The API uses **Bearer token** authentication (JWT via Laravel Passport). Obtain a token by posting credentials to `POST /auth/login`. Tokens are long-lived (1 year) and can be refreshed with `POST /auth/refresh`.

All protected endpoints require:

```http theme={null}
Authorization: Bearer {your_access_token}
Accept: application/json
X-Tenant: {your_tenant_id}
```

See [Authentication](/en/getting-started/authentication) for full details.

***

## Response format

All responses return JSON. Successful responses follow this envelope:

```json theme={null}
{
  "data": { ... },
  "meta": {
    "current_page": 1,
    "per_page": 15,
    "total": 42
  }
}
```

Errors follow a consistent structure:

```json theme={null}
{
  "message": "The given data was invalid.",
  "errors": {
    "email": ["The email field is required."]
  }
}
```

***

## Need help?

Contact your account manager or open a support ticket through the [DokStamp dashboard](https://app.dokstamp.com).
