Get a List of Contacts crm.contact.list

curl -X POST \
        -H "Content-Type: application/json" \
        -H "Accept: application/json" \
        -d '{"FILTER":{"SOURCE_ID":"CRM_FORM","!=NAME":"","!=LAST_NAME":"","=%NAME":"I%","=%LAST_NAME":"I%","EMAIL":"special-for@example.com","@ASSIGNED_BY_ID":[1,6],"IMPORT":"Y",">=DATE_CREATE":"**put_six_month_ago_date_here**"},"ORDER":{"LAST_NAME":"ASC","NAME":"ASC"},"SELECT":["ID","NAME","LAST_NAME","EMAIL","EXPORT","ASSIGNED_BY_ID","DATE_CREATE"],"auth":"**put_access_token_here**"}' \
        https://**put_your_bitrix24_address**/rest/crm.contact.list
        

// This snippet is an ES module: top-level await requires type="module" or a bundler.
        // $b24 is an already-initialized SDK instance (see the SDK "Get started" guide).
        import { Text } from '@bitrix24/b24jssdk'
        import type { B24Frame, ISODate } from '@bitrix24/b24jssdk'
        
        declare const $b24: B24Frame
        
        // Shape of each contact object returned in result[]
        type CrmContactListItem = {
          ID: string
          NAME: string
          LAST_NAME: string
          EXPORT: string
          ASSIGNED_BY_ID: string
          DATE_CREATE: ISODate | null
          EMAIL?: CrmContactEmail[]
        }
        
        type CrmContactEmail = {
          ID: string
          VALUE_TYPE: string
          VALUE: string
          TYPE_ID: string
        }
        
        const sixMonthAgo = new Date()
        sixMonthAgo.setMonth(new Date().getMonth() - 6)
        
        try {
          // crm.contact.list returns a single page (max 50 records). For the whole result set
          // use a list helper: $b24.actions.v2.callList.make() returns every record as one
          // array, $b24.actions.v2.fetchList.make() yields them in chunks (async generator).
          // NOTE: the list helpers do not accept `order` (it is excluded from their params, so
          // passing it is a TS error) — keep this call.make + `start` variant when sort matters.
          const response = await $b24.actions.v2.call.make<CrmContactListItem[]>({
            method: 'crm.contact.list',
            params: {
              filter: {
                SOURCE_ID: 'CRM_FORM',
                '!=NAME': '',
                '!=LAST_NAME': '',
                '=%NAME': 'J%',
                '=%LAST_NAME': 'J%',
                EMAIL: 'special-for@example.com',
                '@ASSIGNED_BY_ID': [1, 6],
                IMPORT: 'Y',
                '>=DATE_CREATE': sixMonthAgo.toISOString(),
              },
              order: {
                LAST_NAME: 'ASC',
                NAME: 'ASC',
              },
              select: [
                'ID',
                'NAME',
                'LAST_NAME',
                'EMAIL',
                'EXPORT',
                'ASSIGNED_BY_ID',
                'DATE_CREATE',
              ],
              start: 0,
            },
            requestId: Text.getUuidRfc4122()
          })
        
          // The payload is available only on a successful response
          if (!response.isSuccess) {
            console.error(response.getErrorMessages().join('; '))
          } else {
            const result = response.getData()!.result
            console.info('Contacts on this page:', result.length, result)
          }
        } catch (error) {
          // Thrown on transport or SDK failures (AjaxError, SdkError, etc.)
          console.error(error)
        }
        

<!-- Load the SDK (UMD build); it is exposed as the global B24Js -->
        <script src="https://unpkg.com/@bitrix24/b24jssdk@1/dist/umd/index.min.js"></script>
        <script>
          async function listContacts() {
            try {
              // Initialize the SDK inside a Bitrix24 frame
              const $b24 = await B24Js.initializeB24Frame()
        
              const sixMonthAgo = new Date()
              sixMonthAgo.setMonth(new Date().getMonth() - 6)
        
              // crm.contact.list returns a single page (max 50 records). For the whole result set
              // use a list helper: $b24.actions.v2.callList.make() returns every record as one
              // array, $b24.actions.v2.fetchList.make() yields them in chunks (async generator).
              // NOTE: the list helpers do not accept `order` (it is excluded from their params, so
              // passing it is a TS error) — keep this call.make + `start` variant when sort matters.
              const response = await $b24.actions.v2.call.make({
                method: 'crm.contact.list',
                params: {
                  filter: {
                    SOURCE_ID: 'CRM_FORM',
                    '!=NAME': '',
                    '!=LAST_NAME': '',
                    '=%NAME': 'J%',
                    '=%LAST_NAME': 'J%',
                    EMAIL: 'special-for@example.com',
                    '@ASSIGNED_BY_ID': [1, 6],
                    IMPORT: 'Y',
                    '>=DATE_CREATE': sixMonthAgo.toISOString(),
                  },
                  order: {
                    LAST_NAME: 'ASC',
                    NAME: 'ASC',
                  },
                  select: [
                    'ID',
                    'NAME',
                    'LAST_NAME',
                    'EMAIL',
                    'EXPORT',
                    'ASSIGNED_BY_ID',
                    'DATE_CREATE',
                  ],
                  start: 0,
                },
                requestId: B24Js.Text.getUuidRfc4122()
              })
        
              // The payload is available only on a successful response
              if (!response.isSuccess) {
                console.error(response.getErrorMessages().join('; '))
                return
              }
        
              const result = response.getData().result
              console.info('Contacts on this page:', result.length, result)
            } catch (error) {
              // Thrown on transport or SDK failures (AjaxError, SdkError, etc.)
              console.error(error)
            }
          }
        
          document.addEventListener('DOMContentLoaded', listContacts)
        </script>
        

try {
            $sixMonthAgo = new DateTime();
            $sixMonthAgo->setDate((new DateTime())->getMonth() - 6);
        
            $response = $b24Service
                ->core
                ->call(
                    'crm.contact.list',
                    [
                        'filter' => [
                            'SOURCE_ID'      => 'CRM_FORM',
                            '!=NAME'         => '',
                            '!=LAST_NAME'    => '',
                            '=%NAME'         => 'I%',
                            '=%LAST_NAME'    => 'I%',
                            'EMAIL'          => 'special-for@example.com',
                            '@ASSIGNED_BY_ID' => [1, 6],
                            'IMPORT'         => 'Y',
                            '>=DATE_CREATE'  => $sixMonthAgo->format('Y-m-d\TH:i:s'),
                        ],
                        'order'  => [
                            'LAST_NAME' => 'ASC',
                            'NAME'      => 'ASC',
                        ],
                        'select' => [
                            'ID',
                            'NAME',
                            'LAST_NAME',
                            'EMAIL',
                            'EXPORT',
                            'ASSIGNED_BY_ID',
                            'DATE_CREATE',
                        ],
                    ]
                );
        
            $result = $response
                ->getResponseData()
                ->getResult();
        
            if ($result->error()) {
                error_log($result->error());
            } else {
                echo 'Success: ' . print_r($result->data(), true);
            }
        
        } catch (Throwable $e) {
            error_log($e->getMessage());
            echo 'Error fetching contact list: ' . $e->getMessage();
        }
        

const sixMonthAgo = new Date();
        sixMonthAgo.setMonth((new Date()).getMonth() - 6);
        
        BX24.callMethod(
            'crm.contact.list',
            {
                filter: {
                    "SOURCE_ID": "CRM_FORM",
                    "!=NAME": "",
                    "!=LAST_NAME": "",
                    "=%NAME": "I%",
                    "=%LAST_NAME": "I%",
                    "EMAIL": "special-for@example.com",
                    "@ASSIGNED_BY_ID": [1, 6],
                    "IMPORT": "Y",
                    ">=DATE_CREATE": sixMonthAgo.toISOString(),
                },
                order: {
                    LAST_NAME: "ASC",
                    NAME: "ASC",
                },
                select: [
                    "ID",
                    "NAME",
                    "LAST_NAME",
                    "EMAIL",
                    "EXPORT",
                    "ASSIGNED_BY_ID",
                    "DATE_CREATE",
                ],
            },
            (result) => {
                result.error()
                    ? console.error(result.error())
                    : console.info(result.data())
                ;
            },
        );
        

require_once('crest.php');
        
        $sixMonthAgo = new DateTime();
        $sixMonthAgo->modify('-6 months');
        
        $result = CRest::call(
            'crm.contact.list',
            [
                'FILTER' => [
                    'SOURCE_ID' => 'CRM_FORM',
                    '!=NAME' => '',
                    '!=LAST_NAME' => '',
                    '=%NAME' => 'I%',
                    '=%LAST_NAME' => 'I%',
                    'EMAIL' => 'special-for@example.com',
                    '@ASSIGNED_BY_ID' => [1, 6],
                    'IMPORT' => 'Y',
                    '>=DATE_CREATE' => $sixMonthAgo->format(DateTime::ATOM),
                ],
                'ORDER' => [
                    'LAST_NAME' => 'ASC',
                    'NAME' => 'ASC',
                ],
                'SELECT' => [
                    'ID',
                    'NAME',
                    'LAST_NAME',
                    'EMAIL',
                    'EXPORT',
                    'ASSIGNED_BY_ID',
                    'DATE_CREATE',
                ]
            ]
        );
        
        echo '<PRE>';
        print_r($result);
        echo '</PRE>';
        

// client and ctx are already created — see the Go SDK section
        res, err := client.Core().Call(ctx, "crm.contact.list", b24.Params{
        	"filter": b24.Params{
        		"SOURCE_ID":       "CRM_FORM",
        		"!=NAME":          "",
        		"!=LAST_NAME":     "",
        		"=%NAME":          "K%",
        		"=%LAST_NAME":     "W%",
        		"EMAIL":           "special-for@example.com",
        		"@ASSIGNED_BY_ID": []int{1, 6},
        		"IMPORT":          "Y",
        		">=DATE_CREATE":   "**put_six_month_ago_date_here**",
        	},
        	"order": b24.Params{
        		"LAST_NAME": "ASC",
        		"NAME":      "ASC",
        	},
        	"select": []string{"ID", "NAME", "LAST_NAME", "EMAIL", "EXPORT", "ASSIGNED_BY_ID", "DATE_CREATE"},
        }, b24.WithIdempotent())
        if err != nil {
        	return fmt.Errorf("crm.contact.list: %w", err)
        }
        
        var items []struct {
        	ID           b24.ID `json:"ID"`
        	Name         string `json:"NAME"`
        	LastName     string `json:"LAST_NAME"`
        	Export       string `json:"EXPORT"`
        	AssignedByID b24.ID `json:"ASSIGNED_BY_ID"`
        	DateCreate   string `json:"DATE_CREATE"`
        }
        if err := json.Unmarshal(res.Result, &items); err != nil {
        	return fmt.Errorf("parse response: %w", err)
        }
        for _, it := range items {
        	fmt.Println(it.ID, it.Name)
        }
        
        // Total and Next are filled in by list methods; for a full
        // list traversal, use client.Core().Pages and Scan.
        if res.Total != nil {
        	fmt.Println("total:", *res.Total)
        }