---
title: "/v4 /classes.json /classes.json"
method: GET
path: "/classes.json"
tags: ["features"]
---

# /v4 /classes.json /classes.json

`GET /classes.json`

## Request

- Base URL: `https://api.nearmap.com/ai/features/v4`
- URL: `https://api.nearmap.com/ai/features/v4/classes.json`
- Auth: one of:
  - API key in query parameter `apikey`
  - API key in header `Authorization`
  - API key in header `Authorization`

Returns detailed information about the feature and attribute classes
available to the user calling the API.

## Query parameters

- `bulk` boolean

## Response `200`

OK

- ClassesReport: Classes available to the user.
  - `classes` ClassesEndpointClass[], required: The available feature and attribute classes.
    - `type` 'Attribute' | 'Feature': The class type.
    - `id` string: A unique identifier that can be used to refer to the class.
    - `description` string: The user friendly human description of the class.
    - `schema` object: A JSON Schema object that represents the schema of attributes with this attribute class ID. More details of JSON Schema can be found at https://json-schema.org/. This field is only applicable for attribute classes.
    - `availability` object[]: Details about the availability of the class.
      - `systemVersion` string, required: The version of the system used to generate the AI Data.
      - `perspective` 'Vert' | 'TrueOrtho', required: The perspective used to generate the AI data.
      - `status` 'prod' | 'beta' | 'alpha', required: The stage of the software release cycle that the class is in for the system version and perspective combination.

## Other responses

- `401`: Unauthorized
- `403`: Forbidden

---

[API](https://skmtc.dev/nearmap/apis/ai-feature-api.md) - [All operations](https://skmtc.dev/nearmap/apis/ai-feature-api/llms.txt) - [OpenAPI document](https://skmtc.dev/nearmap/apis/ai-feature-api/revisions/0522585e7ef3?raw)