List Statistics

List Statistics

Math & Calculations Credits / request: 1

Returns min, max, sum, average, median and standard deviation of a number list.

POST https://api.apikodu.com/api/v1/math/stats
Documentation
Overview

List statistics (min, max, average, median, deviation).

Authentication

Every request requires the x-api-key header. Credits used and remaining quota are returned in response headers (x-api-credits-used, x-api-remaining-credits, x-rate-limit-*).

Request
POST https://api.apikodu.com/api/v1/math/stats
JSON body: values number array.
Parameters
Name Type Required Default Options Description
values json * Required — — [10, 20, 30] max 10000 items.
Response
Name Type Description
count integer Number of items in values.
min number Minimum value.
max number Maximum value.
sum number Sum of all values.
average number Arithmetic mean (sum / count).
median number Median. Average of the two middle values when count is even.
standardDeviation number Sample standard deviation (n-1).
Errors
HTTP code Description
400 -246 values is missing, empty, or has more than 10000 items.
401 -100 x-api-key is missing, empty, malformed, inactive, banned, expired, IP-restricted, or not allowed for this API.
429 -221 Per-minute request limit exceeded. Response headers: x-rate-limit-limit, x-rate-limit-remaining, x-rate-limit-reset.
429 — Package credit quota cannot cover this request. Body may be { error, limit, currentUsage, requestCost } (no code field).
500 -1 Unexpected server error. message is a generic error text without technical details.
Notes
  • Success body is { data: { ... } }. Error body is { code, message }. code is an ApiResponseCode enum value (negative integer).

Sample response

{
  "data": {
    "count": 5,
    "min": 10.0,
    "max": 50.0,
    "sum": 150.0,
    "average": 30.0,
    "median": 30.0,
    "standardDeviation": 15.8113883
  }
}

Code samples

  
      const response = await fetch('https://api.apikodu.com/api/v1/math/stats', {
        method: 'POST',
        headers: {
          'Content-Type': 'application/json',
          'x-api-key': 'YOUR_API_KEY'
        },
        body: JSON.stringify({
          name: 'example',
          value: 123
        })
      });

      const data = await response.json();
      console.log(data);
  

  
      import requests

      headers = {
          'Content-Type': 'application/json',
          'x-api-key': 'YOUR_API_KEY'
      }

      payload = {
          'name': 'example',
          'value': 123
      }

      response = requests.post('https://api.apikodu.com/api/v1/math/stats', headers=headers, json=payload)
      data = response.json()
      print(data)
  

  
      using var client = new HttpClient();
      client.DefaultRequestHeaders.Add("x-api-key", "YOUR_API_KEY");

      var payload = new { name = "example", value = 123 };
      var json = JsonSerializer.Serialize(payload);
      var content = new StringContent(json, Encoding.UTF8, "application/json");

      var response = await client.PostAsync("https://api.apikodu.com/api/v1/math/stats", content);
      response.EnsureSuccessStatusCode();

      var data = await response.Content.ReadAsStringAsync();
      Console.WriteLine(data);
  

 
     $data = [
         'name' => 'example',
         'value' => 123
     ];

     $response = file_get_contents('https://api.apikodu.com/api/v1/math/stats', false, stream_context_create([
         'http' => [
             'header' => "x-api-key: YOUR_API_KEY"
         ],
         'method'  => 'POST',"
         'content' => json_encode($data)
      ]));

      print_r(json_decode($response, true));
 

  
      curl -X POST 'https://api.apikodu.com/api/v1/math/stats' \
        -H 'Content-Type: application/json' \
        -H 'x-api-key: YOUR_API_KEY' \
        -d '{
          "name": "example",
          "value": 123
        }'

Start building in minutes

Create a free account, get your API key and send your first request in minutes.

Get started free