Admin

Read organization or record activity

Requires activity_logs_view, interactions_manage or donors_manage. Results enforce current program, participation-site/cohort, owner-only, restricted SMS-line and manual-interaction privacy access. Page mentions appear only on accessible donor/recipient timelines and may record exposure for normal user requests. Email Intelligence V2 removes legacy provider rows from the broad timeline. Email body text and preview pointers follow the current body policy, including mailbox, program and private-owner restrictions where applicable. Returns activity rows and pagination; per_page accepts 10, 15 or 20, otherwise defaults to 10. General/donor feeds without a search phrase use current database rows. Nonblank query/search/q searches metadata and authorized email bodies through the index, then rechecks current rows and disclosure before returning results. More than 20,000 indexed candidates returns 422 with empty activities and null pagination; narrow the phrase or date range. Recipient activity reads the database and ignores text search. Other search failures return an empty 200 response with message. additional_data remains a JSON-encoded string. fresh=true reads the newest ten committed donor entries directly with a fixed 90-day window; it ignores text search and requires the other documented filters to be absent.

GET

admin

activityLogs

curl --request GET \
  --url https://api.gratona.com/v1/admin/activityLogs \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.gratona.com/v1/admin/activityLogs', 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/activityLogs",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

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

curl_close($curl);

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

package main

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

func main() {

	url := "https://api.gratona.com/v1/admin/activityLogs"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

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

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

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.gratona.com/v1/admin/activityLogs")

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

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

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

{
  "activities": [
    {
      "id": 123,
      "client_id": 123,
      "program_id": 123,
      "admin_id": 123,
      "donor_id": 123,
      "table_name": "<string>",
      "record_id": 123,
      "action": "<string>",
      "deleted_at": "2023-11-07T05:31:56Z",
      "additional_data": "<string>",
      "created_at": "<string>",
      "updated_at": "<string>",
      "descriptions": "<string>",
      "type": "<string>"
    }
  ],
  "pagination": {
    "current_page": 123,
    "last_page": 123,
    "per_page": 123,
    "total": 123,
    "from": 123,
    "to": 123
  },
  "email_intelligence_v2_enabled": true,
  "message": "<string>"
}

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

{
  "message": "Something went wrong. Please try again.",
  "status": "error",
  "error": "invalid_request",
  "code": "DONOR_NOT_FOUND"
}

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

Authorizations

Authorization

string

header

required

Passport bearer token authentication for legacy admin sessions.

Query Parameters

query

string

Search activity metadata and currently authorized email body text. Preferred query key; search and q are compatibility aliases. Ignored by recipient timelines and fresh donor previews. Narrow the phrase or date range when the candidate budget is exceeded.

string

Compatibility search text used when query is absent. Ignored by recipient timelines and fresh donor previews.

string

Compatibility search text used when both query and search are absent. Ignored by recipient timelines and fresh donor previews.

donor_id

integer

Restrict to this donor within the organization.

entity_id

integer

Read recipient activity directly; unknown recipient produces an empty page.

range

integer

default:90

Look back this many days; values at or below zero remove the date boundary.

actions[]

string[]

Activity action allowlist for the row search. Facet handling varies by the recipient and search paths.

table_names[]

string[]

Affected table allowlist for the row search.

exclude_types[]

string[]

Exclude merged activity row types.

unmatched_only

boolean

Legacy mode selects unreviewed/unmatched external email; ignored as a match filter when Email Intelligence V2 is enabled.

page

integer

default:1

Page.

per_page

enum<integer>

default:10

Per page.

Available options:

10,

15,

20

fresh

boolean

default:false

Read the committed newest 10 donor entries before search indexing. Requires a signed-in user and donor_id; entity_id, page, per_page, range, actions, table_names, exclude_types and unmatched_only must be absent.

Response

Read organization or record activity response.

activities

object[]

Show child attributes

pagination

object

Show child attributes

email_intelligence_v2_enabled

boolean

message

string

Read organization or record activity

curl --request GET \
  --url https://api.gratona.com/v1/admin/activityLogs \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.gratona.com/v1/admin/activityLogs', 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/activityLogs",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

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

curl_close($curl);

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

package main

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

func main() {

	url := "https://api.gratona.com/v1/admin/activityLogs"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

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

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

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.gratona.com/v1/admin/activityLogs")

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

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

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

{
  "activities": [
    {
      "id": 123,
      "client_id": 123,
      "program_id": 123,
      "admin_id": 123,
      "donor_id": 123,
      "table_name": "<string>",
      "record_id": 123,
      "action": "<string>",
      "deleted_at": "2023-11-07T05:31:56Z",
      "additional_data": "<string>",
      "created_at": "<string>",
      "updated_at": "<string>",
      "descriptions": "<string>",
      "type": "<string>"
    }
  ],
  "pagination": {
    "current_page": 123,
    "last_page": 123,
    "per_page": 123,
    "total": 123,
    "from": 123,
    "to": 123
  },
  "email_intelligence_v2_enabled": true,
  "message": "<string>"
}

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

{
  "message": "Something went wrong. Please try again.",
  "status": "error",
  "error": "invalid_request",
  "code": "DONOR_NOT_FOUND"
}

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