Commitments

Count sponsorship worksheet footer values

Counts blank, filled and unique values over all matching permission-scoped sponsorships. Uses the same saved view, allowed programs, scoped search, due/current status and sponsorship date rules as the worksheet. Index aggregates fall back to bounded250-row projections for live/unsupported filters; errors are not converted into a successful zero count. Program id all or0 selects combined scope. Unknown operations are ignored and count aliases normalize. Requires permission: one of manage_programs.

POST

admin

sponsorships

{program_id}

footer-calculations

Count sponsorship worksheet footer values

curl --request POST \
  --url https://api.gratona.com/v1/admin/sponsorships/{program_id}/footer-calculations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "footer_calculations": [
    {
      "field_key": "name",
      "operation": "filled"
    }
  ],
  "filter": "false",
  "filterGroups": [
    {
      "field": "display_name",
      "operator": "contains",
      "value": "<unknown>",
      "logicalOperator": "AND"
    }
  ],
  "query": "Jane",
  "keysArray": [
    "display_name"
  ],
  "comparisonOperator": "contains",
  "savedFilterId": 42,
  "saved_filter_id": 42,
  "fields": [
    "display_name"
  ],
  "column_order": [
    "display_name"
  ],
  "date_from": "2026-01-01",
  "date_to": "2026-10-20",
  "header_keys": [
    "donor_title"
  ],
  "status": "current",
  "date_range_timezone": "Africa/Kampala"
}
'

import requests

url = "https://api.gratona.com/v1/admin/sponsorships/{program_id}/footer-calculations"

payload = {
    "footer_calculations": [
        {
            "field_key": "name",
            "operation": "filled"
        }
    ],
    "filter": "false",
    "filterGroups": [
        {
            "field": "display_name",
            "operator": "contains",
            "value": "<unknown>",
            "logicalOperator": "AND"
        }
    ],
    "query": "Jane",
    "keysArray": ["display_name"],
    "comparisonOperator": "contains",
    "savedFilterId": 42,
    "saved_filter_id": 42,
    "fields": ["display_name"],
    "column_order": ["display_name"],
    "date_from": "2026-01-01",
    "date_to": "2026-10-20",
    "header_keys": ["donor_title"],
    "status": "current",
    "date_range_timezone": "Africa/Kampala"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    footer_calculations: [{field_key: 'name', operation: 'filled'}],
    filter: 'false',
    filterGroups: [
      {
        field: 'display_name',
        operator: 'contains',
        value: '<unknown>',
        logicalOperator: 'AND'
      }
    ],
    query: 'Jane',
    keysArray: ['display_name'],
    comparisonOperator: 'contains',
    savedFilterId: 42,
    saved_filter_id: 42,
    fields: ['display_name'],
    column_order: ['display_name'],
    date_from: '2026-01-01',
    date_to: '2026-10-20',
    header_keys: ['donor_title'],
    status: 'current',
    date_range_timezone: 'Africa/Kampala'
  })
};

fetch('https://api.gratona.com/v1/admin/sponsorships/{program_id}/footer-calculations', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.gratona.com/v1/admin/sponsorships/{program_id}/footer-calculations",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'footer_calculations' => [
        [
                'field_key' => 'name',
                'operation' => 'filled'
        ]
    ],
    'filter' => 'false',
    'filterGroups' => [
        [
                'field' => 'display_name',
                'operator' => 'contains',
                'value' => '<unknown>',
                'logicalOperator' => 'AND'
        ]
    ],
    'query' => 'Jane',
    'keysArray' => [
        'display_name'
    ],
    'comparisonOperator' => 'contains',
    'savedFilterId' => 42,
    'saved_filter_id' => 42,
    'fields' => [
        'display_name'
    ],
    'column_order' => [
        'display_name'
    ],
    'date_from' => '2026-01-01',
    'date_to' => '2026-10-20',
    'header_keys' => [
        'donor_title'
    ],
    'status' => 'current',
    'date_range_timezone' => 'Africa/Kampala'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.gratona.com/v1/admin/sponsorships/{program_id}/footer-calculations"

	payload := strings.NewReader("{\n  \"footer_calculations\": [\n    {\n      \"field_key\": \"name\",\n      \"operation\": \"filled\"\n    }\n  ],\n  \"filter\": \"false\",\n  \"filterGroups\": [\n    {\n      \"field\": \"display_name\",\n      \"operator\": \"contains\",\n      \"value\": \"<unknown>\",\n      \"logicalOperator\": \"AND\"\n    }\n  ],\n  \"query\": \"Jane\",\n  \"keysArray\": [\n    \"display_name\"\n  ],\n  \"comparisonOperator\": \"contains\",\n  \"savedFilterId\": 42,\n  \"saved_filter_id\": 42,\n  \"fields\": [\n    \"display_name\"\n  ],\n  \"column_order\": [\n    \"display_name\"\n  ],\n  \"date_from\": \"2026-01-01\",\n  \"date_to\": \"2026-10-20\",\n  \"header_keys\": [\n    \"donor_title\"\n  ],\n  \"status\": \"current\",\n  \"date_range_timezone\": \"Africa/Kampala\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.gratona.com/v1/admin/sponsorships/{program_id}/footer-calculations")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"footer_calculations\": [\n    {\n      \"field_key\": \"name\",\n      \"operation\": \"filled\"\n    }\n  ],\n  \"filter\": \"false\",\n  \"filterGroups\": [\n    {\n      \"field\": \"display_name\",\n      \"operator\": \"contains\",\n      \"value\": \"<unknown>\",\n      \"logicalOperator\": \"AND\"\n    }\n  ],\n  \"query\": \"Jane\",\n  \"keysArray\": [\n    \"display_name\"\n  ],\n  \"comparisonOperator\": \"contains\",\n  \"savedFilterId\": 42,\n  \"saved_filter_id\": 42,\n  \"fields\": [\n    \"display_name\"\n  ],\n  \"column_order\": [\n    \"display_name\"\n  ],\n  \"date_from\": \"2026-01-01\",\n  \"date_to\": \"2026-10-20\",\n  \"header_keys\": [\n    \"donor_title\"\n  ],\n  \"status\": \"current\",\n  \"date_range_timezone\": \"Africa/Kampala\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.gratona.com/v1/admin/sponsorships/{program_id}/footer-calculations")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"footer_calculations\": [\n    {\n      \"field_key\": \"name\",\n      \"operation\": \"filled\"\n    }\n  ],\n  \"filter\": \"false\",\n  \"filterGroups\": [\n    {\n      \"field\": \"display_name\",\n      \"operator\": \"contains\",\n      \"value\": \"<unknown>\",\n      \"logicalOperator\": \"AND\"\n    }\n  ],\n  \"query\": \"Jane\",\n  \"keysArray\": [\n    \"display_name\"\n  ],\n  \"comparisonOperator\": \"contains\",\n  \"savedFilterId\": 42,\n  \"saved_filter_id\": 42,\n  \"fields\": [\n    \"display_name\"\n  ],\n  \"column_order\": [\n    \"display_name\"\n  ],\n  \"date_from\": \"2026-01-01\",\n  \"date_to\": \"2026-10-20\",\n  \"header_keys\": [\n    \"donor_title\"\n  ],\n  \"status\": \"current\",\n  \"date_range_timezone\": \"Africa/Kampala\"\n}"

response = http.request(request)
puts response.read_body

{
  "calculations": {},
  "length": 42
}

{
  "message": "Unauthorized",
  "status": "error"
}

{
  "message": "Not Found",
  "status": "error"
}

{
  "errors": {},
  "status": "error",
  "message": "The given data was invalid."
}

Authorizations

Authorization

string

header

required

Passport bearer token authentication for legacy admin sessions.

Path Parameters

program_id

required

Accessible program id or all programs. Footer/export also accept0 for the combined context.

Example:

42

Body

application/json

Validated request fields for this operation.

Counts the complete permission-scoped sponsorship view. Operations are lowercased. fields/column_order do not persist header preferences in the internal aggregation fallback; rows are processed in bounded batches when needed.

footer_calculations

object[]

required

Minimum array length: 1

Show child attributes

filter

string

Archived-view selector. Use string false for active and true for archived. Recipient views also support available, sponsored and unsponsored.

Example:

"false"

filterGroups

object[]

Multiple typed comparisons. Requires filter when present; value is required except supported presence/empty operators. Saved-view filters are sanitized to current allowed fields.

Show child attributes

query

string

Worksheet search text; recipient search defaults to title/id fields when keysArray is absent.

Example:

"Jane"

keysArray

string[]

Legacy comparison/search field keys.

comparisonOperator

string

Legacy single comparison operator.

Example:

"contains"

savedFilterId

integer

Saved view/report from this organization and worksheet module; missing/unmatched ids are ignored.

Example:

42

saved_filter_id

integer

Compatibility alias for savedFilterId.

Example:

42

fields

string[]

Selected column keys; defaults to saved/current form preferences.

column_order

string[]

Preferred allowed column ordering.

date_from

string<date>

Lower date bound, interpreted with module/saved report date semantics.

Example:

"2026-01-01"

date_to

string<date>

Upper date bound; donor created-at range applies when both bounds are supplied and no advanced date override exists.

Example:

"2026-10-20"

header_keys

string[]

Allowed field keys to scope query word search; provide with query.

status

enum<string>

Optional live payment-due classification filter.

Available options:

current,

due

Example:

"current"

date_range_timezone

string

Date-range timezone; defaults to the authenticated organization/admin timezone.

Example:

"Africa/Kampala"

Response

Operation result.

calculations

required

Map keyed by field_key. Empty array when no valid calculations remain; in that case length is0.

Show child attributes

length

integer

required

Required range: x >= 0

Example:

42

Count sponsorship worksheet footer values

curl --request POST \
  --url https://api.gratona.com/v1/admin/sponsorships/{program_id}/footer-calculations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "footer_calculations": [
    {
      "field_key": "name",
      "operation": "filled"
    }
  ],
  "filter": "false",
  "filterGroups": [
    {
      "field": "display_name",
      "operator": "contains",
      "value": "<unknown>",
      "logicalOperator": "AND"
    }
  ],
  "query": "Jane",
  "keysArray": [
    "display_name"
  ],
  "comparisonOperator": "contains",
  "savedFilterId": 42,
  "saved_filter_id": 42,
  "fields": [
    "display_name"
  ],
  "column_order": [
    "display_name"
  ],
  "date_from": "2026-01-01",
  "date_to": "2026-10-20",
  "header_keys": [
    "donor_title"
  ],
  "status": "current",
  "date_range_timezone": "Africa/Kampala"
}
'

import requests

url = "https://api.gratona.com/v1/admin/sponsorships/{program_id}/footer-calculations"

payload = {
    "footer_calculations": [
        {
            "field_key": "name",
            "operation": "filled"
        }
    ],
    "filter": "false",
    "filterGroups": [
        {
            "field": "display_name",
            "operator": "contains",
            "value": "<unknown>",
            "logicalOperator": "AND"
        }
    ],
    "query": "Jane",
    "keysArray": ["display_name"],
    "comparisonOperator": "contains",
    "savedFilterId": 42,
    "saved_filter_id": 42,
    "fields": ["display_name"],
    "column_order": ["display_name"],
    "date_from": "2026-01-01",
    "date_to": "2026-10-20",
    "header_keys": ["donor_title"],
    "status": "current",
    "date_range_timezone": "Africa/Kampala"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    footer_calculations: [{field_key: 'name', operation: 'filled'}],
    filter: 'false',
    filterGroups: [
      {
        field: 'display_name',
        operator: 'contains',
        value: '<unknown>',
        logicalOperator: 'AND'
      }
    ],
    query: 'Jane',
    keysArray: ['display_name'],
    comparisonOperator: 'contains',
    savedFilterId: 42,
    saved_filter_id: 42,
    fields: ['display_name'],
    column_order: ['display_name'],
    date_from: '2026-01-01',
    date_to: '2026-10-20',
    header_keys: ['donor_title'],
    status: 'current',
    date_range_timezone: 'Africa/Kampala'
  })
};

fetch('https://api.gratona.com/v1/admin/sponsorships/{program_id}/footer-calculations', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.gratona.com/v1/admin/sponsorships/{program_id}/footer-calculations",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'footer_calculations' => [
        [
                'field_key' => 'name',
                'operation' => 'filled'
        ]
    ],
    'filter' => 'false',
    'filterGroups' => [
        [
                'field' => 'display_name',
                'operator' => 'contains',
                'value' => '<unknown>',
                'logicalOperator' => 'AND'
        ]
    ],
    'query' => 'Jane',
    'keysArray' => [
        'display_name'
    ],
    'comparisonOperator' => 'contains',
    'savedFilterId' => 42,
    'saved_filter_id' => 42,
    'fields' => [
        'display_name'
    ],
    'column_order' => [
        'display_name'
    ],
    'date_from' => '2026-01-01',
    'date_to' => '2026-10-20',
    'header_keys' => [
        'donor_title'
    ],
    'status' => 'current',
    'date_range_timezone' => 'Africa/Kampala'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.gratona.com/v1/admin/sponsorships/{program_id}/footer-calculations"

	payload := strings.NewReader("{\n  \"footer_calculations\": [\n    {\n      \"field_key\": \"name\",\n      \"operation\": \"filled\"\n    }\n  ],\n  \"filter\": \"false\",\n  \"filterGroups\": [\n    {\n      \"field\": \"display_name\",\n      \"operator\": \"contains\",\n      \"value\": \"<unknown>\",\n      \"logicalOperator\": \"AND\"\n    }\n  ],\n  \"query\": \"Jane\",\n  \"keysArray\": [\n    \"display_name\"\n  ],\n  \"comparisonOperator\": \"contains\",\n  \"savedFilterId\": 42,\n  \"saved_filter_id\": 42,\n  \"fields\": [\n    \"display_name\"\n  ],\n  \"column_order\": [\n    \"display_name\"\n  ],\n  \"date_from\": \"2026-01-01\",\n  \"date_to\": \"2026-10-20\",\n  \"header_keys\": [\n    \"donor_title\"\n  ],\n  \"status\": \"current\",\n  \"date_range_timezone\": \"Africa/Kampala\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.gratona.com/v1/admin/sponsorships/{program_id}/footer-calculations")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"footer_calculations\": [\n    {\n      \"field_key\": \"name\",\n      \"operation\": \"filled\"\n    }\n  ],\n  \"filter\": \"false\",\n  \"filterGroups\": [\n    {\n      \"field\": \"display_name\",\n      \"operator\": \"contains\",\n      \"value\": \"<unknown>\",\n      \"logicalOperator\": \"AND\"\n    }\n  ],\n  \"query\": \"Jane\",\n  \"keysArray\": [\n    \"display_name\"\n  ],\n  \"comparisonOperator\": \"contains\",\n  \"savedFilterId\": 42,\n  \"saved_filter_id\": 42,\n  \"fields\": [\n    \"display_name\"\n  ],\n  \"column_order\": [\n    \"display_name\"\n  ],\n  \"date_from\": \"2026-01-01\",\n  \"date_to\": \"2026-10-20\",\n  \"header_keys\": [\n    \"donor_title\"\n  ],\n  \"status\": \"current\",\n  \"date_range_timezone\": \"Africa/Kampala\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.gratona.com/v1/admin/sponsorships/{program_id}/footer-calculations")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"footer_calculations\": [\n    {\n      \"field_key\": \"name\",\n      \"operation\": \"filled\"\n    }\n  ],\n  \"filter\": \"false\",\n  \"filterGroups\": [\n    {\n      \"field\": \"display_name\",\n      \"operator\": \"contains\",\n      \"value\": \"<unknown>\",\n      \"logicalOperator\": \"AND\"\n    }\n  ],\n  \"query\": \"Jane\",\n  \"keysArray\": [\n    \"display_name\"\n  ],\n  \"comparisonOperator\": \"contains\",\n  \"savedFilterId\": 42,\n  \"saved_filter_id\": 42,\n  \"fields\": [\n    \"display_name\"\n  ],\n  \"column_order\": [\n    \"display_name\"\n  ],\n  \"date_from\": \"2026-01-01\",\n  \"date_to\": \"2026-10-20\",\n  \"header_keys\": [\n    \"donor_title\"\n  ],\n  \"status\": \"current\",\n  \"date_range_timezone\": \"Africa/Kampala\"\n}"

response = http.request(request)
puts response.read_body

{
  "calculations": {},
  "length": 42
}

{
  "message": "Unauthorized",
  "status": "error"
}

{
  "message": "Not Found",
  "status": "error"
}

{
  "errors": {},
  "status": "error",
  "message": "The given data was invalid."
}