LeadTaskResponseDTO

Lead task information object — returned by POST /v1/open-api/lead-task/filter and, as the task payload, on LEAD_TASK/LEAD_TASK_OVERDUE lead history records. The flat leadTaskTypeId/leadTaskTypeName/assignedById/closedById fields shipped in an earlier release and are kept for existing integrators, but are superseded by leadTaskType/assignedBy/closedBy.

idint64

Lead task ID

Example: 501

leadIdint64nullable

Lead ID the task belongs to

Example: 34606

leadNamestringnullable

Lead name

Example: New apartment buyer

leadTaskType objectnullable

Task type. Superset of the deprecated leadTaskTypeId/leadTaskTypeName.

idint64

Task type ID

Example: 7

namestringnullable

Task type name

Example: Call

iconstringnullable

Task type icon — a Material Icons code

Example: call

textstringnullable

Task text

Example: Call the client

statusLeadTaskStatus

Lead task status enum.

• OPEN — Open
• SUCCESS — Closed successfully
• FAILED — Closed with failure
• DELETED — Deleted

Possible values: [OPEN, SUCCESS, FAILED, DELETED]

Example: OPEN

assignedBy objectnullable

Assignee employee. Matches assignedByIds in the filter.

idint32

Employee ID

Example: 201

fullNamestring

Employee full name

Example: David Wilson

createdBy objectnullable

Employee who created the task. Matches createdByIds in the filter.

idint32

Employee ID

Example: 201

fullNamestring

Employee full name

Example: David Wilson

closedBy objectnullable

Employee who closed the task.

idint32

Employee ID

Example: 201

fullNamestring

Employee full name

Example: David Wilson

deletedBy objectnullable

Employee who deleted the task.

idint32

Employee ID

Example: 201

fullNamestring

Employee full name

Example: David Wilson

createdTimestampint64

Creation time (epoch seconds)

Example: 1732924800

deadlineStartTimestampint64

Task deadline start (epoch seconds, 0 if not set)

Example: 1730419200

deadlineFinishTimestampint64

Task deadline finish (epoch seconds, 0 if not set)

Example: 1733011200

closedTimestampint64nullable

Close time (epoch seconds, null if open).

Example: 1731000000

closedTextstringnullable

Close note.

deletedTimestampint64nullable

Deletion time (epoch seconds), null if not deleted.

deletedboolean

Boolean form of deletedTimestamp.

Example: false

fields object[]nullable

The task's custom field values — see GET /v1/open-api/lead-task-field for the field definitions. null when the caller did not load them (the lead-history path).

Array [

fieldIdint64

Field ID

Example: 91

valuestringnullable

Custom field value, resolved per type (e.g. ADDRESS → full address JSON, LOCATION → left in latitude/longitude instead).

Example: Phone

namestringnullable

Custom field name

Example: Contact method

typeCustomFieldType

Custom field type, shared by every custom-field family (contract, flat, payment and lead task). Serialized by name. Identical value set to ContractFieldType, which remains as the contract-family alias.

Possible values: [TEXT, EXTENDED_TEXT, DATE, SELECT, MULTI_SELECT, RADIO, TOGGLE_SWITCH, URL, TAG, LOCATION, COUNTER, ADDRESS, EMPLOYEE, FILE, NUMBER]

Example: SELECT

requiredbooleannullable

Whether value is mandatory

sortOrderint32nullable

Display order

numberdoublenullable

Numeric value — only for type: NUMBER.

currencyIdint32nullable

Currency ID — only for type: NUMBER.

valuesstring[]

Ordered list of values for multi-row types (MULTI_SELECT/EMPLOYEE). Always an array, empty when not applicable.

Example: []

latitudedoublenullable

Latitude — only for type: LOCATION.

longitudedoublenullable

Longitude — only for type: LOCATION.

files object[]

Attached files — only for type: FILE. Always an array, empty when not applicable.

Array [

absolutePathstringnullable

Presigned URL to the full-size file

Example: https://minio.uysot.uz/uysot/files/201/avatar.png?X-Amz-Expires=3600

thumbAbsolutePathstringnullable

Presigned URL to the thumbnail rendition

Example: https://minio.uysot.uz/uysot/files/201/avatar_thumb.png?X-Amz-Expires=3600

smallestAbsolutePathstringnullable

Presigned URL to the smallest rendition

Example: https://minio.uysot.uz/uysot/files/201/avatar_small.png?X-Amz-Expires=3600

]

]

leadTaskTypeIdint64nullabledeprecated

Deprecated — use leadTaskType.id instead.

Example: 7

leadTaskTypeNamestringnullabledeprecated

Deprecated — use leadTaskType.name instead.

Example: Call

assignedByIdint32nullabledeprecated

Deprecated — use assignedBy.id instead.

Example: 95

closedByIdint32nullabledeprecated

Deprecated — use closedBy.id instead.

LeadTaskResponseDTO

{
  "id": 501,
  "leadId": 34606,
  "leadName": "New apartment buyer",
  "leadTaskType": {
    "id": 7,
    "name": "Call",
    "icon": "call"
  },
  "text": "Call the client",
  "status": "OPEN",
  "assignedBy": {
    "id": 201,
    "fullName": "David Wilson"
  },
  "createdBy": {
    "id": 201,
    "fullName": "David Wilson"
  },
  "closedBy": {
    "id": 201,
    "fullName": "David Wilson"
  },
  "deletedBy": {
    "id": 201,
    "fullName": "David Wilson"
  },
  "createdTimestamp": 1732924800,
  "deadlineStartTimestamp": 1730419200,
  "deadlineFinishTimestamp": 1733011200,
  "closedTimestamp": 1731000000,
  "closedText": "string",
  "deletedTimestamp": 0,
  "deleted": false,
  "fields": [
    {
      "fieldId": 91,
      "value": "Phone",
      "name": "Contact method",
      "type": "SELECT",
      "required": true,
      "sortOrder": 0,
      "number": 0,
      "currencyId": 0,
      "values": [],
      "latitude": 0,
      "longitude": 0,
      "files": []
    }
  ]
}