# Read the activity feed for one record

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.

Endpoint: GET /activities
Version: 1.0.0
Security: Biller Access Token (Staging), Biller Access Token (Production)

## Query parameters:

  - `entityType` (string)
    The kind of record to read the feed for. Required, together with entityId.
    Enum: "INVOICE", "PAYMENT_REQUEST", "CUSTOMER", "SCHEDULE"

  - `entityId` (string)
    The record to read the feed for, as a UUID. Required, together with entityType.
    Example: "3fa85f64-5717-4562-b3fc-2c963f66afa6"

  - `type` (array)
    Only return activities of these kinds. Repeat the parameter to name more than one, combined with OR. Omit it to return every kind.
    Enum: "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"

  - `minCreationTime` (string)
    Only return activities that happened at or after this instant. Inclusive.
    Example: "2026-08-01T00:00:00Z"

  - `maxCreationTime` (string)
    Only return activities that happened at or before this instant. Inclusive.
    Example: "2026-08-31T23:59:59Z"

  - `page` (integer)
    Which page to return, counting from one.
    Example: 1

  - `size` (integer)
    How many activities to return per page. A request for more than the maximum is refused.
    Example: 50

  - `sort` (string)
    How to order the page.
    Enum: "creationTime,desc", "creationTime,asc"

## Response 200 fields (application/json):

  - `activities` (array, required)
    The activities on this page, newest first unless another order was asked for.

  - `activities.id` (string, required)
    The activity itself, for fetching it on its own.

  - `activities.creationTime` (string, required)
    When it happened.

  - `activities.entityType` (string, required)
    The kind of record it happened to.
    Enum: "INVOICE", "PAYMENT_REQUEST", "CUSTOMER", "SCHEDULE"

  - `activities.entityId` (string, required)
    The record it happened to.

  - `activities.type` (string, required)
    What happened.
    Enum: "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"

  - `activities.display` (object, required)
    The activity written out, ready to show.

  - `activities.display.title` (string, required)
    What happened, in a few words.

  - `activities.display.summary` (string)
    The detail beneath the title. Absent where the title says everything.

  - `activities.actor` (object, required)
    Who or what performed it.

  - `activities.actor.type` (string, required)
    The kind of actor.
    Enum: "USER", "SYSTEM", "CONNECTOR"

  - `activities.actor.userId` (string)
    The person who acted. Absent where nobody is responsible.

  - `activities.actions` (array, required)
    What can be done about it. Empty where there is nothing to offer.

  - `activities.actions.action` (string, required)
    What the action does.
    Enum: "PREVIEW_NOTIFICATION"

  - `activities.actions.method` (string, required)
    The HTTP method to call it with.

  - `activities.actions.href` (string, required)
    The path to call it on.

  - `pagination` (object, required)
    Where this page sits in the whole result.

  - `pagination.page` (integer)
    The current page number One-based page index (1..N).

  - `pagination.size` (integer)
    The size of the page, i.e., the number of elements per page.

  - `pagination.totalPages` (integer)
    The total number of pages available.

  - `pagination.totalElements` (integer)
    The total number of elements across all pages.

  - `pagination.numberOfElements` (integer)
    The number of elements in the current page.

  - `pagination.sort` (string)
    Sorting criteria in the format: property,(asc|desc).

## Response 400 fields (application/json):

  - `type` (string)

  - `title` (string)

  - `status` (integer)

  - `detail` (string)

  - `instance` (string)

  - `properties` (object)

  - `errors` (array)

  - `errors.message` (string)


## Response 401 fields

## Response 403 fields

## Response 500 fields