Income and expense tracker API

Income and expense tracker API, Income-Expense Ledger manages its records from your own app: list, add, update and delete. The endpoints work with an API key instead of a browser session.

Quick start

Create a key in the Developer API section of your account; the plain-text key is shown only when it is created.
Send the request to https://api.pixepi.com with the Authorization: Bearer <key> header.
Responses return JSON; on list endpoints you can use the page, per_page and filter fields.

Example request

curl -H "Authorization: Bearer $PIXEPI_KEY" "https://api.pixepi.com/api/v1/apps/gelir-gider-defteri/categories"

curl -X POST "https://api.pixepi.com/api/v1/apps/gelir-gider-defteri/categories" \
  -H "Authorization: Bearer $PIXEPI_KEY" \
  -d "kind=expense" \
  -d "name=Rent"

This tool's endpoints

Method	Path	What it does
`GET`	`/categories`	Lists categories (shared system categories plus your own).
`POST`	`/categories`	Adds a new category.
`POST`	`/categories/{id}`	Updates a category.
`POST`	`/categories/{id}/archive`	Archives a category; calling it again does not change the status.
`GET`	`/entries`	Lists entries; filters by date, type, category and note.
`POST`	`/entries`	Adds a new entry.
`POST`	`/entries/{id}`	Updates an entry.
`POST`	`/entries/{id}/delete`	Deletes an entry.
`GET`	`/summary`	Summary breakdown: by month, category or type.
`GET`	`/export.csv`	Exports entries as CSV.

Shared endpoints

Method	Path	What it does
`GET`	`/api/v1/apps`	API catalog
`GET`	`/api/v1/apps/gelir-gider-defteri`	Tool contract
`GET`	`/api/v1/usage`	Usage summary
`GET`	`/api/v1/openapi.json`	OpenAPI 3.1 document

Limits

The limit field in list responses carries usage and cap information.
Quota and plan information is tied to your account; check the current state with GET /api/v1/usage.

Error codes

Code	Meaning
`unauthorized`	The API key is missing or invalid.
`forbidden`	This operation is not allowed with this key.
`not_found`	Tool, job or record not found (404 also for cross-account access).
`invalid_input`	Input failed validation (missing or malformed field, invalid date, and so on).
`invalid_request`	The request is malformed.
`too_large`	File or body size exceeds the limit.
`unsupported_media`	The file type is not accepted.
`not_supported`	This tool cannot run on this endpoint (stateful app).
`not_ready`	The job is not finished yet.
`expired`	The output has expired.
`no_output`	There is no output to download for the job.
`invalid_path`	Invalid output path.
`quota_exceeded`	Quota or rate limit exceeded.
`rate_limited`	Too many requests in a short time; wait a bit and try again.
`csrf`	Browser form verification failed (the external API uses keys).
`conflict`	The operation conflicts with the current state.
`unavailable`	The tool is temporarily closed.
`internal_error`	Unexpected server error.

Documents

Frequently asked questions

Where do I get an API key?

Create a key in the Developer API section of your account; the key is shown once, at the moment it is created.

How is a request sent?

The endpoints run at https://api.pixepi.com; every request includes the "Authorization: Bearer <key>" header.

Which endpoints does the Income-Expense Ledger API expose?

The table above lists the declared endpoints; all of them work with records tied to your account and return 404 for cross-account access.

How do I read an error response?

The error body carries {ok:false, error, code, request_id} fields; code values are in the error codes table.