Skip to main content
GET
/
avas
List American Viticultural Areas
curl --request GET \
  --url https://app.colacloud.us/api/v1/avas \
  --header 'X-API-Key: <api-key>'
{
  "data": [
    {
      "ava_id": "<string>",
      "name": "<string>",
      "aka": "<string>",
      "states": [
        "<string>"
      ],
      "counties": [
        "<string>"
      ],
      "established_date": "2023-12-25",
      "removed_date": "2023-12-25"
    }
  ],
  "meta": {
    "total": 123
  }
}

Authorizations

X-API-Key
string
header
required

API key passed in the X-API-Key header

Query Parameters

state
string

Filter by state (matches within the states array)

q
string

Search by AVA name (partial match, case-insensitive)

Response

Successful response

data
object[]
meta
object

Response metadata with total count