Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Embat AccountingAccounts API

`AccountingAccount` represents an account in the company's chart of accounts. `accountingCode` is the unique identifier of an account and is used as its ID; it also determines the account's default classification (`type`) when none is sent.Accounting accounts are the backbone Embat uses to classify money movements: `Payments` and accounting entries reference an account by `accountingCode` to record where a transaction is posted, and `Transactions` are reconciled against the account's `balance`.**Typical flow:** notify Embat of the accounts that exist in your ERP so that payments and reconciliations can reference them.1. **Create or update accounts.** Send each account from your chart of accounts with `POST /accountingaccounts/{companyId}` (or the bulk variant `POST /accountingaccounts/{companyId}/bulk`). Sending an `accountingCode` that already exists updates that account instead of creating a duplicate.2. **Keep accounts in sync.** As accounts change in your ERP (renamed, deactivated, reclassified), reflect those changes with `PATCH /accountingaccounts/{companyId}/{accountingCode}` (or the bulk variant `PATCH /accountingaccounts/{companyId}`), or simply resend the account with `POST` — creation is an upsert, so an existing `accountingCode` is updated instead of duplicated. Note that `type` can only be changed via `PATCH`.3. **Read accounts.** Use `GET /accountingaccounts/{companyId}` to list all accounts, or `GET /accountingaccounts/{companyId}/{accountingCode}` to retrieve a single one, including its current `balance`.4. **Delete accounts.** `DELETE /accountingaccounts/{companyId}/{accountingCode}` (or the bulk variant) deactivates an account rather than permanently removing it; deactivated accounts still appear in list/retrieve responses with `active: false`.

Embat AccountingAccounts API is one of 22 APIs that Embat publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include AccountingAccounts. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

This API exposes 8 operations across 3 paths, and defines 18 schemas. It is described by OpenAPI 3.1.0, at version 2.120.3.

Requests are made against the base URL https://api.embat.io.

8 operations 3 paths 18 schemas 2 DELETE2 GET2 PATCH2 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
2.120.3
Base URL
https://api.embat.io
Authentication
HTTP Bearer
Resource Areas
1

Authentication & Security 1

Embat AccountingAccounts API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (HTTPBearer).

Paths & Operations 8

Across 3 paths, the API surfaces 8 operations — 2 DELETE, 2 GET, 2 PATCH, 2 POST. Each is listed below with its method, path, parameters, and response codes.

AccountingAccounts 8

AccountingAccount represents an account in the company's chart of accounts. accountingCode is the unique identifier of an account and is used as its ID; it also determines the acc…

GET
/accountingaccounts/{companyId}
List accounting accounts
list_accountings_accounts_accountingaccounts__companyId__get 3 params → 200401404422
POST
/accountingaccounts/{companyId}
Create accounting account
create_accountings_account_accountingaccounts__companyId__post 1 param body → 200401404500422
PATCH
/accountingaccounts/{companyId}
Update accounting accounts in bulk
update_accountings_accounts_bulk_accountingaccounts__companyId__patch 1 param body → 200401404500422
DELETE
/accountingaccounts/{companyId}
Delete accounting accounts in bulk
delete_accountings_accounts_bulk_accountingaccounts__companyId__delete 1 param body → 200401404500422
GET
/accountingaccounts/{companyId}/{accountingCode}
Retrieve accounting account
retrieve_accountings_account_accountingaccounts__companyId___accountingCode__get 2 params → 200401404422
PATCH
/accountingaccounts/{companyId}/{accountingCode}
Update accounting account
update_accountings_account_accountingaccounts__companyId___accountingCode__patch 2 params body → 200401404500422
DELETE
/accountingaccounts/{companyId}/{accountingCode}
Delete accounting account
delete_accountings_account_accountingaccounts__companyId___accountingCode__delete 2 params → 200401404500422
POST
/accountingaccounts/{companyId}/bulk
Create accounting accounts in bulk
create_accountings_accounts_bulk_accountingaccounts__companyId__bulk_post 1 param body → 200401404500422

Schemas 18

The contract defines 18 schemas that model the data the API accepts and returns. The most detailed are GetAccountingsAccountsResponseSchema (12 properties), PostAccountingsAccountsRequestSchema (7 properties), AuxBulkPatchAccountingsAccountsRequestSchema (7 properties), PatchAccountingsAccountsRequestSchema (6 properties). Each schema is shown below with its type and property counts.

BulkUpsertAccountingsAccountsResponseSchema
object
1 property 1 required
PatchAccountingsAccountsRequestSchema
object
6 properties
ErrorResponse
object
Error payload returned by the API (FastAPI detail convention).
1 property 1 required
DeleteAccountingsAccountsRequestSchema
object
1 property 1 required
HTTPValidationError
object
1 property
AccountingTypeEnum
string
BulkPatchAccountingsAccountsRequestSchema
object
1 property 1 required
ValidationError
object
5 properties 3 required
AttributeValueRequestACCOUNTSchema
object
3 properties
ModifyAccountingsAccountsResponseSchema
object
1 property 1 required
AuxBulkPatchAccountingsAccountsRequestSchema
object
7 properties 1 required
ListAccountingsAccountsResponseSchema
object
2 properties 1 required
BulkModifyAccountingsAccountsResponseSchema
object
1 property 1 required
GetAccountingsAccountsResponseSchema
object
12 properties 4 required
BulkPostAccountingsAccountsRequestSchema
object
1 property 1 required
PostAccountingsAccountsRequestSchema
object
7 properties 1 required
UpsertAccountingsAccountsResponseSchema
object
2 properties 2 required
BulkDeleteAccountingsAccountsRequestSchema
object
1 property 1 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

embat-accountingaccounts-api-openapi.yml Raw ↑

Other APIs Embat publishes across the network.

Embat AccountingEntries API
Embat Attributes API
Embat Authentication API
Embat Balances API
Embat Banks API
Embat Categories API
Embat Companies API
Embat Contacts API
Embat DebtScheduleConfigs API
Embat Files API
Embat Forecasts API
Embat ForeignExchangeRates API