---
title: "POST /DeaBooks/{id}/entries"
method: POST
path: "/DeaBooks/{id}/entries"
tags: ["DeaBooks"]
---

# POST /DeaBooks/{id}/entries

`POST /DeaBooks/{id}/entries`

## Request

- Base URL: `https://api.clinicos.vet/backend/business`
- URL: `https://api.clinicos.vet/backend/business/DeaBooks/{id}/entries`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/clinicos/apis/pawthosx-business-api-v1/docs/DeaBooks/:id/entries/post.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `id` string, required

## Request body

- CreateDEAEntryDto
  - `adjustInventory` boolean
  - `expectedInventoryQuantity` union
    - number, double
    - string, double
  - `containerId` string
  - `action` string
  - `quantity` union
    - number, double
    - string, double
  - `containerStatus` string
  - `patientId` string, nullable
  - `witnessUserId` string, nullable
  - `notes` string, nullable
  - `reason` string, nullable
  - `correctedEntryId` string, nullable
  - `expectedLatestEntryId` string, nullable: Optimistic token (ITE-1001): the id of the container's newest ledger entry as the user saw it when they opened the form. When present, the append is refused with 400 `DEA_LEDGER_CHANGED` if the (book, container) ledger has moved since. Optional and not persisted — omitting it keeps the previous, unchecked behavior.
  - `collectorName` string, nullable: UK CDR: name of the person who collected the dispensed CD.
  - `collectorIdChecked` boolean, nullable: UK CDR: whether collector photo ID was verified.
  - `entryDate` string, date-time, nullable

## Response `200`

OK

- DEAEntryDto
  - `inventoryTransactionId` string, nullable
  - `id` string
  - `deaBookId` string
  - `containerId` string
  - `action` string
  - `quantity` union
    - number, double
    - string, double
  - `balance` union
    - number, double
    - string, double
  - `containerStatus` string
  - `patientId` string, nullable
  - `patient` DEAPatientSummaryDto
    - `id` string
    - `name` string
    - `species` string
    - `clientId` string, nullable
    - `clientName` string, nullable
  - `userId` string
  - `user` DEAUserSummaryDto
    - `id` string
    - `displayName` string
    - `firstName` string, nullable
    - `lastName` string, nullable
    - `email` string
  - `witnessUserId` string, nullable
  - `witnessUser` DEAUserSummaryDto
    - `id` string
    - `displayName` string
    - `firstName` string, nullable
    - `lastName` string, nullable
    - `email` string
  - `notes` string, nullable
  - `reason` string, nullable
  - `correctedEntryId` string, nullable
  - `collectorName` string, nullable: UK CDR: name of the person who collected the dispensed CD.
  - `collectorIdChecked` boolean, nullable: UK CDR: whether collector photo ID was verified.
  - `quantityWordsAndFigures` string, nullable: UK CDR: quantity rendered in words + figures (CD Sched 2/3).
  - `entryDate` string, date-time
  - `createdAt` string, date-time

## Changes

- **2026-09-30** `d58b40cfca93`: 12 info
  - added the new optional request property `adjustInventory` (media type: application/json)
  - added the new optional request property `adjustInventory` (media type: text/json)
  - added the new optional request property `adjustInventory` (media type: application/*+json)
  - added the new optional request property `expectedInventoryQuantity` (media type: application/json)
  - …8 more

[Operation history](https://skmtc.dev/clinicos/apis/pawthosx-business-api-v1/changes/DeaBooks/:id/entries/post.md)

---

[API](https://skmtc.dev/clinicos/apis/pawthosx-business-api-v1.md) - [All operations](https://skmtc.dev/clinicos/apis/pawthosx-business-api-v1/llms.txt) - [OpenAPI document](https://skmtc.dev/clinicos/apis/pawthosx-business-api-v1/revisions/099cf36186e0?raw)