Penny Docs
Transaction images

Upload Transaction Images

POST
/v1/households/{household_id}/transactions/{transaction_id}/images

Attaches images to a transaction and returns only the newly created image records. Existing attachments are retained.

Send files as repeated files fields in a multipart/form-data request. Each file must be JPEG, PNG, or WebP, at most 5 MiB (5,242,880 bytes) and 25 million decoded pixels across all frames. Every file is validated before any are saved; a validation error rejects the entire batch. Requires a household member or owner role.

Authorization

PersonalApiToken
AuthorizationBearer <token>

Use your personal API token (penny_pat_…) as the bearer credential. Enter the token only; the client adds the Bearer prefix. Read-only tokens permit read requests. Read/write tokens remain limited by your current household membership and role. See https://penny.finance/docs/api#authentication for setup.

In: header

Path Parameters

household_id*Household Id
transaction_id*Transaction Id

Request Body

multipart/form-data

files*array<>

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/v1/households/string/transactions/string/images" \  -F files="[    \"string\"  ]"
{  "images": [    {      "id": "Im4nD8qR2sVk",      "image_url": "https://cdn.penny.finance/transactions/Tx3fJ9mS6vBa/receipt.png",      "created_at": "2019-08-24T14:15:22Z"    }  ]}

List Transaction Images GET

Lists receipt images and other images attached to a transaction, with their IDs and download URLs. An existing transaction without images returns an empty…

Bulk Delete Transaction Images POST

Permanently removes matching image attachments from a transaction. The transaction itself is retained. IDs not attached to this transaction are skipped.…