---
title: "Read one activity"
method: GET
path: "/activities/{activityId}"
tags: ["Activities"]
---

# Read one activity

`GET /activities/{activityId}`

Returns a single activity by its own id.

## Path parameters

- `activityId` string, uuid, required

## Response `200`

The requested activity.

- ActivityResponse — One thing that happened.
  - `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.

## Other responses

- `400` — activityId is not a UUID.
- `401` — The request carried no valid access token.
- `403` — The access token does not grant reading activities.
- `404` — There is no activity with that id. `errors[].type` is `ACTIVITY_NOT_FOUND`. An activity that belongs to another biller, and one this API cannot represent, both answer this way.
- `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)