---
title: "Get AVA details"
method: GET
path: "/avas/{ava_id}"
tags: ["Reference Data"]
---

# Get AVA details

`GET /avas/{ava_id}`

## Request

- Base URL: `https://app.colacloud.us/api/v1`
- URL: `https://app.colacloud.us/api/v1/avas/{ava_id}`
- Auth: one of:
  - API key in header `X-API-Key`
  - HTTP bearer

Retrieve detailed information for a single American Viticultural Area by its AVA ID.
Includes parent/child AVA relationships and regulatory references.

This endpoint is free — it does not consume quota.

## Path parameters

- `ava_id` string, required

## Response `200`

Successful response

- object
  - `data` AvaDetail: Summary view of an American Viticultural Area
    - `ava_id` string: Unique AVA identifier
    - `name` string: Official AVA name
    - `aka` string, nullable: Alternative name, if any
    - `states` string[], nullable: US states the AVA spans
    - `counties` string[], nullable: Counties the AVA spans
    - `established_date` string, date, nullable: Date the AVA was established
    - `removed_date` string, date, nullable: Date the AVA was removed, if applicable
    - `valid_start_date` string, date, nullable: Start date of the current AVA boundary definition
    - `valid_end_date` string, date, nullable: End date of the current AVA boundary definition
    - `parent_avas` string[], nullable: Parent AVA identifiers
    - `child_avas` string[], nullable: Child AVA identifiers
    - `petitioner` string, nullable: Entity that petitioned for the AVA
    - `cfr_author` string, nullable: Author of the CFR entry
    - `cfr_index` string, nullable: CFR index reference

## Other responses

- `401`: Missing or invalid API key or Bearer token
- `404`: Resource not found
- `429`: Quota or burst limit exceeded

---

[API](https://skmtc.dev/colacloud/apis/cola-cloud-api.md) · [All operations](https://skmtc.dev/colacloud/apis/cola-cloud-api/llms.txt) · [OpenAPI document](https://skmtc.dev/colacloud/apis/cola-cloud-api/revisions/1cb00a02112c?raw)