Activity Management
Retrieve an Activity
Retrieves a paginated, filterable list of activities (verification/check events) recorded against entities.
GET
/
v2
/
api
/
activities
Retrieve an Activity
curl --request GET \
--url https://api.youverify.co/v2/api/activities \
--header 'token: <api-key>'import requests
url = "https://api.youverify.co/v2/api/activities"
headers = {"token": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {token: '<api-key>'}};
fetch('https://api.youverify.co/v2/api/activities', 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.youverify.co/v2/api/activities",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"token: <api-key>"
],
]);
$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.youverify.co/v2/api/activities"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("token", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.youverify.co/v2/api/activities")
.header("token", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.youverify.co/v2/api/activities")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["token"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"success": true,
"statusCode": 200,
"message": "Activities successfully retrieved!",
"data": {
"docs": [
{
"entityId": "68b0114137593677539a1638",
"activity": "Identity Check",
"type": "bvn",
"reportId": "68c169c76271c8b9f0bc25c3",
"status": "found",
"createdAt": "2025-09-10T12:06:37.180Z",
"lastModifiedAt": "2025-09-10T12:06:37.180Z",
"_createdAt": "2025-09-10T12:06:3737+00:00",
"_lastModifiedAt": "2025-09-10T12:06:3737+00:00",
"id": "act_68c169cd9a12af3e53c5dc65",
"_id": "act_68c169cd9a12af3e53c5dc65"
}
],
"pagination": {
"type": "cursor",
"perPage": 20,
"nextPage": "2025-08-15T15:31:51.922Z",
"prevPage": null,
"hasNextPage": true,
"hasPrevPage": false
},
"filters": {}
},
"links": []
}{
"success": false,
"statusCode": 401,
"message": "Permission denied",
"name": "UnauthorizedError",
"data": {}
}{
"success": false,
"statusCode": 429,
"message": "Too many requests",
"name": "RateLimitError",
"data": {}
}{
"success": false,
"statusCode": 500,
"message": "Internal Server Error",
"name": "Error",
"data": {}
}Authorizations
Your Youverify API secret key. Never expose client-side.
Headers
API secret token
Query Parameters
Entity ID to filter activities
Number of records to return (Default: 10)
Field to sort results by (Default: createdAt)
Sort order (Default: desc)
Available options:
asc, desc Cursor for fetching the next page
Cursor for fetching the previous page
Filter by activity type
Filter by activity status
Filter activities created after this date
Filter activities created before this date
Response
Success
⌘I
Retrieve an Activity
curl --request GET \
--url https://api.youverify.co/v2/api/activities \
--header 'token: <api-key>'import requests
url = "https://api.youverify.co/v2/api/activities"
headers = {"token": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {token: '<api-key>'}};
fetch('https://api.youverify.co/v2/api/activities', 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.youverify.co/v2/api/activities",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"token: <api-key>"
],
]);
$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.youverify.co/v2/api/activities"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("token", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.youverify.co/v2/api/activities")
.header("token", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.youverify.co/v2/api/activities")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["token"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"success": true,
"statusCode": 200,
"message": "Activities successfully retrieved!",
"data": {
"docs": [
{
"entityId": "68b0114137593677539a1638",
"activity": "Identity Check",
"type": "bvn",
"reportId": "68c169c76271c8b9f0bc25c3",
"status": "found",
"createdAt": "2025-09-10T12:06:37.180Z",
"lastModifiedAt": "2025-09-10T12:06:37.180Z",
"_createdAt": "2025-09-10T12:06:3737+00:00",
"_lastModifiedAt": "2025-09-10T12:06:3737+00:00",
"id": "act_68c169cd9a12af3e53c5dc65",
"_id": "act_68c169cd9a12af3e53c5dc65"
}
],
"pagination": {
"type": "cursor",
"perPage": 20,
"nextPage": "2025-08-15T15:31:51.922Z",
"prevPage": null,
"hasNextPage": true,
"hasPrevPage": false
},
"filters": {}
},
"links": []
}{
"success": false,
"statusCode": 401,
"message": "Permission denied",
"name": "UnauthorizedError",
"data": {}
}{
"success": false,
"statusCode": 429,
"message": "Too many requests",
"name": "RateLimitError",
"data": {}
}{
"success": false,
"statusCode": 500,
"message": "Internal Server Error",
"name": "Error",
"data": {}
}