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

# Introduction

> Welcome to the Petra Security API documentation

<Note>For common API errors, see [API Troubleshooting](/api-reference/troubleshooting).</Note>

## Overview

The Petra Security API provides programmatic access to security data and functionality within your Petra portal. Use our API to integrate Petra's security capabilities into your own applications and workflows.

## Base URL

All API requests should be made to:

```
https://api.petrasecurity.com
```

## Authentication

The Petra API uses Bearer token authentication. You'll need to include your API key in the Authorization header of all requests:

```
Authorization: Bearer YOUR_API_KEY
```

To get your API key, navigate to Settings in your [Petra portal](https://app.petrasecurity.com).

## Response Format

All API responses are returned in JSON format. Successful requests will return a `200 OK` status code along with the requested data.

## Getting Started

1. Obtain your API key from the Settings page in your Petra portal
2. Include the API key in your request headers
3. Make your first API call to the `/v1/usage` endpoint

Check out our [Authentication guide](/api-reference/authentication) for detailed setup instructions.