# Digits Connect API Documentation > Documentation for Digits Connect API ## Guides: API - [Digits Connect API](https://developer.digits.com/docs/overview.md): The Digits Connect API gives you programmatic access to the AGL — our AI-native general ledger. Send raw financial data and get clean, categorized, deduplicated entries! - [Quickstart](https://developer.digits.com/docs/quickstart.md): Set up an entity app in the Developer Sandbox and make your first request. - [API Versioning](https://developer.digits.com/docs/api-versioning.md): The Digits Connect API uses route-based versioning with the version number as a URL path prefix. - [Authentication](https://developer.digits.com/docs/authentication.md): Choose a service account for your own organization, or an OAuth app for access to individual entities or an entire organization. - [SDKs and LLMs](https://developer.digits.com/docs/sdks-llms.md): OpenAPI codegen for 50+ programming languages, with LLMs.txt support - [Rate Limits](https://developer.digits.com/docs/rate-limits.md): The Digits Connect API implements rate limiting to ensure fair usage and maintain service quality for all users. - [Pagination](https://developer.digits.com/docs/pagination.md): The Digits Connect API uses cursor-based pagination for paginated list endpoints. This approach provides efficient and reliable pagination through large result sets. - Creating Apps - [Developer Accounts](https://developer.digits.com/docs/developer-accounts.md): Developing on Digits is free, fast, and requires just a few steps to get started. - [App Creation](https://developer.digits.com/docs/app-creation.md): How to create an app, choose scopes, and prepare for authentication. - [Developer Sandbox](https://developer.digits.com/docs/developer-sandbox-testing-your-app.md): Explore Digits with realistic sample data and test your app! - [Publishing Apps](https://developer.digits.com/docs/publishing-apps.md): Understand app modes, approval, and publishing options. ## Guides: Architecture - [Working across an organization](https://developer.digits.com/docs/working-across-an-organization.md): Discover businesses, read multiple ledgers, and initialize source writes with one organization-level token. - [Source vs Ledger](https://developer.digits.com/docs/source-vs-ledger.md): Digits has an "isolated bankfeed" architecture - Sources are merged to become the Ledger. - [Identifiers](https://developer.digits.com/docs/identifiers.md): Sources use externally defined identifiers to track uniqueness and idempotence. - [Sources](https://developer.digits.com/docs/sources.md): Sources organize transactions into logical groups, enabling powerful bookkeeping automation. - [Matching](https://developer.digits.com/docs/matching.md): Transactions are matched when they represent the same economic event. ## Guides: AGL - [Categorization](https://developer.digits.com/docs/digits-ai-categorization.md): Effortless, adaptive, automatic AI categorization - [Party Hydration](https://developer.digits.com/docs/ai-party-research.md): Who was this transaction with? - [Documents](https://developer.digits.com/docs/documents.md): AI document extraction for Bills, Statements, Receipts, and more ## Guides: Writing Data - [Transactions](https://developer.digits.com/docs/transactions.md): Digits automatically manages categorization, matching, and enrichment for your source transaction data. - [Category Labels](https://developer.digits.com/docs/category-labels.md): Bookkeeping without tracking the chart of accounts - [Invoices & Bills](https://developer.digits.com/docs/invoices-bills.md): Add invoice and bill details to any transaction to enable payment linking and aging - [Parties](https://developer.digits.com/docs/parties.md): Define and manage the customers, vendors, and other parties your integration references in Digits. ## Guides: Reading Data - General Ledger - [Chart of Accounts](https://developer.digits.com/docs/chart-of-accounts.md) - [Financial Statements](https://developer.digits.com/docs/financial-statements.md): Create on-demand statements for any time period - [Aggregations](https://developer.digits.com/docs/aggregations.md): Digits supports deep on-demand financial analysis through our aggregation engine. ## Guides: Workflow Automation - [Zapier](https://developer.digits.com/docs/zapier.md) ## API Reference: Connection - Authorization - [Authorize](https://developer.digits.com/reference/oauth_authorize.md): Initiates the OAuth 2.0 authorization flow by redirecting users to authorize your application. After the user authorizes your application, they will be redirected to your `redirect_uri` with the… - [Token Exchange](https://developer.digits.com/reference/authorizationservice_token.md): Obtain an access token using client_credentials for a service account, or exchange an authorization_code or refresh_token for an entity or organization app. App grants return a refresh token;… - Sources - [Sync Sources](https://developer.digits.com/reference/connectionsourceservice_sync.md): Sync endpoint to create, update, and archive connection sources. Connection sources organize transactions (for example, by bank account; or to separate bills and invoices) Labels allow seamless… - [List Sources](https://developer.digits.com/reference/connectionsourceservice_list.md): List all connection sources. Requires scope: `source:sync`. - Company - [Get Company Info](https://developer.digits.com/reference/companyservice_get.md): Read endpoint to get company information, including fiscal year start month and earliest transaction date. ## API Reference: Source - Transactions - [Sync Transactions](https://developer.digits.com/reference/sourcetransactionservice_sync.md): Batch sync endpoint to create or update transactions. Idempotence and deduplication is handled via the external_id field on each transaction. Requires scope: `source:sync`. - [Void Transactions](https://developer.digits.com/reference/sourcetransactionservice_void.md): Void selected transactions linked to a bill or invoice, without cascading. Requires scope: `source:sync`. - [Delete Transactions](https://developer.digits.com/reference/sourcetransactionservice_delete.md): Delete transactions by external ID. Requires scope: `source:sync`. - Metrics - [Store Samples](https://developer.digits.com/reference/sourcemetricservice_store.md): Batch endpoint to store time series metric samples. Requires scope: `source:sync`. - Departments - [List Departments](https://developer.digits.com/reference/sourcedepartmentservice_list.md): List the active departments saved for this source. Updates are available here immediately after a successful sync, even if they have not yet appeared in the ledger. Requires scope: `source:sync`. - [Sync Departments](https://developer.digits.com/reference/sourcedepartmentservice_sync.md): Sync the complete list of departments for this source, matching by external ID. Omitted departments become inactive; an empty list deactivates all departments for this source. Parent departments… - Locations - [List Locations](https://developer.digits.com/reference/sourcelocationservice_list.md): List the locations provided by this source. Requires scope: `source:sync`. - [Sync Locations](https://developer.digits.com/reference/sourcelocationservice_sync.md): Batch sync endpoint to create, update, and delete locations. Idempotence and deduplication is handled via the external_id field on each location. Requires scope: `source:sync`. - Projects - [List Projects](https://developer.digits.com/reference/sourceprojectservice_list.md): List the projects provided by this source. Requires scope: `source:sync`. - [Sync Projects](https://developer.digits.com/reference/sourceprojectservice_sync.md): Batch sync endpoint to create, update, and delete projects. Idempotence and deduplication is handled via the external_id field on each project. Requires scope: `source:sync`. - Products - [List Products](https://developer.digits.com/reference/sourceproductservice_list.md): List the products provided by this source. Requires scope: `source:sync`. - [Sync Products](https://developer.digits.com/reference/sourceproductservice_sync.md): Batch sync endpoint to create, update, and delete products. Idempotence and deduplication is handled via the external_id field on each product. Requires scope: `source:sync`. - Parties - [List Parties](https://developer.digits.com/reference/sourcepartyservice_list.md): List the parties provided by this source. Requires scope: `source:sync`. - [Sync Parties](https://developer.digits.com/reference/sourcepartyservice_sync.md): Batch sync endpoint to create, update, and delete parties. Idempotence and deduplication is handled via the external_id field on each party. Requires scope: `source:sync`. ## API Reference: Ledger - Statements - [Balance Sheet](https://developer.digits.com/reference/ledgerstatementsservice_balancesheet.md): Generate a balance sheet statement. Requires scope: `ledger:read`. - [Cash Flow](https://developer.digits.com/reference/ledgerstatementsservice_cashflow.md): Generate a cash flow statement. Requires scope: `ledger:read`. - [Profit and Loss](https://developer.digits.com/reference/ledgerstatementsservice_profitandloss.md): Generate a profit and loss statement. Requires scope: `ledger:read`. - [Trial Balance](https://developer.digits.com/reference/ledgerstatementsservice_trialbalance.md): Generate a trial balance statement. Requires scope: `ledger:read`. - [A/P Aging](https://developer.digits.com/reference/ledgerstatementsservice_apaging.md): Generate an accounts payable aging report. Requires scope: `ledger:read`. - [A/R Aging](https://developer.digits.com/reference/ledgerstatementsservice_araging.md): Generate an accounts receivable aging report. Requires scope: `ledger:read`. - Summaries - [Get Summary](https://developer.digits.com/reference/ledgersummaryservice_summarize.md): Get a summary of ledger transactions. Requires scope: `ledger:read`. - Categories - [List Categories](https://developer.digits.com/reference/ledgercategoryservice_list.md): Fetch the full Chart of Accounts from the Ledger. Requires scope: `ledger:read`. - [Get Category](https://developer.digits.com/reference/ledgercategoryservice_get.md): Get a single category by its ID. Requires scope: `ledger:read`. - Departments - [Get Department](https://developer.digits.com/reference/ledgerdepartmentservice_get.md): Get a single ledger department by its ID. Requires scope: `ledger:read`. - [List Departments](https://developer.digits.com/reference/ledgerdepartmentservice_list.md): List ledger departments. Requires scope: `ledger:read`. - Transactions - [List Entries](https://developer.digits.com/reference/ledgertransactionservice_entries.md): List ledger entries. Requires scope: `ledger:read`. - [Query Entries](https://developer.digits.com/reference/ledgertransactionservice_queryentries.md): Query ledger entries. Requires scope: `ledger:read`. - [Get Transaction](https://developer.digits.com/reference/ledgertransactionservice_gettransaction.md): Get a ledger transaction by its ID. Requires scope: `ledger:read`. - [Query Bills](https://developer.digits.com/reference/ledgerbillservice_query.md): Query ledger-backed bills from the published view. Requires scope: `ledger:read`. - [Query Invoices](https://developer.digits.com/reference/ledgerinvoiceservice_query.md): Query ledger-backed invoices from the published view. Requires scope: `ledger:read`. - Projects - [Get Project](https://developer.digits.com/reference/ledgerprojectservice_get.md): Get a single ledger project by its ID. Requires scope: `ledger:read`. - [List Projects](https://developer.digits.com/reference/ledgerprojectservice_list.md): List ledger projects. Requires scope: `ledger:read`. - Locations - [Get Location](https://developer.digits.com/reference/ledgerlocationservice_get.md): Get a single ledger location by its ID. Requires scope: `ledger:read`. - [List Locations](https://developer.digits.com/reference/ledgerlocationservice_list.md): List ledger locations. Requires scope: `ledger:read`. - Parties - [List Parties](https://developer.digits.com/reference/ledgerpartyservice_list.md): List ledger parties. Requires scope: `ledger:read`. - [Get Party](https://developer.digits.com/reference/ledgerpartyservice_get.md): Get a single ledger party by its ID. Requires scope: `ledger:read`. ## API Reference: Organization - Organization - [Get Organization](https://developer.digits.com/reference/organizationservice_get.md): Returns the caller's organization, including its Digits-assigned ID and, when set, its caller-assigned ID. - [List Entities](https://developer.digits.com/reference/organizationentityservice_list.md): List all entities in the organization. - [Get Entity](https://developer.digits.com/reference/organizationentityservice_get.md): Get a single entity by its Digits-assigned ID. - [List Clients](https://developer.digits.com/reference/organizationclientservice_list.md): List all client organizations affiliated with the organization. - [Get Client](https://developer.digits.com/reference/organizationclientservice_get.md): Get a single client organization by its Digits-assigned ID. - [List Employees](https://developer.digits.com/reference/organizationemployeeservice_list.md): List all employees in the organization. - [Get Employee](https://developer.digits.com/reference/organizationemployeeservice_get.md): Get a single employee by their Digits-assigned ID. ## API Reference: Provisioning - Beta - Organization - Entities - [Create Entity](https://developer.digits.com/reference/organizationentityservice_create.md): Create a new entity within the organization. The entity object is created synchronously, but data provisioning (chart of accounts, etc.) completes asynchronously. Requires scope:… - [Delete Entity](https://developer.digits.com/reference/organizationentityservice_delete.md): Delete an entity. Deleting an entity also removes all employee access bindings for that entity. Requires scope: `organization:sync`. - Payment Instruments - [Create Entity Payment Instrument](https://developer.digits.com/reference/entitypaymentinstrumentservice_create.md): Create or update a payment instrument owned by an organization entity. The entity's first instrument becomes its default funding instrument; an existing default is never overwritten. Requires… - [Delete Entity Payment Instruments](https://developer.digits.com/reference/entitypaymentinstrumentservice_delete.md): Delete entity payment instruments by Digits-assigned or caller-assigned IDs. Unknown IDs are skipped. A deleted payment instrument becomes unavailable for any future payments; any in-flight payments… - [Query Entity Payment Instruments](https://developer.digits.com/reference/entitypaymentinstrumentservice_query.md): Find entity payment instruments by Digits-assigned or caller-assigned IDs. Requires scope: `organization:sync`. - Clients - [Create Client](https://developer.digits.com/reference/organizationclientservice_create.md): Provision a new client organization with one or more entities. The client and entity objects are created synchronously, but data provisioning for each entity completes asynchronously. Requires… - [Bulk Create Clients](https://developer.digits.com/reference/organizationclientservice_bulkcreate.md): Provision multiple client organizations in a single request. Maximum 100 entities total across all clients per request. Each client is created synchronously, but entity data provisioning completes… - [Delete Client](https://developer.digits.com/reference/organizationclientservice_delete.md): Delete a client organization managed by the caller's organization. The client organization and its entities are removed. Employee bindings in the client organization and entity-role bindings on the… - [Bulk Delete Clients](https://developer.digits.com/reference/organizationclientservice_bulkdelete.md): Delete multiple client organizations by Digits-assigned ID or caller-assigned ID. Maximum 100 per request. Client organizations and their entities are removed. Employee bindings in each client… - Client Entities - [List Client Entities](https://developer.digits.com/reference/cliententityservice_listentities.md): List all entities within a client organization. Requires scope: `organization:sync`. - [Get Client Entity](https://developer.digits.com/reference/cliententityservice_getentity.md): Get a single entity within a client organization by its Digits-assigned ID. Requires scope: `organization:sync`. - [Create Client Entity](https://developer.digits.com/reference/cliententityservice_createentity.md): Create a new entity within a client organization. The entity object is created synchronously, but data provisioning completes asynchronously. Requires scope: `organization:sync`. - [Delete Client Entity](https://developer.digits.com/reference/cliententityservice_deleteentity.md): Delete an entity within a client organization. Removes all employee entity-role bindings for this entity. Requires scope: `organization:sync`. - [Bulk Delete Client Entities](https://developer.digits.com/reference/cliententityservice_bulkdeleteentities.md): Delete multiple client entities by Digits-assigned ID or caller-assigned ID. Maximum 100 per request. Removes all employee entity-role bindings for the specified entities. Requires scope:… - Client Payment Instruments - [Create Client Payment Instrument](https://developer.digits.com/reference/clientpaymentinstrumentservice_create.md): Create or update a payment instrument owned by a client entity. Requires scope: `organization:sync`. - [Delete Client Payment Instruments](https://developer.digits.com/reference/clientpaymentinstrumentservice_delete.md): Delete client payment instruments by Digits-assigned or caller-assigned IDs. Unknown IDs are skipped. A deleted payment instrument becomes unavailable for any future payments; any in-flight payments… - [Query Client Payment Instruments](https://developer.digits.com/reference/clientpaymentinstrumentservice_query.md): Find client payment instruments by Digits-assigned or caller-assigned IDs. Requires scope: `organization:sync`. - Client Employees - [List Client Employees](https://developer.digits.com/reference/clientemployeeservice_listclientemployees.md): List all client employees with access to a client organization. Requires scope: `organization:sync`. - [Get Client Employee](https://developer.digits.com/reference/clientemployeeservice_getclientemployee.md): Get a single client employee within a client organization by their Digits-assigned user ID. Requires scope: `organization:sync`. - [Create Client Employee](https://developer.digits.com/reference/clientemployeeservice_createclientemployee.md): Create or reactivate a client employee's access to a client organization. Both the user and client organization must already exist. This operation is synchronous. If the client employee binding… - [Update Client Employee](https://developer.digits.com/reference/clientemployeeservice_updateclientemployee.md): Replace a client employee's access within a client organization. The client employee binding must already exist and be active. If it does not exist or is not active, the request fails with… - [Delete Client Employee](https://developer.digits.com/reference/clientemployeeservice_deleteclientemployee.md): Remove a client employee's access to a client organization. Removes the client employee binding in the client organization and entity-role bindings for that client's entities. The underlying user… - [Bulk Create Client Employees](https://developer.digits.com/reference/clientemployeeservice_bulkcreateclientemployees.md): Create or reactivate multiple client employees' access across multiple client organizations in a single request. Users and client organizations must already exist. This operation is synchronous. An… - [Bulk Delete Client Employees](https://developer.digits.com/reference/clientemployeeservice_bulkdeleteclientemployees.md): Remove employee access across multiple client organizations by Digits-assigned user ID or caller-assigned user ID. Maximum 100 per request. Removes matching client employee bindings and entity-role… - Employees - [Update Employee](https://developer.digits.com/reference/organizationemployeeservice_update.md): Fully replace an employee binding. The user must already exist and have an active employee binding. The request must identify the employee by Digits-assigned ID or caller-assigned user ID, include… - [Create Employee](https://developer.digits.com/reference/organizationemployeeservice_create.md): Create, reactivate, or additively update an employee binding. The user must already exist (either provisioned via SSO or as an existing Digits user). This operation is synchronous. If the employee… - [Delete Employee](https://developer.digits.com/reference/organizationemployeeservice_delete.md): Delete an employee binding in the caller's organization. Removes all of the employee's entity-role and client-role bindings. The underlying user is not deleted. Requires scope: `organization:sync`. - [Bulk Delete Employees](https://developer.digits.com/reference/organizationemployeeservice_bulkdelete.md): Delete multiple employee bindings by Digits-assigned user ID or caller-assigned user ID. Maximum 100 per request. Deletes matching employee bindings and removes their entity-role and client-role… - Users - [List SSO Users](https://developer.digits.com/reference/ssouserservice_list.md): List all SSO users in the organization. The organization must have SSO configured. Requires scope: `user:sync`. - [Get SSO User](https://developer.digits.com/reference/ssouserservice_get.md): Get a single SSO user by their Digits-assigned ID. The organization must have SSO configured. Requires scope: `user:sync`. - [Create SSO User](https://developer.digits.com/reference/ssouserservice_create.md): Create a new SSO user. The organization must have SSO configured. A deleted user is reactivated when recreated by the same identity provider, whether under the previous subject identifier or a new… - [Delete SSO User](https://developer.digits.com/reference/ssouserservice_delete.md): Delete an SSO user. The organization must have SSO configured. Removes the user and their employee and entity access from the organization and its client organizations. This operation is… - [Bulk Delete SSO Users](https://developer.digits.com/reference/ssouserservice_bulkdelete.md): Delete multiple SSO users by Digits-assigned ID or caller-assigned ID. The organization must have SSO configured. Removes each user and their employee and entity access from the organization and… - [Audit SSO Users](https://developer.digits.com/reference/ssoauditservice_audit.md): Audit all SSO users in the organization with their current client organization access. Requires scope: `user:sync`. - [Get SSO Config](https://developer.digits.com/reference/ssoconfigservice_get.md): Returns the SSO configuration for the organization. The organization must have SSO previously configured. Requires scope: `user:sync`. ## API Reference: Webhooks - BETA - Webhooks - [Receive Webhook Event](https://developer.digits.com/reference/receivewebhookevent.md): Digits sends this JSON request body to your configured webhook endpoint. Return any 2xx response to acknowledge receipt; the response body is ignored. ## API Reference: Workflows - Beta - Bills - [Ingest Workflow Bill](https://developer.digits.com/reference/workflowbillservice_ingest.md): Ingest one vendor bill document for asynchronous processing. Repeating an equivalent request with the same external ID returns the existing bill and attempt identities; a different request with… - [Sync Workflow Bills](https://developer.digits.com/reference/workflowbillservice_sync.md): Create or reconcile 1–100 complete workflow bills as full snapshots. An exact replay returns the same bill identities without an Accounting write; a material update follows the bill's current… - [Query Workflow Bills](https://developer.digits.com/reference/workflowbillservice_query.md): Query workflow bills visible to the caller. Requires scope: `bills:manage`. - [Get Workflow Bill](https://developer.digits.com/reference/workflowbillservice_get.md): Get a workflow bill by its Digits-assigned ID. Requires scope: `bills:manage`. - [Submit Workflow Bills](https://developer.digits.com/reference/workflowbillservice_submit.md): Submit one or more draft bills for approval. Requires scope: `bills:manage`. - [Approve Workflow Bills](https://developer.digits.com/reference/workflowbillservice_approve.md): Approve one or more bills awaiting approval. Requires scope: `bills:manage`. - [Pay Workflow Bills](https://developer.digits.com/reference/workflowbillservice_pay.md): Pay one or more approved bills, either through Digits-managed payment rails or by recording an external/manual payment. Requires scope: `bills:manage`. - [Reject Workflow Bills](https://developer.digits.com/reference/workflowbillservice_reject.md): Reject one or more bills awaiting approval. Requires scope: `bills:manage`. - [Void Workflow Bills](https://developer.digits.com/reference/workflowbillservice_void.md): Void one or more eligible bills. Requires scope: `bills:manage`. - [Update Workflow Bill Payment Status](https://developer.digits.com/reference/workflowbillservice_updatepaymentstatus.md): Report externally managed payment lifecycle updates for one or more bills. Requires scope: `bills:manage`. - [Delete Workflow Bills](https://developer.digits.com/reference/workflowbillservice_delete.md): Delete one or more pre-approval bills. Requires scope: `bills:manage`. ## Examples - [Connection Source Setup](https://developer.digits.com/recipes/connection-source-setup.md) - [Application Authorization](https://developer.digits.com/recipes/exchange-authorization-code.md) - [Syncing Transactions](https://developer.digits.com/recipes/syncing-transactions.md) - [Token Exchange](https://developer.digits.com/recipes/token-exchange.md)