# Keep

> APIs for Keep, PayMe's accounting product: partners create and manage sellers, income documents, expenses, and tax and VAT balances, authenticating with OAuth 2.0 client credentials.

## Machine-readable

- [Keep OpenAPI spec](https://docs-staging.payme.io/keep-api-migrated/openapi.json): the OpenAPI document (also as [YAML](https://docs-staging.payme.io/keep-api-migrated/openapi.yaml))
- [Keep tool definitions](https://docs-staging.payme.io/api/v1/projects/keep-api-migrated/api/tools.json): one function-calling tool per endpoint
- [Keep full text](https://docs-staging.payme.io/keep-api-migrated/llms-full.txt): every Keep page in one file
- Markdown: append `.md` to any page URL for that page as Markdown
- Source: append `.yaml` to an endpoint page URL (a line that reads `METHOD path — summary`) for its source YAML; guide pages have no YAML

## Partner Authorization

- [Prerequisites](https://docs-staging.payme.io/keep-api-migrated/partner-authorization/prerequisites): Partner authorization layer protects the Partner's data on the Keep domain against unauthorized access and mutation.
- [Authorization Flow](https://docs-staging.payme.io/keep-api-migrated/partner-authorization/authorization-flow): This document provides a high-level overview of the Keep API authentication system.

## Seller API

- [List income documents](https://docs-staging.payme.io/keep-api-migrated/seller-api/listsellerincomedocuments): GET /seller/api/documents/income — List income documents
- [Seller API](https://docs-staging.payme.io/keep-api-migrated/seller-api/overview): The Seller API lets accounting integrations create, retrieve, cancel, and preview seller income documents such as invoices and receipts. This page is the editable landing for the Seller API category.
- [Create income document](https://docs-staging.payme.io/keep-api-migrated/seller-api/createsellerincomedocument): POST /seller/api/documents/income — Create income document
- [Get income document](https://docs-staging.payme.io/keep-api-migrated/seller-api/getsellerincomedocument): GET /seller/api/documents/income/{id} — Get income document
- [Cancel income document](https://docs-staging.payme.io/keep-api-migrated/seller-api/cancelsellerincomedocument): POST /seller/api/documents/income/{id}/cancel — Cancel income document
- [Generate document preview](https://docs-staging.payme.io/keep-api-migrated/seller-api/previewsellerincomedocument): POST /seller/api/documents/income/preview — Generate document preview

## Partners API

- [Obtain access token](https://docs-staging.payme.io/keep-api-migrated/partners-api/gettoken): POST /oauth2/token — Obtain access token
- [Create seller](https://docs-staging.payme.io/keep-api-migrated/partners-api/createseller): POST /public/sellers/create — Create seller
- [Get seller](https://docs-staging.payme.io/keep-api-migrated/partners-api/getsellerbyid): GET /public/sellers/{sellerId} — Get seller
- [Get available plans](https://docs-staging.payme.io/keep-api-migrated/partners-api/getpartnerplans): GET /public/plans — Get available plans
- [List expenses](https://docs-staging.payme.io/keep-api-migrated/partners-api/listpublicexpenses): GET /public/expenses — List expenses
- [Upload expense document](https://docs-staging.payme.io/keep-api-migrated/partners-api/uploadpublicexpense): POST /public/expenses — Upload expense document
- [Update expense](https://docs-staging.payme.io/keep-api-migrated/partners-api/updatepublicexpense): PATCH /public/expenses/{expenseId} — Update expense
- [Update seller](https://docs-staging.payme.io/keep-api-migrated/partners-api/updatesellerbyid): PUT /public/sellers/{sellerId}/update — Update seller
- [Get external URLs for seller](https://docs-staging.payme.io/keep-api-migrated/partners-api/getsellerexternalurls): GET /partner/api/sellers/external-urls — Get external URLs for seller
- [Get finance profile URL](https://docs-staging.payme.io/keep-api-migrated/partners-api/getsellerfinanceprofile): GET /partner/api/sellers/finance-profile — Get finance profile URL
- [Set seller billing plan](https://docs-staging.payme.io/keep-api-migrated/partners-api/setsellerplan): POST /partner/api/sellers/set-plan — Set seller billing plan
- [Create seller comment](https://docs-staging.payme.io/keep-api-migrated/partners-api/createsellercomment): POST /partner/api/sellers/comment — Create seller comment
- [List income documents](https://docs-staging.payme.io/keep-api-migrated/partners-api/listincomedocuments): GET /partner/api/documents/income — List income documents
- [Create manual income document](https://docs-staging.payme.io/keep-api-migrated/partners-api/createmanualincomedocument): POST /partner/api/documents/income/manual — Create manual income document
- [Setup tax authority for seller](https://docs-staging.payme.io/keep-api-migrated/partners-api/setuptaxauthority): POST /partner/api/tax-authority/setup — Setup tax authority for seller
- [Set VAT balance](https://docs-staging.payme.io/keep-api-migrated/partners-api/setvatbalance): POST /partner/api/sellers/vat-balance — Set VAT balance
- [Set tax balance](https://docs-staging.payme.io/keep-api-migrated/partners-api/settaxbalance): POST /partner/api/sellers/tax-balance — Set tax balance
- [Get financial checkpoints](https://docs-staging.payme.io/keep-api-migrated/partners-api/getcheckpoints): GET /partner/api/statistic/checkpoints — Get financial checkpoints
- [Get tax predictions](https://docs-staging.payme.io/keep-api-migrated/partners-api/gettaxpredictions): GET /partner/api/statistic/tax-predictions — Get tax predictions