# Introduction

## Welcome :wave:

Many features of the Halo Security Platform are currently incorporated into the API, including the ability to:

* View information about Targets, as well as add and modify them.
* Retrieve information about on-going and past Scans and launch new ones.
* View Technology and vulnerable versions of Software, Javascript, and Firewall services.
* List Issues that have been found and update their status.
* Submit in-scope PCI assets for attestation.
* Create Webhooks that are triggered on Events.
* Manage account functionality.

For more information about the Halo Security Platform please visit the [site](https://www.halosecurity.com/).

This documentation is under construction and the API is currently in beta. Please use caution as endpoints and specifications are subject to change.

Check back for more soon. We're working on hard on building an incredible API.

## Accessing the Halo Security API

The Halo Security API endpoint is accessible at `https://api.halosecurity.com/api/v1/`

An API key is required for all requests. For additional information please see the [Authentication](/api/authentication.md) section.

## Rate Limits

The Halo Security API has rate limits to ensure optimal performance for all users. By default, accounts are limited to:

* 300 requests per minute
* 100,000 requests per day

If you need higher limits for your use case, please [contact us](https://www.halosecurity.com/contact) to discuss increasing your rate limits.


---

# 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://docs.halosecurity.com/api/readme.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.
