# Ledgitify

## Docs

- [REST API (v1)](https://docs.ledgitify.com/api-reference.md): Read-only access to your Ledgitify projects, reports, allocations, and transactions.
- [Project allocations](https://docs.ledgitify.com/api-reference/allocations/project-allocations.md): The allocations recorded against the project's budget lines. Requires the `allocations:read` scope.
- [Get a project](https://docs.ledgitify.com/api-reference/projects/get-a-project.md): Returns a single project. Requires the `projects:read` scope. Returns `404` if the project is not in your organisation.
- [List projects](https://docs.ledgitify.com/api-reference/projects/list-projects.md): Returns the organisation's projects. Requires the `projects:read` scope.
- [Project budget-vs-actual report](https://docs.ledgitify.com/api-reference/projects/project-budget-vs-actual-report.md): Budget-vs-actual for the project, computed through the report engine (derived, cumulative, and in-kind lines handled correctly). Requires the `reports:read` scope. Each cell carries `budgeted`, `actual`, and `variance`.
- [List transactions](https://docs.ledgitify.com/api-reference/transactions/list-transactions.md): Organisation-level accounting transactions (an allocation links a transaction to a project, so transactions are not nested under a project). Requires the `transactions:read` scope. The full provider payload and internal exclusion audit fields are never exposed.
- [Push transactions (batch)](https://docs.ledgitify.com/api-reference/transactions/push-transactions-batch.md): Create or update cash transactions in batch from an external finance system (the inbound counterpart to the Xero sync). Requires the `transactions:write` scope. Each row is validated independently, so a batch may partially succeed; re-pushing the same `externalId` updates the existing row instead of…
- [Connect your Xero organisation](https://docs.ledgitify.com/connect-xero.md): Link a Xero organisation to Ledgitify using secure OAuth 2.0. Read-only access, revocable at any time.
- [Disconnecting Xero](https://docs.ledgitify.com/disconnect-xero.md): How to disconnect a Xero organisation, what happens to your data, and how to reconnect.
- [Getting started](https://docs.ledgitify.com/getting-started.md): From sign-up to your first budget-vs-actual report in five steps.
- [Welcome to Ledgitify](https://docs.ledgitify.com/introduction.md): Project budgets. Properly tracked. A cost-allocation and budget-reporting layer on top of Xero.
- [How syncing works](https://docs.ledgitify.com/syncing.md): When Ledgitify pulls data from Xero, what it pulls, and how to trigger a sync yourself.
- [Troubleshooting Xero](https://docs.ledgitify.com/troubleshooting.md): Fixes for a lost connection, sync errors, and missing transactions.
- [What Ledgitify accesses in Xero](https://docs.ledgitify.com/xero-permissions.md): Every Xero permission Ledgitify requests, what it's for, and why it's read-only.

## OpenAPI Specs

- [openapi](https://docs.ledgitify.com/openapi.json)