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

# Quickstart

> Go from account creation to your first forensic analysis in minutes.

## 1. Setup your Environment

Before making your first API call, you'll need an active Veridox account and an API key.

<Steps>
  <Step title="Create an Account">
    Follow our [User Registration](./guides/user-registration) guide to sign up and receive administrator approval.
  </Step>

  <Step title="Generate an API Key">
    Once approved, log in to your regional dashboard ([uk.veridox.ai](https://uk.veridox.ai) or [ca.veridox.ai](https://ca.veridox.ai)):

    1. Navigate to **Settings**.
    2. Select the **Organisation** tab.
    3. Provide a **Name** and **Expiry Date** for the key.
    4. Click **Generate API Key**.
    5. Copy and securely store your key — it will only be shown once.
  </Step>

  <Step title="Verify Connectivity">
    Use the [Authentication Status](../api-reference/endpoints/auth-status) endpoint to ensure your key is valid and you can reach our servers.
  </Step>
</Steps>

## 2. Process your First Document

The core Veridox workflow involves creating a case, uploading your document, and retrieving the forensic results.

<Steps>
  <Step title="Create a Case Container">
    Initialise a new verification case. This generates a secure, pre-signed upload URL for your file.
    Case labels must be unique per user (case-insensitive), so pick a label that you are not already using.

    ```bash theme={null}
    curl -X POST "https://api.{region}.veridox.ai/cases" \
      -H "X-API-Key: vdx_your_api_key" \
      -H "Content-Type: application/json" \
      -d '{ "label": "Initial Test Case", "file_labels": ["document.pdf"] }'
    ```
  </Step>

  <Step title="Upload the Document">
    Upload your document directly to the `sas_url` provided in the previous step using an HTTP `PUT` request.
  </Step>

  <Step title="Retrieve Forensic Intelligence">
    Once analysis is complete, fetch the comprehensive report to see risk scores and tampering indicators.

    ```bash theme={null}
    curl -X GET "https://api.{region}.veridox.ai/files/{file_id}/analysis" \
      -H "X-API-Key: vdx_your_api_key"
    ```
  </Step>
</Steps>

## Next Steps

* [Explore the full API Reference](../api-reference/endpoints/cases-create)
* [Learn about forensic analysis engines](./guides/document-analysis)
* [Implement real-time progress updates](./guides/case-management#real-time-updates)