GetShort

[POST] .../v1/doccontract/getshort

Returns short contract information. Use this method when only compact contract header data is needed, for example for dropdowns, document links or validation before attaching files. The response returns paged DocContractShort records with next_offset and total; the short query applies id, partner_id, firm_id, direction, active and date filters. search, deleted_mark, attached_user_id and sort_orders parameters are not applied by the short SQL path. The contract tariff parameter must be enabled and the current request user must have contract select permission. Missing body, denied access, unavailable tariff, invalid database state, database failures and other business errors are returned as HTTP 200 ErrorResult responses.

Request Parameters

Name Type Required Description
filters Array of Filter Optional Optional filters by fields available for this API method.
limit Int32 Optional Maximum number of records to return. Default and maximum values are defined by server settings.
offset Int32 Optional Offset from the beginning of the result set.
search String Optional Search string for code, partner name, partner TIN, firm name and responsible user name.
sort_orders Array of DocContractColumn Optional Output parameter sorting.

Filterable Fields

Field Type Description
active bool Validity flag: true - valid, false - invalid.
date int
direction string Contract direction: Income or Outcome.
end_date int Period end date as Unix time in seconds.
firm_id int Company IDs.
id int Contract IDs.
partner_id int Partner IDs.
start_date int Period start date as Unix time in seconds.

Sortable Fields

Field
amount
code
currency.name
date
direction
end_date
firm.name
partner.name
start_date

Request Example

{
  "filters": [
    {
      "field": "id",
      "operator": "Equal",
      "value": "9101"
    },
    {
      "field": "active",
      "operator": "Equal",
      "value": "true"
    }
  ],
  "limit": 20,
  "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 DocContractShort Result array.
total Int64 Total number of result items.

Response Example

{
  "ok": true,
  "result": [
    {
      "id": 9101,
      "code": "CNT-2026-02",
      "name": "January supply contract",
      "date": 1767225600,
      "start_date": 1767225600,
      "end_date": 1798761600,
      "partner_id": 201,
      "partner_name": "City Retail LLC",
      "firm_id": 11,
      "direction": "Income",
      "currency_id": 1,
      "amount": 25000,
      "details": "Payment within 15 banking days",
      "description": "Primary 2026 supply contract",
      "attached_user_id": 7,
      "active": true,
      "deleted_mark": false,
      "last_update": 1767225600
    }
  ],
  "next_offset": 0,
  "total": 1
}