# Access and authentication

{% hint style="info" %}
DeepVerify API is currently in Alpha. While we don't anticipate the API format to change, it might. Contact us to get a alpha access and heads up on breaking changes.
{% endhint %}

## Getting your API Key

1. **Sign Up**: Create an account on the Factagora developer portal. 
2. **Generate API Key**: After registering, navigate to the API section of your dashboard and generate your unique API key. This key will be required for authenticating all API requests. 
3. **Secure Your API Key**: Treat your API key like a password—do not share it publicly or expose it in client-side code. If your key is compromised, you can regenerate it from the dashboard.

## Authentication Process 

The DeepVerify API uses token-based authentication. Include your API key in the Authorization header of each request using the following format:

```http
Authorization: Bearer YOUR_API_KEY
```

## **Making an Authenticated API Request** 

Here’s an example of how to send a request with your API key:

```wasm
curl -X POST "https://api.factagora.com/v1/deepverify"
-H "Authorization: Bearer YOUR_API_KEY"
-H "Content-Type: application/json"
-d '{"input_text": "The data you want to verify"}'
```

In this example:

* **YOUR\_API\_KEY** should be replaced with your actual API key. 
* **input\_text** is the text or data you want to submit for verification. 

## Error Handling 

If your API key is missing, invalid, or expired, the API will return an error message like the following:

```json
{ 
    "error": "Unauthorized", 
    "message": "Invalid or missing API key." 
} 
```

Make sure your API key is correct and active to avoid authentication errors.

## Best Practices 

* **Rotate Your API Keys**: Regularly rotate your API keys to ensure security. 
* **Limit Permissions**: If your API supports scopes, limit the permissions of your API key to only the necessary services. 
* **Monitor Usage**: Use the Factagora dashboard to monitor your API key usage and track potential misuse.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://factagora.gitbook.io/deepverify/getting-started/access-and-authentication.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.