---
title: "Read the activity feed for one record"
method: GET
path: "/activities"
tags: ["Activities"]
---

# Read the activity feed for one record

`GET /activities`

Returns what happened to a single record, newest first. A feed carries only that record's own activities.

`pagination` reports the totals for the whole filtered result rather than for the page.

## Query parameters

- `entityType` 'INVOICE' | 'PAYMENT_REQUEST' | 'CUSTOMER' | 'SCHEDULE' — The kind of record an activity belongs to.
- `entityId` string — The record to read the feed for, as a UUID. Required, together with entityType.
- `type` string[] — Only return activities of these kinds. Repeat the parameter to name more than one, combined with OR. Omit it to return every kind.
- `minCreationTime` string, date-time — Only return activities that happened at or after this instant. Inclusive.
- `maxCreationTime` string, date-time — Only return activities that happened at or before this instant. Inclusive.
- `page` integer — Which page to return, counting from one.
- `size` integer — How many activities to return per page. A request for more than the maximum is refused.
- `sort` 'creationTime,desc' | 'creationTime,asc' — How to order the page.

## Response `200`

The requested page of activities.

- ActivityFeedResponse — A page of things that happened.
  - `activities` ActivityResponse[], required — The activities on this page, newest first unless another order was asked for.
    - `id` string, uuid, required — The activity itself, for fetching it on its own.
    - `creationTime` string, date-time, required — When it happened.
    - `entityType` 'INVOICE' | 'PAYMENT_REQUEST' | 'CUSTOMER' | 'SCHEDULE', required — The kind of record it happened to.
    - `entityId` string, uuid, required — The record it happened to.
    - `type` 'INVOICE_CREATED' | 'INVOICE_EDITED' | 'INVOICE_OUTSTANDING' | 'INVOICE_OVERDUE' | 'INVOICE_SCHEDULED' | 'INVOICE_SUBMITTED' | 'INVOICE_PAID' | 'INVOICE_SETTLED' | 'INVOICE_VOIDED' | 'INVOICE_DELETED' | 'INVOICE_MANUALLY_MARKED_AS_PAID' | 'INVOICE_MANUALLY_UNMARKED_AS_PAID' | 'INVOICE_PAYMENT_LINK_SEEN' | 'INVOICE_CREDIT_NOTE_ADDED' | 'INVOICE_CREDIT_NOTE_CANCELLED' | 'INVOICE_FEES_APPLIED' | 'INVOICE_FEES_WAIVED' | 'INVOICE_PUSHED_TO_CONNECTOR' | 'INVOICE_CONNECTOR_PUSH_FAILED' | 'PAYMENT_REQUEST_OUTSTANDING' | 'PAYMENT_REQUEST_OVERDUE' | 'PAYMENT_REQUEST_SCHEDULED' | 'PAYMENT_REQUEST_SUBMITTED' | 'PAYMENT_REQUEST_PAID' | 'PAYMENT_REQUEST_SETTLED' | 'PAYMENT_REQUEST_VOIDED' | 'PAYMENT_REQUEST_DELETED' | 'PAYMENT_MADE' | 'PAYMENT_SUBMITTED' | 'PAYMENT_SETTLED' | 'PAYMENT_CANCELLED' | 'PAYMENT_FAILED' | 'PAYMENT_PUSHED_TO_CONNECTOR' | 'PAYMENT_CONNECTOR_PUSH_FAILED' | 'CUSTOMER_CREATED' | 'CUSTOMER_EDITED' | 'CUSTOMER_CHANGED' | 'CUSTOMER_MERGED' | 'CUSTOMER_ARCHIVED' | 'CUSTOMER_REACTIVATED' | 'CUSTOMER_AUTO_LINKED' | 'CUSTOMER_CASE_CREATED' | 'COLLECTION_AGENT_LINKED' | 'CUSTOMER_INVOICE_MIGRATION_COMPLETED' | 'CUSTOMER_PUSHED_TO_CONNECTOR' | 'CUSTOMER_CONNECTOR_PUSH_FAILED' | 'MANDATE_CREATED' | 'MANDATE_ACTIVATED' | 'MANDATE_PENDING_CANCELLATION' | 'MANDATE_CANCELLED' | 'MANDATE_MIGRATING' | 'MANDATE_DELETED' | 'MANDATE_REINSTATED' | 'CARD_DETAILS_REQUESTED' | 'CARD_ACTIVATED' | 'CARD_CANCELLED' | 'CARD_EXPIRED' | 'SCHEDULE_CREATED' | 'SCHEDULE_EDITED' | 'SCHEDULE_ACTIVATED' | 'SCHEDULE_FINISHED' | 'SCHEDULE_CANCELLED' | 'SCHEDULE_DELETED' | 'SCHEDULE_ITEM_CREATED' | 'COLLECTION_METHOD_CHANGED' | 'COLLECTION_PAUSED' | 'COLLECTION_RESUMED' | 'COLLECTION_CANCELLED' | 'COLLECTION_CANCELLATION_REQUESTED' | 'COLLECTION_COMPLETED' | 'COLLECTION_CONFIGURATION_CREATED' | 'COLLECTION_CONFIGURATION_UPDATED' | 'COLLECTION_CONFIGURATION_DELETED' | 'COLLECTION_CONFIGURATION_RESET' | 'DIRECT_DEBIT_COLLECTION_ATTEMPTED' | 'AUTO_COLLECT_SET_TO_DIRECT_DEBIT' | 'AUTO_COLLECT_SET_TO_CARD' | 'AUTO_COLLECT_SET_TO_DIRECT_DEBIT_WITH_CARD_BACKUP' | 'CREDIT_CONTROL_STATUS_CHANGED' | 'NOTIFICATION_PENDING' | 'NOTIFICATION_DEFERRED' | 'NOTIFICATION_SENT' | 'NOTIFICATION_FAILED' | 'NOTIFICATION_RETRIED' | 'NOTIFICATION_OPENED' | 'ACTIVITY_NOTE_ADDED', required — What happened.
    - `display` ActivityDisplay, required — The activity as a finished sentence, ready to render.
      - `title` string, required — What happened, in a few words.
      - `summary` string — The detail beneath the title. Absent where the title says everything.
    - `actor` ActivityActor, required — Who or what performed the activity.
      - `type` 'USER' | 'SYSTEM' | 'CONNECTOR', required — The kind of actor.
      - `userId` string, uuid — The person who acted. Absent where nobody is responsible.
    - `actions` ActivityAction[], required — What can be done about it. Empty where there is nothing to offer.
      - `action` 'PREVIEW_NOTIFICATION', required — What the action does.
      - `method` string, required — The HTTP method to call it with.
      - `href` string, required — The path to call it on.
  - `pagination` Pagination, required — Contains pagination information for a set of results
    - `page` integer — The current page number One-based page index (1..N).
    - `size` integer — The size of the page, i.e., the number of elements per page.
    - `totalPages` integer — The total number of pages available.
    - `totalElements` integer — The total number of elements across all pages.
    - `numberOfElements` integer — The number of elements in the current page.
    - `sort` string — Sorting criteria in the format: property,(asc|desc).

## Other responses

- `400` — The request could not be understood. `errors[].type` names which of the following it was: `SCOPE_REQUIRED` when entityType or entityId is missing, `INVALID_UUID` when entityId is not a UUID, `UNSUPPORTED_SORT` when sort names anything but creationTime. An unknown activity type, a malformed timestamp, or a page or size outside its documented range is also refused here.
- `401` — The request carried no valid access token.
- `403` — The access token does not grant reading activities.
- `500` — The server could not process the request.

---

[API](https://skmtc.dev/adfin/apis/adfin-api.md) · [All operations](https://skmtc.dev/adfin/apis/adfin-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/adfin/adfin-api/revisions/53d29f0850e0/schema)