> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://api-docs.papertracc.com/core/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://api-docs.papertracc.com/_mcp/server. # Overview The Core API gives you access to chart of accounts, customer and vendor profiles, tax configuration, inventory, invoices, receipts, bills, expenses, payments, and manual journal entries for a workspace. > **Note** > > Get your Papertracc API key and workspace identity from the dashboard before making requests. Use the API key for bearer auth and send the workspace identity in the `identity` header. > > Secret-key requests run with the role of the team member who generated the keys, and that member must belong to the workspace you call. If their role lacks the permission an endpoint needs, the request fails with `403` and `error_code: PERMISSION_DENIED`. Keys are revoked when that member is removed from the organisation. On Core endpoints, public keys can only read the chart of accounts and tax profiles, and skip the role check. ## Keys Core endpoints need a secret key. Three read-only endpoints also accept a public key: List Accounts, Get Chart Types and Get Tax Profiles. Each endpoint page ends with a **Keys** line that says which keys it accepts. ## Permissions Every endpoint lists the permission it needs in its description. A workspace manager can add a missing permission to the key owner's role. ## Lists and errors * Lists use cursor pagination. See [Pagination](/pagination). * Failed requests return `status: false` with a `message`. See [Errors](/errors) for the status codes and error codes. ## Docs - [Overview](https://api-docs.papertracc.com/core/chart-of-accounts.md) - [Overview](https://api-docs.papertracc.com/core/profiles.md) - [Overview](https://api-docs.papertracc.com/core/profiles/vendors.md) - [Overview](https://api-docs.papertracc.com/core/profiles/customers.md) - [Overview](https://api-docs.papertracc.com/core/profiles/sales-personnel.md) - [Overview](https://api-docs.papertracc.com/core/configurations.md) - [Overview](https://api-docs.papertracc.com/core/configurations/tax-profiles.md) - [Overview](https://api-docs.papertracc.com/core/configurations/payment-terms.md) - [Overview](https://api-docs.papertracc.com/core/sales.md) - [Overview](https://api-docs.papertracc.com/core/sales/invoices.md) - [Overview](https://api-docs.papertracc.com/core/sales/receipts.md) - [Overview](https://api-docs.papertracc.com/core/sales/commissions.md) - [Overview](https://api-docs.papertracc.com/core/sales/inventory.md) - [Overview](https://api-docs.papertracc.com/core/purchases.md) - [Overview](https://api-docs.papertracc.com/core/purchases/bills.md) - [Overview](https://api-docs.papertracc.com/core/purchases/expenses.md) - [Overview](https://api-docs.papertracc.com/core/payments.md) - [Overview](https://api-docs.papertracc.com/core/journals.md) ## API Docs - Core > Chart of Accounts [List Accounts](https://api-docs.papertracc.com/core/chart-of-accounts/list-accounts.md) - Core > Chart of Accounts [Get Chart Types](https://api-docs.papertracc.com/core/chart-of-accounts/get-chart-types.md) - Core > Profiles > Vendors [Create Vendor](https://api-docs.papertracc.com/core/profiles/vendors/create-vendor.md) - Core > Profiles > Vendors [Get Vendor](https://api-docs.papertracc.com/core/profiles/vendors/get-vendor.md) - Core > Profiles > Vendors [Update Vendor](https://api-docs.papertracc.com/core/profiles/vendors/update-vendor.md) - Core > Profiles > Vendors [Get Vendors](https://api-docs.papertracc.com/core/profiles/vendors/get-vendors.md) - Core > Profiles > Vendors [Update Vendor Account](https://api-docs.papertracc.com/core/profiles/vendors/update-vendor-account.md) - Core > Profiles > Customers [Create Customer](https://api-docs.papertracc.com/core/profiles/customers/create-customer.md) - Core > Profiles > Customers [Get Customer](https://api-docs.papertracc.com/core/profiles/customers/get-customer.md) - Core > Profiles > Customers [Update Customer](https://api-docs.papertracc.com/core/profiles/customers/update-customer.md) - Core > Profiles > Customers [Get Customers](https://api-docs.papertracc.com/core/profiles/customers/get-customers.md) - Core > Profiles > Customers [Update Customer Account](https://api-docs.papertracc.com/core/profiles/customers/update-customer-account.md) - Core > Profiles > Sales Personnel [Create Sales Personnel](https://api-docs.papertracc.com/core/profiles/sales-personnel/create-sales-personnel.md) - Core > Profiles > Sales Personnel [Get Sales Personnel](https://api-docs.papertracc.com/core/profiles/sales-personnel/get-sales-personnel.md) - Core > Profiles > Sales Personnel [Get Sales Personnel By Id](https://api-docs.papertracc.com/core/profiles/sales-personnel/get-sales-personnel-by-id.md) - Core > Profiles > Sales Personnel [Update Sales Personnel](https://api-docs.papertracc.com/core/profiles/sales-personnel/update-sales-personnel.md) - Core > Configurations > Tax Profiles [Get Tax Profiles](https://api-docs.papertracc.com/core/configurations/tax-profiles/get-tax-profiles.md) - Core > Configurations > Tax Profiles [Create Tax Profile](https://api-docs.papertracc.com/core/configurations/tax-profiles/create-tax-profile.md) - Core > Configurations > Tax Profiles [Update Tax Profile](https://api-docs.papertracc.com/core/configurations/tax-profiles/update-tax-profile.md) - Core > Configurations > Payment Terms [Get Payment Terms](https://api-docs.papertracc.com/core/configurations/payment-terms/get-payment-terms.md) - Core > Configurations > Payment Terms [Create Payment Term](https://api-docs.papertracc.com/core/configurations/payment-terms/create-payment-term.md) - Core > Configurations > Payment Terms [Update Payment Term](https://api-docs.papertracc.com/core/configurations/payment-terms/update-payment-term.md) - Core > Sales > Invoices [List Invoices](https://api-docs.papertracc.com/core/sales/invoices/list-invoices.md) - Core > Sales > Invoices [Create Invoice](https://api-docs.papertracc.com/core/sales/invoices/create-invoice.md) - Core > Sales > Invoices [Get Invoice](https://api-docs.papertracc.com/core/sales/invoices/get-invoice.md) - Core > Sales > Invoices [Update Invoice](https://api-docs.papertracc.com/core/sales/invoices/update-invoice.md) - Core > Sales > Invoices [Post Invoice](https://api-docs.papertracc.com/core/sales/invoices/post-invoice.md) - Core > Sales > Invoices [Void Invoice](https://api-docs.papertracc.com/core/sales/invoices/void-invoice.md) - Core > Sales > Invoices [Amend Invoice](https://api-docs.papertracc.com/core/sales/invoices/amend-invoice.md) - Core > Sales > Invoices [Reject Invoice](https://api-docs.papertracc.com/core/sales/invoices/reject-invoice.md) - Core > Sales > Invoices [Approve Invoice](https://api-docs.papertracc.com/core/sales/invoices/approve-invoice.md) - Core > Sales > Invoices [Prepare Invoice](https://api-docs.papertracc.com/core/sales/invoices/prepare-invoice.md) - Core > Sales > Receipts [Get Receipt](https://api-docs.papertracc.com/core/sales/receipts/get-receipt.md) - Core > Sales > Receipts [List Receipts](https://api-docs.papertracc.com/core/sales/receipts/list-receipts.md) - Core > Sales > Commissions [List Commissions](https://api-docs.papertracc.com/core/sales/commissions/list-commissions.md) - Core > Sales > Commissions [Get Commission By Id](https://api-docs.papertracc.com/core/sales/commissions/get-commission-by-id.md) - Core > Sales > Inventory [Create Inventory](https://api-docs.papertracc.com/core/sales/inventory/create-inventory.md) - Core > Sales > Inventory [Get Inventory](https://api-docs.papertracc.com/core/sales/inventory/get-inventory.md) - Core > Sales > Inventory [Update Inventory](https://api-docs.papertracc.com/core/sales/inventory/update-inventory.md) - Core > Sales > Inventory [Get Inventories](https://api-docs.papertracc.com/core/sales/inventory/get-inventories.md) - Core > Purchases > Bills [List Bills](https://api-docs.papertracc.com/core/purchases/bills/list-bills.md) - Core > Purchases > Bills [Create Bill](https://api-docs.papertracc.com/core/purchases/bills/create-bill.md) - Core > Purchases > Bills [Get Bill](https://api-docs.papertracc.com/core/purchases/bills/get-bill.md) - Core > Purchases > Bills [Update Bill](https://api-docs.papertracc.com/core/purchases/bills/update-bill.md) - Core > Purchases > Bills [Post Bill](https://api-docs.papertracc.com/core/purchases/bills/post-bill.md) - Core > Purchases > Bills [Void Bill](https://api-docs.papertracc.com/core/purchases/bills/void-bill.md) - Core > Purchases > Bills [Amend Bill](https://api-docs.papertracc.com/core/purchases/bills/amend-bill.md) - Core > Purchases > Bills [Reject Bill](https://api-docs.papertracc.com/core/purchases/bills/reject-bill.md) - Core > Purchases > Bills [Approve Bill](https://api-docs.papertracc.com/core/purchases/bills/approve-bill.md) - Core > Purchases > Bills [Prepare Bill](https://api-docs.papertracc.com/core/purchases/bills/prepare-bill.md) - Core > Purchases > Expenses [List Expenses](https://api-docs.papertracc.com/core/purchases/expenses/list-expenses.md) - Core > Purchases > Expenses [Create Expense](https://api-docs.papertracc.com/core/purchases/expenses/create-expense.md) - Core > Purchases > Expenses [Get Expense](https://api-docs.papertracc.com/core/purchases/expenses/get-expense.md) - Core > Purchases > Expenses [Void Expense](https://api-docs.papertracc.com/core/purchases/expenses/void-expense.md) - Core > Purchases > Expenses [Amend Expense](https://api-docs.papertracc.com/core/purchases/expenses/amend-expense.md) - Core > Payments [Create Payment](https://api-docs.papertracc.com/core/payments/create-payment.md) - Core > Payments [Get Payment](https://api-docs.papertracc.com/core/payments/get-payment.md) - Core > Payments [List Payments](https://api-docs.papertracc.com/core/payments/list-payments.md) - Core > Payments [Void Payment](https://api-docs.papertracc.com/core/payments/void-payment.md) - Core > Payments [Amend Payment](https://api-docs.papertracc.com/core/payments/amend-payment.md) - Core > Payments [Get Payables](https://api-docs.papertracc.com/core/payments/get-payables.md) - Core > Journals [List Manual Journals](https://api-docs.papertracc.com/core/journals/list-manual-journals.md) - Core > Journals [Create Manual Journal](https://api-docs.papertracc.com/core/journals/create-manual-journal.md) - Core > Journals [Get Manual Journal](https://api-docs.papertracc.com/core/journals/get-manual-journal.md) - Core > Journals [Delete Manual Journal](https://api-docs.papertracc.com/core/journals/delete-manual-journal.md) - Core > Journals [Update Manual Journal](https://api-docs.papertracc.com/core/journals/update-manual-journal.md) - Core > Journals [Post Manual Journal](https://api-docs.papertracc.com/core/journals/post-manual-journal.md) - Core > Journals [Void Manual Journal](https://api-docs.papertracc.com/core/journals/void-manual-journal.md) - Core > Journals [Reject Manual Journal](https://api-docs.papertracc.com/core/journals/reject-manual-journal.md) ## OpenAPI Specification The raw OpenAPI 3.1 specification for this API is available at: - [OpenAPI JSON](https://api-docs.papertracc.com/openapi.json) - [OpenAPI YAML](https://api-docs.papertracc.com/openapi.yaml)