Get

[POST] .../v1/docaccountmovement/get

Returns account transfer documents. Use this method to retrieve account transfer documents for finance journals, reconciliation screens, posting workflows and integrations that need account movement history. The request requires the account movement select permission, the finance account movement tariff option must be enabled and the query supports filters, sort_orders and pagination. The response returns a paged list with document code, date, firm, sender and receiver accounts, sent and received amounts, responsible user, additional fields, performed state, deletion mark, next_offset and total; account visibility is limited by the current request user's allowed accounts. Business errors such as missing body, denied access, disabled tariff option, invalid filters, database failures or persistent lookup errors are returned as HTTP 200 ErrorResult.

Request Parameters

Name Type Required Description
filters Array of Filter Optional Optional filters by fields available for this API method.
limit Int32 Optional Returned data limit for the request. The default and maximum values are defined by the server-side query_limit setting.
offset Int32 Optional Offset from the beginning of the server-side selection.
search String Optional Search by parameter values: code - document code, Firm/name - company name, Firm/inn - company TIN, sender_account_name - sender account name, receiver_account_name - receiver account name, User/name - responsible person full name.
sort_orders Array of DocAccountMovementColumn Optional Sort orders. Allowed columns are defined by DocAccountMovementColumns.

Filterable Fields

Field Type Description
account_receiver.id int
account_sender.id int
amount_received decimal
amount_sended decimal
attached_user_id int User IDs.
date int
deleted_mark bool Deletion mark state: true - marked for deletion, false - not marked for deletion.
end_date int Date as Unix time in seconds up to which account movement documents are returned.
firm_id int Company IDs.
id int Account movement document IDs.
performed bool Document posting state: true - posted, false - not posted.
start_date int Date as Unix time in seconds from which account movement documents are returned.

Sortable Fields

Field
account_receiver.name
account_sender.name
amount_received
amount_sended
attached_user.name
code
date
deleted_mark
firm.name
id
last_update
performed

Request Example

{
  "filters": [
    {
      "Field": "firm_id",
      "Operator": "In",
      "Value": "2"
    },
    {
      "Field": "account_sender.id",
      "Operator": "Equal",
      "Value": "7"
    },
    {
      "Field": "performed",
      "Operator": "Equal",
      "Value": "false"
    },
    {
      "Field": "amount_sended",
      "Operator": "GreaterOrEqual",
      "Value": "100000"
    }
  ],
  "sort_orders": [
    {
      "column": "date",
      "direction": "DESC"
    },
    {
      "column": "code",
      "direction": "ASC"
    }
  ],
  "limit": 50,
  "offset": 0
}

Response Parameters

Name Type Description
next_offset Int32 Offset for the next data page.
ok Boolean Indicates whether the request completed successfully.
result Array of DocAccountMovement Result array.
total Int64 Total number of result items.

Response Example

{
  "ok": true,
  "result": [
    {
      "id": 31,
      "code": "AMV-000031",
      "date": 1714550400,
      "firm": {
        "id": 2,
        "name": "REGOS Retail"
      },
      "account_sender": {
        "id": 7,
        "code": "CASH-01",
        "name": "Main cash",
        "currency": {
          "id": 1,
          "code_chr": "UZS",
          "name": "Uzbek sum",
          "exchange_rate": 1.00000000,
          "is_base": true
        }
      },
      "amount_sended": 100000.000,
      "account_receiver": {
        "id": 9,
        "code": "BANK-01",
        "name": "Main bank account",
        "currency": {
          "id": 1,
          "code_chr": "UZS",
          "name": "Uzbek sum",
          "exchange_rate": 1.00000000,
          "is_base": true
        }
      },
      "amount_received": 100000.000,
      "description": "Cash deposit to bank account",
      "attached_user": {
        "id": 5,
        "full_name": "Anna Smith"
      },
      "fields": [],
      "performed": false,
      "deleted_mark": false,
      "last_update": 1714553600
    }
  ],
  "next_offset": 0,
  "total": 1
}