Evolution API Plus icon

Evolution API Plus

Interact with Evolution API

Chat → Listar Contatos

AI-generated

Summary

List contacts from a specified Evolution API Plus chat instance, either retrieving all contacts or a specific contact by their remote JID.

Inputs

  • Nome Da Instância (required) — Specify the name of the Evolution API Plus instance from which to list contacts.
  • Listar Todos (required) — Choose whether to list all contacts (true) or to provide a specific contact to retrieve (false).
  • Contato — If not listing all, provide the remote JID (contact number) of the specific contact to retrieve.

Output shape

a list of contact records or a single contact record, depending on selection; returned as JSON objects

If 'Listar Todos' is true, the operation returns all contacts for the instance. If false, it returns details only for the specified 'Contato'. The output shape depends on the API response and may include contact metadata.

Examples

Example 1: To retrieve all contacts in an instance

Set 'Nome Da Instância' to your instance name and 'Listar Todos' to true.

Example 2: To retrieve a specific contact's information

Set 'Nome Da Instância' to your instance name, 'Listar Todos' to false, and specify the contact's remote JID in 'Contato'.

Links

Discussion