# Number Collection Get Value

## Overview

This action lets you easily retrieve a specific number from a collection of numbers. You can choose to get the first number, the last number, or a number at a specific position within the collection.

***

## **How it Helps**

Imagine you have a collection of order totals and need to find the highest total quickly. This action lets you retrieve the last number from a sorted collection (assuming it's sorted in ascending order) without writing any loops or complex formulas.

***

## **When to Use It**

This action is ideal for:

* **Accessing specific numbers in a collection.**
* **Retrieving the first, last, or any number by its position in the collection.**
* **Simplifying number retrieval without manual searching or complex formulas.**
* **Working with ordered collections where the position of numbers is important.**

***

## **Example**

To calculate the difference between the first and last values in a series of measurements:

1. **Create a Number Collection:** Have a Number Collection variable storing a series of measurements.
2. **Configure the Action (First Value):** Select the Number Collection variable and choose "First" as the operation to get the first measurement.
3. **Configure the Action (Last Value):** Repeat the previous step, but choose "Last" as the operation to get the last measurement.
4. **Calculate the Difference:** Use a Formula element to subtract the first and last values.

***

**Key Considerations**

* **Source Collection:** Ensure you have a valid collection of numbers.
* **Operation:** Choose the appropriate operation:
  * **First:** Retrieves the first number in the collection.
  * **Last:** Retrieves the last number in the collection.
  * **At Index:** Retrieves the number at a specific numerical index (starting from 0)


---

# 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.avonnicomponents.com/flow/actions/data-conversion-and-formatting/number-collection-get-value.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.