`SUM`

returns the total of one or more numbers. It can take an arbitrary number of optional arguments.

**Function category:** Statisticalâ€‹

For numerical functions (like SUM, AVERAGE, and ROUND), incoming values will be coerced into numbers where possible. If a key in the data source has been deleted (meaning no value is now returned), this will yield an error as a null value cannot be coerced into a number.

`SUM(arg1, [arg2, ...])`

Arguments | Description |

| A number. |

| Optional. Same requirements as |

Let's say we're given a response with the following vehicle information:

{"vehicle_info":{"vin":"16m2flcb1","make":"Ford","model":"Mustang GT500","cylinders":8,"horsepower":460,"weight_kg":1720}}

If we want an create an endpoint with an attribute called `horsepower_plus_weight`

, we can access and sum the values of the respective keys of the `vehicle_info`

object using this function.

# Sum two diferent valuesSUM(vehicle_info.horsepower, vehicle_info.weight_kg)â€‹# Returns 2180

If we want to find the sum of multiples of the same value, use the following function.

# Sum two identical valuesSUM(vehicle_info.horsepower, vehicle_info.horsepower)â€‹# Returns 920

If we want to find the value of a single key, which in this case is the number fo cylinders, use the following function.

# Sum of a single valueSUM(vehicle_info.cylinders)â€‹# Returns 8

If we want to find the value of a set of four integers and one reference, use the following function.

# Sum of integers and a valueSUM(20, 20, 25, 25, vehicle_info.horsepower)â€‹# 550