# Get Object Status

This is a pre-built Action located under the **@Captured Checkbox Element**. The functionality of this Action in **Avo Assure** is to verify whether the specified checkbox is selected or not within the application and stores the result in a dynamic variable for further use during test execution. 

## Syntax

**Input Value**: `N/A` 

<table><thead><tr><th>Argument</th><th>Description</th><th data-hidden></th></tr></thead><tbody><tr><td>N/A</td><td>Not Applicable</td><td></td></tr></tbody></table>

**Output Value**: `<Dynamic Variable>;<Dynamic Variable>(Optional)`

<table><thead><tr><th>Argument</th><th>Description</th><th data-hidden></th></tr></thead><tbody><tr><td>&#x3C;Dynamic Variable>(Required)</td><td>This Dynamic Variable stores the Checkbox status (e.g., Unselected or Selected).</td><td></td></tr><tr><td>&#x3C;Dynamic Variable>(Optional)</td><td>This Dynamic Variable stores the status as <strong>True</strong> or <strong>False</strong>.</td><td></td></tr></tbody></table>

### **Example: Retrieving the Status of a Checkbox Object**

In this example, we explain how to use the **Get Object Status** action to retrieve the current state of a specified checkbox during test execution.

* **Action**: Get Object Status
* &#x20;**Input Value**: N/A
  * This action does not require any input value. It directly checks the current status of the targeted checkbox object.
* **Output Value**: {Get Status}
  * The retrieved button status (e.g., Selected or Unselected) is stored in this **{Get Status}** dynamic variable.
  * If a second output variable is provided, the action returns the status as True/False:
    * **True**: If the checkbox status is retrieved successfully.
    * **False**: If the checkbox status is not retrieved successfully.
* **Logical Explanation**: The **Get Object Status** action evaluates the status of the specified checkbox object and retrieves its current status as selected or unselected and stores in the **{Get Status}** variable.

<figure><img src="/files/zTN2Y1Bfh3yUgpzx3P6f" alt=""><figcaption></figcaption></figure>


---

# 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.avoautomation.com/avo-assure/actions/web/checkbox/get-object-status.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.