# CVS REST API – Quick Start

> **Base URL** `https://cvs.instantcard.net/api/v1/`

## 1  Authenticate
```bash
POST /api/login
{
  "email":    "your_user@example.com",
  "password": "your_password"
}
```
Response → `{ "access_token": "...", "role": "company admin", ... }`  
Use the token as `?access_token=TOKEN` (or `Authorization: Bearer TOKEN`) on subsequent calls.

## 2  Key Endpoints
| Endpoint | Verb | Purpose |
|----------|------|---------|
| `/users` | GET / POST | List or create employee records |
| `/users/{id}` | GET | Retrieve a single employee + credentials |
| `/credentials` | POST | Add a training record (user, course, dates, file link) |
| `/qualifications` | GET / POST | List or define training types |
| `/scan/{qr}` | GET | Returns read-only profile for QR verification |

## 3  Sandbox
Try live calls in the web sandbox: `https://cvs.instantcard.net/api_test` (log in first).

## 4  Rate Limits
60 requests/min/IP by default – contact support to raise.

## 5  Support
📧 api@instantcard.net  📞 +1-301-216-3846

_Last updated 2025-07-10_