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 AccountingEntries API

`AccountingEntry` represents a single line of a company's general accounting journal — an outflow (`assetAmount`) or inflow (`liabilityAmount`) movement posted to a ledger account (`accountingCode`). `customId` is the unique identifier of an entry: set your own value to use as your ERP accounting entry ID, or let Embat auto-generate one. Entries that belong to the same journal document (e.g. all the lines of one invoice posting) can share the same `accountingEntryCode`.Accounting entries are the accounting side of Embat's reconciliation process with `Transactions` (bank movements): Embat matches entries against transactions and exposes the outcome here through `reconciled` and `reconciliationsIds`. An entry can also reference a `Contact` (client/supplier, via `contactCustomId`, when `accountingCode` is a contacts account), a `Payment` it relates to (`paymentId`), or a source document (`documentId`).**Typical flow:** accounting entries synchronize your general ledger in both directions between your ERP and Embat.1. **Notify Embat of entries posted in your ERP.** When a journal line is recorded in your ERP, create it in Embat with `POST /accountingentries/{companyId}` (or the bulk variant):```jsonPOST /accountingentries/{companyId}{ "customId": "erp-entry-2024-001", "accountingEntryCode": "invoice-2024-001", "accountingCode": "4300001", "accountingName": "Trade debtors", "date": "2024-01-15T00:00:00Z", "assetAmount": 1250.50, "liabilityAmount": 0, "currency": "EUR"}```2. **Read entries and their reconciliation status.** Use `GET /accountingentries/{companyId}` with the `reconciled` filter and `startUpdatedAt`/`endUpdatedAt` for incremental reads since your last poll, or `GET /accountingentries/{companyId}/{customId}` to retrieve a single entry.3. **Correct or remove entries as your ledger changes.** Use `PATCH /accountingentries/{companyId}/{customId}` (or the bulk variant) to update fields — resend the current `description` if you want to keep it, since omitting it resets it to an auto-generated value. You can also resend the full entry with `POST`: creation is an upsert, so an existing `customId` is updated instead of duplicated. Use `DELETE` to remove entries individually or in bulk, by `customId` or by `accountingEntryCode`/`accountingEntryCodeId`.

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

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

This API exposes 9 operations across 4 paths, and defines 21 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.

9 operations 4 paths 21 schemas 3 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 AccountingEntries API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (HTTPBearer).

Paths & Operations 9

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

AccountingEntries 9

AccountingEntry represents a single line of a company's general accounting journal — an outflow (assetAmount) or inflow (liabilityAmount) movement posted to a ledger account (acco…

GET
/accountingentries/{companyId}
List accounting entries
list_accounting_entries_accountingentries__companyId__get 10 params → 200400401404422
POST
/accountingentries/{companyId}
Create accounting entry
create_accounting_entry_accountingentries__companyId__post 1 param body → 200401404500422
PATCH
/accountingentries/{companyId}
Update accounting entries in bulk
update_accounting_entries_bulk_accountingentries__companyId__patch 1 param body → 200401404500422
DELETE
/accountingentries/{companyId}
Delete accounting entries in bulk
delete_accounting_entries_bulk_accountingentries__companyId__delete 1 param body → 200401404500422
GET
/accountingentries/{companyId}/{customId}
Retrieve accounting entry
retrieve_accounting_entry_accountingentries__companyId___customId__get 2 params → 200401404422
PATCH
/accountingentries/{companyId}/{customId}
Update accounting entry
update_accounting_entry_accountingentries__companyId___customId__patch 2 params body → 200401404500422
DELETE
/accountingentries/{companyId}/{customId}
Delete accounting entry
delete_accounting_entry_accountingentries__companyId___customId__delete 2 params → 200401404500422
POST
/accountingentries/{companyId}/bulk
Create accounting entries in bulk
create_accounting_entries_bulk_accountingentries__companyId__bulk_post 1 param body → 200401404500422
DELETE
/accountingentries/accountingentrycode/{companyId}
Delete accounting entries in bulk by entry code
delete_accounting_entries_bulk_by_entry_code_accountingentries_accountingentrycode__companyId__delete 1 param body → 200401404500422

Schemas 21

The contract defines 21 schemas that model the data the API accepts and returns. The most detailed are GetAccountingEntriesResponseSchema (29 properties), PostAccountingEntriesRequestSchema (22 properties), AuxBulkPatchAccountingEntriesRequestSchema (20 properties), PatchAccountingEntriesRequestSchema (19 properties). Each schema is shown below with its type and property counts.

CurrencyEnum
string
ValidationError
object
5 properties 3 required
PatchAccountingEntriesRequestSchema
object
19 properties
BulkPatchAccountingEntriesRequestSchema
object
1 property 1 required
BulkDeleteAccountingEntriesRequestSchema
object
1 property 1 required
UpsertAccountingEntriesResponseSchema
object
2 properties 2 required
AccountingTypeEnum
string
GetAccountingEntriesResponseSchema
object
29 properties 8 required
ModifyAccountingEntriesResponseSchema
object
1 property 1 required
BulkDeleteAccountingEntriesEntryCodeRequestSchema
object
1 property 1 required
PostAccountingEntriesRequestSchema
object
22 properties 4 required
BulkUpsertAccountingEntriesResponseSchema
object
1 property 1 required
DeleteAccountingEntriesRequestSchema
object
1 property 1 required
AttributeValueRequestSchema
object
Attaches an attribute value to another entity (payment, contact, operation, transaction, accounting entry...).
4 properties 2 required
DeleteAccountingEntriesEntryCodeRequestSchema
object
1 property 1 required
BulkModifyAccountingEntriesResponseSchema
object
1 property 1 required
ErrorResponse
object
Error payload returned by the API (FastAPI detail convention).
1 property 1 required
HTTPValidationError
object
1 property
BulkPostAccountingEntriesRequestSchema
object
1 property 1 required
ListAccountingEntriesResponseSchema
object
2 properties 1 required
AuxBulkPatchAccountingEntriesRequestSchema
object
20 properties 1 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

embat-accountingentries-api-openapi.yml Raw ↑

Other APIs Embat publishes across the network.

Embat AccountingAccounts 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