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

# AVERT Imagery API v1

> Access infrared and visible imagery data from AVERT volcanic monitoring systems

<Warning>
  **API v2.0.0 is now available!** The v1 API is now in legacy mode. We strongly recommend migrating to v2 for a unified endpoint, better filtering, and improved features. [Learn more about v2](/api-reference/v2/introduction) or [view migration guide](/api-reference/v2/migration-guide).
</Warning>

## Welcome

The AVERT Imagery API v1 (legacy) provides programmatic access to infrared and visible images captured by cameras directed towards target volcanoes. This API allows researchers and developers to query, filter, and download volcanic imagery data for analysis and monitoring purposes.

<Info>
  **Looking for the latest API?** Check out [API v2.0.0](/api-reference/v2/introduction) for a unified endpoint, advanced filtering, smart downloads, and more.
</Info>

## Available Endpoints

Our API currently supports two types of imagery data:

<CardGroup cols={2}>
  <Card title="Infrared Imagery" icon="thermometer" href="/api-reference/imagery/infrared-query">
    Query and download infrared thermal images from Cleveland volcano
  </Card>

  <Card title="Visible Imagery" icon="eye" href="/api-reference/imagery/visible-query">
    Query and download visible light images from Cleveland and Okmok volcanoes
  </Card>
</CardGroup>

## Base URL

All API requests should be made to:

```
https://avert-legacy.ldeo.columbia.edu/api
```

## Authentication

The AVERT Imagery API currently operates without authentication requirements for public data access. All endpoints are publicly accessible for research and educational purposes.

## Rate Limits

To ensure fair usage and system stability:

* Query endpoints: Limited to reasonable request rates
* Download endpoints: Bulk downloads (>100 images) should use individual image endpoints
* Zip downloads: Only available for queries returning ≤100 results

## Getting Started

To start using the API, you'll need:

1. A site identifier (e.g., "CLNE" for Cleveland Northeast)
2. A volcano number (vnum) for the target volcano
3. Optional time range parameters for filtering results

Check out our endpoint documentation for detailed examples and interactive API playground.

<CardGroup cols={2}>
  <Card title="Interactive Playground" href="/api-reference/imagery/infrared-query" icon="gamepad">
    Test API endpoints directly in your browser (may have display limitations)
  </Card>

  <Card title="Reliable Testing Tools" href="/api-reference/imagery/playground-alternative" icon="wrench">
    Postman, cURL, Python, and JavaScript examples that work perfectly
  </Card>
</CardGroup>

<Note>
  **Recommended**: For the best testing experience, use our [API Testing
  Alternatives](/api-reference/imagery/playground-alternative). The playground
  may have display issues with JSON responses, but these tools work flawlessly
  with the AVERT API.
</Note>