> ## Documentation Index > Fetch the complete documentation index at: https://docs.humanos.tech/llms.txt > Use this file to discover all available pages before exploring further. # List Activity Events > Retrieve a paginated list of activity events for your organization. Events are returned in descending chronological order (most recent first). Filter by event `type`, `entityType`, `entityId`, `actorDid`, `subjectDid`, or a `dateFrom`/`dateTo` range. Paginate with `pageIndex` (zero-based, default 0) and `pageSize` (default 10, min 5, max 100); the response `totalPages` reflects the active filters. `dateTo` requires `dateFrom` and must be on or after it; violating either returns 400 Bad Request. Payload shape depends on the event `type` — each `type` carries its own set of fields, and may be null for events with no payload (e.g. REQUEST_CANCELED). ## OpenAPI ````yaml /versions/2026-07-06.yaml get /activity openapi: 3.1.0 info: title: Humanos API description: Humanos API version: '1.0' contact: {} servers: [] security: [] tags: - name: humanosApp description: '' paths: /activity: get: tags: - Activity summary: List Activity Events description: >- Retrieve a paginated list of activity events for your organization. Events are returned in descending chronological order (most recent first). Filter by event `type`, `entityType`, `entityId`, `actorDid`, `subjectDid`, or a `dateFrom`/`dateTo` range. Paginate with `pageIndex` (zero-based, default 0) and `pageSize` (default 10, min 5, max 100); the response `totalPages` reflects the active filters. `dateTo` requires `dateFrom` and must be on or after it; violating either returns 400 Bad Request. Payload shape depends on the event `type` — each `type` carries its own set of fields, and may be null for events with no payload (e.g. REQUEST_CANCELED). operationId: activity_list parameters: - name: pageIndex required: false in: query description: Zero-based page index. `0` returns the first page. schema: default: 0 example: 0 type: number - name: pageSize required: false in: query description: Number of items per page schema: minimum: 5 maximum: 100 default: 10 example: 10 type: number - name: dateFrom required: false in: query description: Filter from date (will be converted to start of day in UTC) schema: format: date-time example: '2025-01-01' type: string - name: dateTo required: false in: query description: >- Filter to date (will be converted to end of day in UTC). Requires dateFrom. schema: format: date-time example: '2025-12-31' type: string - name: type required: false in: query description: >- 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. schema: example: - VP_VERIFIED - VP_VERIFICATION_DENIED type: array items: type: string enum: - 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 - APIKEY_VERSION_CHANGED - APIKEY_CREATED - APIKEY_SECRETS_ROTATED - APIKEY_REVOKED - name: entityType required: false in: query description: >- Filter by the broad entity class the event was emitted against (e.g. "credential", "request", "veriff", "apiKey"). schema: example: credential type: string - name: entityId required: false in: query description: Filter by a specific entity id (must be a valid MongoDB ObjectId). schema: example: 507f1f77bcf86cd799439011 type: string - name: actorDid required: false in: query description: Filter by the DID of the actor that triggered the event. schema: example: did:web:humanos.tech:org:550e8400-e29b-41d4-a716-446655440000 type: string - name: subjectDid required: false in: query description: Filter by the DID of the subject affected by the event. schema: example: did:web:humanos.tech:user:73ebefdd-a549-4873-aad9-def80c40c8c8 type: string - $ref: '#/components/parameters/ApiVersion' responses: '200': description: >- Returns a page of activity events plus the total number of pages available for the current filters. content: application/json: schema: $ref: '#/components/schemas/ActivitiesEntity' components: parameters: ApiVersion: name: API-Version in: header required: false schema: type: string pattern: ^\d{4}-\d{2}-\d{2}$ example: '2026-07-06' description: >- Pin request, response, and webhook shapes to a specific dated API version (YYYY-MM-DD). Omit to use the version pinned to your API key (set when the key is created; new keys default to the latest version). New integrations should target the latest version. schemas: ActivitiesEntity: type: object properties: data: description: >- Page of activity events matching the query, ordered by createdAt descending. type: array items: $ref: '#/components/schemas/ActivityEntity' totalPages: type: number description: >- Total number of pages available based on the page size and total count. example: 5 required: - data - totalPages ActivityEntity: type: object properties: id: type: string description: Unique identifier for the activity event (MongoDB ObjectId). example: 507f1f77bcf86cd799439011 type: type: string description: The kind of event that was recorded. enum: - 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 - APIKEY_VERSION_CHANGED - APIKEY_CREATED - APIKEY_SECRETS_ROTATED - APIKEY_REVOKED example: MANDATE_ISSUED entityType: type: string description: >- Broad class of the entity the event was emitted against. Typical values are "credential", "request", "veriff", and "apiKey". example: credential entityId: type: string description: Identifier of the specific entity the event was emitted against. example: 507f1f77bcf86cd799439011 actorDid: type: string description: >- DID of the actor that triggered the event (issuer, subject, or verifier). example: did:web:humanos.tech:org:550e8400-e29b-41d4-a716-446655440000 nullable: true subjectDid: type: string description: DID of the subject the event is about (when applicable). example: did:web:humanos.tech:user:73ebefdd-a549-4873-aad9-def80c40c8c8 nullable: true payload: type: object description: >- Event-specific payload. Shape depends on the event `type` — each `type` carries its own set of fields. May be null for events with no payload (e.g. REQUEST_CANCELED). additionalProperties: true example: credentialUrn: urn:via:credential:550e8400-e29b-41d4-a716-446655440000 credentialName: Proof of Employment nullable: true createdAt: type: string description: ISO-8601 timestamp at which the event was recorded. example: '2026-05-12T10:30:00.000Z' required: - id - type - entityType - entityId - createdAt ````