Skip to main content
GET
/
activity
List Activity Events
curl --request GET \
  --url https://api.example.com/activity
{
  "data": [
    {
      "id": "507f1f77bcf86cd799439011",
      "type": "MANDATE_ISSUED",
      "entityType": "credential",
      "entityId": "507f1f77bcf86cd799439011",
      "createdAt": "2026-05-12T10:30:00.000Z",
      "actorDid": "<string>",
      "subjectDid": "<string>",
      "payload": {}
    }
  ],
  "totalPages": 5
}

Documentation Index

Fetch the complete documentation index at: https://humanos.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

Headers

​
API-Version
string

Pin responses to a specific API version (YYYY-MM-DD). When omitted, defaults to the version stored in your issuer config or today's date.

Pattern: ^\d{4}-\d{2}-\d{2}$
Example:

"2026-03-03"

Query Parameters

​
pageIndex
number
default:0

Page number

Example:

0

​
pageSize
number
default:10

Number of items per page

Required range: 5 <= x <= 100
Example:

10

​
type
enum<string>[]

Filter by one or more activity event types. Repeat the query parameter to pass multiple values, e.g. ?type=VP_VERIFIED&type=VP_VERIFICATION_DENIED.

Available options:
REQUEST_CREATED,
REQUEST_CANCELED,
VP_CREATED,
VP_DENIED,
VP_VERIFIED,
VP_VERIFICATION_DENIED,
USER_DECISION_ACCEPTED,
USER_DECISION_REJECTED,
MANDATE_ISSUED,
MANDATE_REVOKED,
KYC_ACCEPTED,
KYC_REJECTED
Example:
["VP_VERIFIED", "VP_VERIFICATION_DENIED"]
​
entityType
string

Filter by the broad entity class the event was emitted against (e.g. "credential", "request", "veriff").

Example:

"credential"

​
entityId
string

Filter by a specific entity id (must be a valid MongoDB ObjectId).

Example:

"507f1f77bcf86cd799439011"

​
actorDid
string

Filter by the DID of the actor that triggered the event.

​
subjectDid
string

Filter by the DID of the subject affected by the event.

​
dateFrom
string<date-time>

Filter from date (will be converted to start of day).

Example:

"2026-01-01"

​
dateTo
string<date-time>

Filter to date (will be converted to end of day). Requires dateFrom.

Example:

"2026-12-31"

Response

200 - application/json
​
data
object[]
required

Page of activity events matching the query, ordered by createdAt descending.

​
totalPages
number
required

Total number of pages available based on the page size and total count.

Example:

5