Personal expenses

10 endpoints at a glance

Method	Path	Summary
GET	/personal-expenses	List Personal Expenses
POST	/personal-expenses	Create Personal Expense
DELETE	/personal-expenses/{expense_id}	Delete Personal Expense
GET	/personal-expenses/{expense_id}	Get Personal Expense
PATCH	/personal-expenses/{expense_id}	Update Personal Expense
POST	/personal-expenses/{expense_id}/paid	Set Personal Paid
POST	/personal-expenses/capture	Capture Personal
POST	/personal-expenses/capture-from-email	Capture Personal From Email
GET	/personal-expenses/categories	List Categories
GET	/personal-expenses/summary	Personal Summary

personal

---

List Personal Expenses

GET

/personal-expenses

Parameters

Header Parameters

authorization

Query Parameters

paid

category

q

linked

page

Type

integer

Default

1

limit

Type

integer

Default

50

Responses

Successful Response

Content-Type

application/json

{

  

"additionalProperties": "string"

}

GET

/personal-expenses

Playground

Headers

authorization

Variables

Key

Value

paid

category

q

linked

page

limit

Samples

---

Create Personal Expense

POST

/personal-expenses

Parameters

Header Parameters

authorization

Request Body

application/json

{

  

"date": "string",

  

"merchant": "",

  

"amount_cents": 0,

  

"category": "string",

  

"description": "string",

  

"currency": "EUR",

  

"notes": "string",

  

"paid": false,

  

"party_ref": {

  

  

"type": "string",

  

  

"id": "string",

  

  

"ref": {

  

  

  

"additionalProperties": "string"

  

  

},

  

  

"label": "string"

  

}

}

Responses

Successful Response

Content-Type

application/json

{

  

"additionalProperties": "string"

}

POST

/personal-expenses

Playground

Headers

authorization

Body

Samples

---

List Categories

GET

/personal-expenses/categories

Parameters

Header Parameters

authorization

Responses

Successful Response

Content-Type

application/json

{

  

"additionalProperties": "string"

}

GET

/personal-expenses/categories

Playground

Headers

authorization

Samples

---

Personal Summary

GET

/personal-expenses/summary

Parameters

Header Parameters

authorization

Query Parameters

year

Responses

Successful Response

Content-Type

application/json

{

  

"additionalProperties": "string"

}

GET

/personal-expenses/summary

Playground

Headers

authorization

Variables

Key

Value

year

Samples

---

Capture Personal

POST

/personal-expenses/capture

Upload a receipt (image or PDF) → prefilled personal record with the
receipt attached. Digital PDFs read their text layer (no OCR); images/scans
use tesseract (501 when it's not installed).

Parameters

Header Parameters

authorization

Request Body

multipart/form-data

Responses

Successful Response

Content-Type

application/json

{

  

"additionalProperties": "string"

}

POST

/personal-expenses/capture

Playground

Headers

authorization

Body

Samples

---

Capture Personal From Email

POST

/personal-expenses/capture-from-email

Capture a receipt straight from an email attachment (PDF/image) into a
prefilled personal record, and tag the source email personal.

Parameters

Header Parameters

authorization

Request Body

application/json

{

  

"email_id": "string",

  

"part_id": "string"

}

Responses

Successful Response

Content-Type

application/json

{

  

"additionalProperties": "string"

}

POST

/personal-expenses/capture-from-email

Playground

Headers

authorization

Body

Samples

---

Get Personal Expense

GET

/personal-expenses/{expense_id}

Parameters

Header Parameters

authorization

Path Parameters

expense_id*

Type

string

Required

Responses

Successful Response

Content-Type

application/json

{

  

"additionalProperties": "string"

}

GET

/personal-expenses/{expense_id}

Playground

Headers

authorization

Variables

Key

Value

expense_id*

Samples

---

Delete Personal Expense

DELETE

/personal-expenses/{expense_id}

Parameters

Header Parameters

authorization

Path Parameters

expense_id*

Type

string

Required

Responses

Successful Response

Content-Type

application/json

{

  

"additionalProperties": "string"

}

DELETE

/personal-expenses/{expense_id}

Playground

Headers

authorization

Variables

Key

Value

expense_id*

Samples

---

Update Personal Expense

PATCH

/personal-expenses/{expense_id}

Parameters

Header Parameters

authorization

Path Parameters

expense_id*

Type

string

Required

Request Body

application/json

{

  

"date": "string",

  

"merchant": "string",

  

"amount_cents": 0,

  

"category": "string",

  

"description": "string",

  

"currency": "string",

  

"notes": "string",

  

"paid": true,

  

"party_ref": {

  

  

"type": "string",

  

  

"id": "string",

  

  

"ref": {

  

  

  

"additionalProperties": "string"

  

  

},

  

  

"label": "string"

  

}

}

Responses

Successful Response

Content-Type

application/json

{

  

"additionalProperties": "string"

}

PATCH

/personal-expenses/{expense_id}

Playground

Headers

authorization

Variables

Key

Value

expense_id*

Body

Samples

---

Set Personal Paid

POST

/personal-expenses/{expense_id}/paid

Parameters

Header Parameters

authorization

Path Parameters

expense_id*

Type

string

Required

Request Body

application/json

{

  

"paid": true

}

Responses

Successful Response

Content-Type

application/json

{

  

"additionalProperties": "string"

}

POST

/personal-expenses/{expense_id}/paid

Playground

Headers

authorization

Variables

Key

Value

expense_id*

Body

Samples

---