# Authentication

### Bearer Authentication

This API uses Bearer token authentication for secure access to protected endpoints.

#### Overview

Bearer authentication is a token-based authentication scheme where clients must include a valid access token in the `Authorization` header of their requests.

#### Getting Started

**1. Request Access Token**

To obtain an access token, send an email request to: **<developers@visadoc.co.uk>**

Include the following information in your email:

* Your name/organization
* Intended use case for the API
* Any relevant project details

You will receive your personal access token via email response.

**2. Using Your Token**

Include your token in the `Authorization` header of all API requests:

```
Authorization: Bearer YOUR_ACCESS_TOKEN
```

#### Example Request

```bash
curl -X GET "https://api.visadoc.co/api:v1/{{endpoint}}" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
```

#### Authentication Errors

* **401 Unauthorized**: Missing or invalid token
* **403 Forbidden**: Token expired or insufficient permissions

#### Security Notes

* Keep your token secure and never expose it in client-side code
* Tokens do not expire automatically but may be revoked if misused
* Contact us immediately if you suspect your token has been compromised

#### Need Help?

For token requests, issues, or questions, contact: **<developers@visadoc.co.uk>**