Penny Docs
Accounts

Upload Account Image

PUT
/v1/households/{household_id}/accounts/{account_id}/image

Uploads or replaces a financial account's custom image and returns its display URL. This image overrides the account's default institution or provider image.

Send a JPEG, PNG, or WebP image as the multipart file field, up to 5 MiB (5,242,880 bytes) and 25 million decoded pixels across all frames. Deleted accounts cannot be updated.

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
account_id*Account Id

Request Body

multipart/form-data

file*File
Formatbinary

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X PUT "https://example.com/v1/households/string/accounts/string/image" \  -F file="string"
{  "image_url": "https://cdn.penny.finance/merchants/blue-bottle-coffee.png"}

Delete Account Image DELETE

Removes an account's custom image so its display image falls back to defaultimageurl, which may be null. Returns 204 with no response body on success, or…

List Transactions GET

Lists household transactions newest date first, with related account, merchant, category, and tag details and daily totals in the household's reporting…