Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/Gianluca-X/DigitalMoney/llms.txt

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

Fetch the complete details of a single activity entry. The service queries by both accountId and activityId in combination, so an activity that exists under a different account will not be returned — the response will be 404 Not Found. This endpoint is typically used to populate a transaction detail screen or to gather data before generating a receipt.

Endpoint

GET /accounts/{accountId}/activity/{activityId}
Base URL: http://localhost:8085

Authentication

Include a valid Bearer JWT in the Authorization header. The controller reads the token from the header and the service layer validates access. Missing or invalid tokens result in 403 Forbidden.

Path Parameters

accountId
long
required
The numeric identifier of the account that owns the activity record.
activityId
long
required
The numeric identifier of the specific activity entry to retrieve.

Response

Returns 200 OK with a single ActivityOutDTO object.

Response Fields

id
long
Unique identifier for this activity record.
accountId
long
The account this activity belongs to.
type
string
Activity type: "deposit", "transfer-out", or "transfer-in".
amount
BigDecimal
Monetary value of the activity. Negative for outgoing transfers.
date
string
ISO-8601 timestamp when the activity was created (e.g. "2024-03-15T14:22:05").
cvu
string
CVU of the counterpart account for transfers, or null for deposit entries.

Example Request

curl -X GET "http://localhost:8085/accounts/42/activity/301" \
  -H "Authorization: Bearer eyJhbGciOiJSUzI1NiJ9..."

Example Response

{
  "id": 301,
  "accountId": 42,
  "type": "transfer-in",
  "amount": 2500.00,
  "date": "2024-03-15T14:22:05",
  "cvu": "0000003100012345678901"
}

Error Responses

StatusExceptionCondition
400 Bad RequestIllegalArgumentExceptionPath variables are not valid long integers or the request is otherwise malformed.
403 ForbiddenInvalidTokenExceptionThe token is invalid or the authenticated user does not have permission to view this activity.
404 Not FoundResourceNotFoundExceptionNo activity with activityId exists under accountId.
The lookup is scoped to the accountId in the path. Even if activityId exists in the database, a 404 is returned if it belongs to a different account. This prevents cross-account activity enumeration.
To download a PDF receipt for this activity, call GET /accounts/{accountId}/activity/{activityId}/receipt using the same path parameters — see Download Activity Receipt.

Build docs developers (and LLMs) love