# Method: contacts.getContacts

Back to methods index

Returns the current user’s contact list.

# Parameters:

Name Type Description Required
hash Array of int If there already is a full contact list on the client, a hash of a the list of contact IDs in ascending order may be passed in this parameter. If the contact set was not changed, (contacts.contactsNotModified) will be returned. Optional

# Return type: contacts.Contacts

# Can bots use this method: NO

# MadelineProto Example (now async for huge speed and parallelism!):

if (!file_exists('madeline.php')) {
    copy('https://phar.madelineproto.xyz/madeline.php', 'madeline.php');
include 'madeline.php';

$MadelineProto = new \danog\MadelineProto\API('session.madeline');

$contacts_Contacts = $MadelineProto->contacts->getContacts(['hash' => [int, int], ]);

Or, if you’re into Lua:

contacts_Contacts = contacts.getContacts({hash={int}, })

# Errors

Code Type Description
406 AUTH_KEY_DUPLICATED An auth key with the same ID was already generated
401 SESSION_PASSWORD_NEEDED 2FA is enabled, use a password to login
This site uses cookies, as described in the cookie policy. By clicking on "Accept" you consent to the use of cookies.