Skip to main content

LeadDTO

CRM Lead information object. Returned by GET /v1/open-api/lead/{leadId}.

idint64

Lead ID

Example: 1001
namestring

Lead name

Example: New apartment buyer
balancedouble

Balance amount

Example: 5000
currencyIdint32

Currency ID

Example: 1
responsibleByIdint32

Responsible user ID

Example: 101
responsibleBystring

Responsible user full name

Example: Alice Johnson
pipeStatusIdint64

Lead pipeline status ID

Example: 1
tagsstring[]

Tags attached to lead.

Example: ["VIP","New"]
fields object[]

Additional field values.

  • Array [
    • idint64

    Field ID this value belongs to

    Example: 1
    valuestring

    Simple value (as text)

    Example: VIP
    valueListstring[]

    Multiple values (for multi-select fields).

    Example: ["VIP","New"]
    valueTypeValueType

    Field value type enum.

    Possible values: [STREET, DISTRICT, DEFAULT]

    Default value: DEFAULT
    Example: DEFAULT
    typestring

    Field type (lowercased, e.g. text, select)

    Example: select
    infoTypeInfoType

    Which entity a field/value belongs to.

    • LED — the lead
    • CONTACT — the contact

    Possible values: [LED, CONTACT]

    Example: LED
    longitudedouble

    Geo coordinate: longitude (for location fields)

    Example: 69.2401
    latitudedouble

    Geo coordinate: latitude (for location fields)

    Example: 41.2995
    numbernumber

    Value for NUMBER fields. Populated instead of value.

    Example: 1500.5
    currencyIdint64

    Currency ID, present when the NUMBER field's format is CURRENCY.

    Example: 24
  • ]
    • contacts object[]

    Contacts attached to lead.

  • Array [
    • idint64

    Contact ID (null when creating)

    Example: 1001
    namestringrequired

    Contact name (required)

    Example: John Doe
    fields object[]

    Contact custom field values.

  • Array [
    • idint64

    Field ID this value belongs to

    Example: 1
    valuestring

    Simple value (as text)

    Example: VIP
    valueListstring[]

    Multiple values (for multi-select fields).

    Example: ["VIP","New"]
    valueTypeValueType

    Field value type enum.

    Possible values: [STREET, DISTRICT, DEFAULT]

    Default value: DEFAULT
    Example: DEFAULT
    typestring

    Field type (lowercased, e.g. text, select)

    Example: select
    infoTypeInfoType

    Which entity a field/value belongs to.

    • LED — the lead
    • CONTACT — the contact

    Possible values: [LED, CONTACT]

    Example: LED
    longitudedouble

    Geo coordinate: longitude (for location fields)

    Example: 69.2401
    latitudedouble

    Geo coordinate: latitude (for location fields)

    Example: 41.2995
    numbernumber

    Value for NUMBER fields. Populated instead of value.

    Example: 1500.5
    currencyIdint64

    Currency ID, present when the NUMBER field's format is CURRENCY.

    Example: 24
  • ]
    • typeContactType

    Contact type enum.

    Possible values: [SIMPLE, TELEGRAM, INSTAGRAM, WEBSITE, FACEBOOK, OTHER, CALL_PBX, MARKETPLACE, GOOGLE_SHEETS, WEB_FORM, WAZZUP, AMO_CRM, TELEGRAM_BUSINESS]

    Default value: SIMPLE
    Example: TELEGRAM
    accountIdstring

    Account ID (if available)

    Example: acc123
    usernamestring

    Username

    Example: johndoe
    phonesstring[]required

    Phone numbers (required, non-empty).

    Possible values: >= 1

    Example: ["+998901234567"]
    receiverIdstring

    Receiver ID (if available)

    Example: rec123
  • ]
    • createdTimestampint64

    Creation time (epoch seconds)

    Example: 1672531200
    updatedTimestampint64

    Last update time (epoch seconds)

    Example: 1672704000
    uuiduuid

    Lead UUID value

    Example: 550e8400-e29b-41d4-a716-446655440000
    attributions object[]

    Channel / UTM attributions, in attachment order (earliest first).

  • Array [
    • idint64

    Attribution ID

    Example: 5001
    channel object

    Channel a lead originated from.

    idint64

    Channel ID

    Example: 12
    sourceLeadChannelSource

    Channel a lead originated from. Serialized by name.

    Possible values: [INSTAGRAM, FACEBOOK, FACEBOOK_FORM, TELEGRAM, TELEGRAM_BUSINESS, TELEGRAM_BOT, WHATSAPP, WABA, VK, VIBER, AVITO, WEBSITE, AMO_CRM, ONLINE_PBX, UTEL, SIPUNI, ASTERISK, MOI_ZVONKI, WEB_FORM, EMPLOYEE, UNKNOWN]

    Example: INSTAGRAM
    channelValuestring

    Free-text channel identifier

    Example: ig-promo-2026
    utmData object

    UTM / tracking attribution data attached to a lead.

    utmSourcestring

    UTM source

    Example: instagram
    utmMediumstring

    UTM medium

    Example: cpc
    utmCampaignstring

    UTM campaign

    Example: spring_sale
    utmTermstring

    UTM term

    Example: apartment
    utmContentstring

    UTM content

    Example: banner_a
    fbcLidstring

    Facebook click ID (fbclid)

    Example: IwAR0...
    fbClientIpAddressstring

    Client IP address (Facebook CAPI)

    Example: 203.0.113.5
    fbClientUserAgentstring

    Client user agent (Facebook CAPI)

    Example: Mozilla/5.0 ...
    fbpstring

    Facebook browser ID (_fbp cookie)

    Example: fb.1.1672531200.1234567890
    attachedTimestampint64

    Time the attribution was attached (epoch seconds)

    Example: 1672531200
  • ]
    • LeadDTO
    {
      "id": 1001,
      "name": "New apartment buyer",
      "balance": 5000,
      "currencyId": 1,
      "responsibleById": 101,
      "responsibleBy": "Alice Johnson",
      "pipeStatusId": 1,
      "tags": [
        "VIP",
        "New"
      ],
      "fields": [
        {
          "id": 1,
          "value": "VIP",
          "valueList": [
            "VIP",
            "New"
          ],
          "valueType": "DEFAULT",
          "type": "select",
          "infoType": "LED",
          "longitude": 69.2401,
          "latitude": 41.2995,
          "number": 1500.5,
          "currencyId": 24
        }
      ],
      "contacts": [
        {
          "id": 1001,
          "name": "John Doe",
          "fields": [
            {
              "id": 1,
              "value": "VIP",
              "valueList": [
                "VIP",
                "New"
              ],
              "valueType": "DEFAULT",
              "type": "select",
              "infoType": "LED",
              "longitude": 69.2401,
              "latitude": 41.2995,
              "number": 1500.5,
              "currencyId": 24
            }
          ],
          "type": "TELEGRAM",
          "accountId": "acc123",
          "username": "johndoe",
          "phones": [
            "+998901234567"
          ],
          "receiverId": "rec123"
        }
      ],
      "createdTimestamp": 1672531200,
      "updatedTimestamp": 1672704000,
      "uuid": "550e8400-e29b-41d4-a716-446655440000",
      "attributions": [
        {
          "id": 5001,
          "channel": {
            "id": 12,
            "source": "INSTAGRAM",
            "channelValue": "ig-promo-2026"
          },
          "utmData": {
            "utmSource": "instagram",
            "utmMedium": "cpc",
            "utmCampaign": "spring_sale",
            "utmTerm": "apartment",
            "utmContent": "banner_a",
            "fbcLid": "IwAR0...",
            "fbClientIpAddress": "203.0.113.5",
            "fbClientUserAgent": "Mozilla/5.0 ...",
            "fbp": "fb.1.1672531200.1234567890"
          },
          "attachedTimestamp": 1672531200
        }
      ]
    }