# Classifications

The `classifications` object is part of the [`task`](/data/importing-and-exporting-annotations/exporting-annotations/ango-export-format/asset/task.md) object in the Ango Annotation Format. It contains all annotation data pertaining to labels created with *classifications*, e.g. not tools, relations, or brushes.

## General Structure

{% code fullWidth="true" %}

```json
"classifications" : [
    {
        answer // object OR list, classification answers
        objectId // string, ID of the classification
        schemaId, // string, ID of the classification class in the project
        classifications, // list, nested classifications
        title // string, title of the classification
        page // int, optional, if asset is multi-page, page where the classification takes place
        tool // string, name of the tool (radio, dropdown, etc.)
        metadata // dict, optional, metadata regarding the annotation (creation date, etc.)
        interpolationStopped // bool, optional, whether in multi-frame assets the classification disappears from this frame on
    },
    { ... }
]
```

{% endcode %}

### Common Properties

<table data-full-width="true"><thead><tr><th width="201">Property</th><th width="90.33333333333331">Type</th><th>Description</th></tr></thead><tbody><tr><td><code>objectId</code></td><td>String</td><td><p>Object ID of the classification. Unique in the asset.</p><pre class="language-json"><code class="lang-json">"objectId": "6b8a4338d299c63b5ee7825"
</code></pre></td></tr><tr><td><code>schemaId</code></td><td>String</td><td><p>ID of the class to which the classification belongs.</p><pre class="language-json"><code class="lang-json">"schemaId": "4460fa700ef030c4e575604"
</code></pre></td></tr><tr><td><code>tool</code></td><td>String</td><td>Type of classification.</td></tr><tr><td><code>title</code></td><td>String</td><td><p>Name of the class.</p><pre class="language-json"><code class="lang-json">"title": "Image Projection Type"
</code></pre></td></tr><tr><td><code>metadata</code></td><td>Dict</td><td>Only appears if the <em>Annotation Metadata</em> toggle has been turned on before export.<br><br><code>createdAt</code>: int, Time of creation in Unix epoch time in milliseconds. GMT.<br><code>createdBy</code>: string, email of user creating the classification<br><code>createdIn</code>: string, ID of the stage in which the classification was first answered.<br><code>updatedAt</code>: int, optional. Time of last classification update in Unix millisecond epoch time. GMT. Only appears if answer has been updated.<br><code>updatedBy</code>: string, optional. email of user last updating the classification. Only appears if answer has been updated.<br><code>updatedIn</code>: string, optional. ID of the stage in which the classification was last updated. Only appears if answer has been updated.</td></tr><tr><td><code>classifications</code></td><td>List</td><td><p>List of nested classifications (if any). May contain further nested classifications in its own <code>classifications</code> property.</p><pre class="language-json"><code class="lang-json">"classifications": [    
{
      "objectId": "78d263ed59db8dd1dcb4666",
      "schemaId": "4460fa700ef030c4e575604",
      "tool": "radio",
      "title": "Nested Radio",
      "answer": "1",
      "metadata": {
        "createdAt": "2023-09-05T10:28:18.667Z",
        "createdBy": "lorenzo@example.net",
        "createdIn": "Complete"
     },
    "classifications": []
  }
]
</code></pre></td></tr></tbody></table>

## Radio

```json
{
    "objectId": "a390f9434a330d14cf16759",
    "schemaId": "4460fa700ef030c4e575604",
    "tool": "radio",
    "title": "Image Projection Type",
    "answer": "Orthogonal",
    "metadata": {
        "createdAt": "2023-09-05T10:32:57.760Z",
        "createdBy": "lorenzo@example.net",
        "createdIn": "194e870c-5255-4ec9-9e6d-392321e504c3"
    },
    "classifications": []
}
```

<table data-full-width="true"><thead><tr><th width="201">Property</th><th width="90.33333333333331">Type</th><th>Description</th></tr></thead><tbody><tr><td><code>answer</code></td><td>String</td><td><p>The answer picked by the annotator.</p><pre><code>"answer": "Red"
</code></pre></td></tr></tbody></table>

{% hint style="info" %}
**See also**

[Radio](/labeling/labeling-tools/classification-tools/radio.md)
{% endhint %}

## Checkbox

```json
{
    "objectId": "5ad8ed43d4c036e799fd617",
    "schemaId": "1ea7a275ce5c9cf30a6f148",
    "tool": "checkbox",
    "title": "Vehicle Color(s)",
    "answer": [
        "Red",
        "Yellow"
    ],
    "metadata": {
        "createdAt": "2023-09-06T07:34:23.618Z",
        "createdBy": "lorenzo@example.net",
        "createdIn": "Complete",
        "updatedAt": "2023-09-06T07:34:24.877Z",
        "updatedBy": "lorenzo@example.net",
        "updatedIn": "Complete"
    },
    "classifications": []
}
```

<table data-full-width="true"><thead><tr><th width="201">Property</th><th width="90.33333333333331">Type</th><th>Description</th></tr></thead><tbody><tr><td><code>answer</code></td><td>List</td><td><p>The answer(s) picked. Always a list, even if only one item was selected.</p><pre class="language-json"><code class="lang-json">"answer": [
    "Red",
    "Yellow"
]
</code></pre></td></tr></tbody></table>

{% hint style="info" %}
**See also**

[Checkbox](/labeling/labeling-tools/classification-tools/checkbox.md)
{% endhint %}

## Single-Select Dropdown

```json
{
    "objectId": "9bca9ffa05869a4b60d9751",
    "schemaId": "a2b4a50bb90eb6523b88376",
    "tool": "single-dropdown",
    "title": "Image Projection Type",
    "answer": "Orthogonal",
    "metadata": {
        "createdAt": "2023-09-06T07:34:29.751Z",
        "createdBy": "lorenzo@example.net",
        "createdIn": "Complete"
    },
    "classifications": []
}
```

<table data-full-width="true"><thead><tr><th width="201">Property</th><th width="90.33333333333331">Type</th><th>Description</th></tr></thead><tbody><tr><td><code>answer</code></td><td>String</td><td><p>The answer picked by the annotator.</p><pre class="language-json"><code class="lang-json">"answer": "Orthogonal"
</code></pre></td></tr></tbody></table>

{% hint style="info" %}
**See also**

[Single-Select Dropdown](/labeling/labeling-tools/classification-tools/single-dropdown.md)
{% endhint %}

## Multi-Select Dropdown

```json
{
    "objectId": "23d2beed0c3958e02d9c315",
    "schemaId": "11f6ed8e4ac4852d3422341",
    "tool": "multi-dropdown",
    "title": "Vehicle Colors",
    "answer": [
        "Red",
        "Yellow"
    ],
    "metadata": {
        "createdAt": "2023-09-06T07:34:32.316Z",
        "createdBy": "lorenzo@example.net",
        "createdIn": "Complete",
        "updatedAt": "2023-09-06T07:34:32.599Z",
        "updatedBy": "lorenzo@example.net",
        "updatedIn": "Complete"
    },
    "classifications": []
}
```

<table data-full-width="true"><thead><tr><th width="201">Property</th><th width="90.33333333333331">Type</th><th>Description</th></tr></thead><tbody><tr><td><code>answer</code></td><td>List</td><td><p>The answer(s) picked. Always a list, even if only one item was selected.</p><pre class="language-json"><code class="lang-json">"answer": [
    "Red",
    "Yellow"
]
</code></pre></td></tr></tbody></table>

{% hint style="info" %}
**See also**

[Multi-Select Dropdown](/labeling/labeling-tools/classification-tools/multiple-dropdown.md)
{% endhint %}

## Tree Dropdown

```json
{
    "objectId": "2c786a2d76113b135f7a680",
    "schemaId": "c2b5eb27e55b186f84f3898",
    "tool": "tree-dropdown",
    "title": "Vehicle Color",
    "answer": [
        "Red",
        "Yellows / Dark Yellow"
    ],
    "metadata": {
        "createdAt": "2023-09-06T07:34:36.681Z",
        "createdBy": "lorenzo@example.net",
        "createdIn": "Complete",
        "updatedAt": "2023-09-06T07:34:39.489Z",
        "updatedBy": "lorenzo@example.net",
        "updatedIn": "Complete"
    },
    "classifications": []
}
```

<table data-full-width="true"><thead><tr><th width="201">Property</th><th width="90.33333333333331">Type</th><th>Description</th></tr></thead><tbody><tr><td><code>answer</code></td><td>List</td><td><p>The answer(s) picked. Always a list, even if only one item was selected.</p><pre class="language-json"><code class="lang-json">"answer": [
        "Reds",
        "Yellows / Dark Yellows / Ochre"
]
</code></pre><p>Answers nested within another are displayed after a <code>/</code>. For example, to get the sample above, the annotator selected the following answers in the UI:<br><img src="/files/VieRGZGvb5rNM4fetmJO" alt=""></p></td></tr></tbody></table>

{% hint style="info" %}
**See also**

[Tree Dropdown](/labeling/labeling-tools/classification-tools/tree-dropdown.md)
{% endhint %}

## Text

```json
{
    "objectId": "4ff3710fd7cdc644b7dd283",
    "schemaId": "6590a72d09f1760a4578032",
    "tool": "text",
    "title": "txt",
    "answer": "Answer Text Here",
    "metadata": {
        "createdAt": "2023-09-06T07:34:41.283Z",
        "createdBy": "lorenzo@example.net",
        "createdIn": "Complete",
        "updatedAt": "2023-09-06T07:34:42.430Z",
        "updatedBy": "lorenzo@example.net",
        "updatedIn": "Complete"
    },
    "classifications": []
}
```

<table data-full-width="true"><thead><tr><th width="201">Property</th><th width="90.33333333333331">Type</th><th>Description</th></tr></thead><tbody><tr><td><code>answer</code></td><td>String</td><td><p>The answer written by the annotator.</p><pre class="language-json"><code class="lang-json">"answer": "6 Chained Street, Military Academy District, Ankara, Turkey"
</code></pre></td></tr></tbody></table>

{% hint style="info" %}
**See also**

[Text](/labeling/labeling-tools/classification-tools/text.md)
{% endhint %}

## File Upload Box

```json
{
    "objectId": "b0f7f4c7f7e14d2a8b3fcb42",
    "schemaId": "58af1b9c7f334a939afbbf89",
    "tool": "upload-box",
    "title": "Upload supporting file",
    "answer": "https://example-bucket.s3.amazonaws.com/project-id/upload-box/task-id/evidence.pdf?X-Amz-Algorithm=AWS4-HMAC-SHA256...",
    "metadata": {
        "createdAt": "2026-04-29T10:32:57.760Z",
        "createdBy": "lorenzo@example.net",
        "createdIn": "194e870c-5255-4ec9-9e6d-392321e504c3"
    },
    "classifications": []
}
```

<table data-full-width="true"><thead><tr><th width="201">Property</th><th width="90.33333333333331">Type</th><th>Description</th></tr></thead><tbody><tr><td><code>answer</code></td><td>String</td><td><p>A signed URL to the file uploaded through the upload box.</p><p>The URL is generated during export and may expire.</p></td></tr></tbody></table>

{% hint style="info" %}
**See also**

[File Upload Box](/labeling/labeling-tools/data/file-upload-box.md)
{% endhint %}


---

# 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.imerit.net/data/importing-and-exporting-annotations/exporting-annotations/ango-export-format/asset/task/classifications.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.
