Look up contact

curl -X GET "https://api.mindosoftware.com/api/v1/contact-lookup/?phone=5492235961983" \
  -H "X-API-Key: mindo_xxxxxxxxxxxxxxxxxxxxxxxx"

import requests

response = requests.get(
    "https://api.mindosoftware.com/api/v1/contact-lookup/",
    params={"phone": "5492235961983"},
    headers={"X-API-Key": "mindo_xxxxxxxxxxxxxxxxxxxxxxxx"}
)

data = response.json()

if data["found"]:
    print(f"Contact: {data['contact']['fullName']}")
    print(f"Replied: {data['hasReplied']}")
    print(f"Window active: {data['sessionWindowActive']}")
else:
    print("Contact not found")

const response = await fetch(
  "https://api.mindosoftware.com/api/v1/contact-lookup/?phone=5492235961983",
  {
    headers: {
      "X-API-Key": "mindo_xxxxxxxxxxxxxxxxxxxxxxxx"
    }
  }
);

const data = await response.json();

if (data.found) {
  console.log("Contact:", data.contact.fullName);
  console.log("Replied:", data.hasReplied);
  console.log("Window active:", data.sessionWindowActive);
} else {
  console.log("Contact not found");
}

{
  "found": true,
  "contact": {
    "id": 123,
    "fullName": "Juan Perez",
    "phone": "+5492235961983",
    "email": "juan@ejemplo.com",
    "contactListId": 5,
    "contactListName": "Lista Principal",
    "source": "organic",
    "createdAt": "2025-01-15T10:30:00Z"
  },
  "hasReplied": true,
  "lastReplyAt": "2025-03-28T14:22:00Z",
  "sessionWindowActive": true,
  "sessionExpiresAt": "2025-03-29T14:22:00Z"
}

{
  "found": false,
  "contact": null,
  "hasReplied": false,
  "lastReplyAt": null,
  "sessionWindowActive": false,
  "sessionExpiresAt": null
}

{
  "error": "El parametro 'phone' es requerido"
}

{
  "error": "Este endpoint requiere autenticacion con API Key (header X-API-Key)"
}

GET

api

contact-lookup

curl -X GET "https://api.mindosoftware.com/api/v1/contact-lookup/?phone=5492235961983" \
  -H "X-API-Key: mindo_xxxxxxxxxxxxxxxxxxxxxxxx"

import requests

response = requests.get(
    "https://api.mindosoftware.com/api/v1/contact-lookup/",
    params={"phone": "5492235961983"},
    headers={"X-API-Key": "mindo_xxxxxxxxxxxxxxxxxxxxxxxx"}
)

data = response.json()

if data["found"]:
    print(f"Contact: {data['contact']['fullName']}")
    print(f"Replied: {data['hasReplied']}")
    print(f"Window active: {data['sessionWindowActive']}")
else:
    print("Contact not found")

const response = await fetch(
  "https://api.mindosoftware.com/api/v1/contact-lookup/?phone=5492235961983",
  {
    headers: {
      "X-API-Key": "mindo_xxxxxxxxxxxxxxxxxxxxxxxx"
    }
  }
);

const data = await response.json();

if (data.found) {
  console.log("Contact:", data.contact.fullName);
  console.log("Replied:", data.hasReplied);
  console.log("Window active:", data.sessionWindowActive);
} else {
  console.log("Contact not found");
}

{
  "found": true,
  "contact": {
    "id": 123,
    "fullName": "Juan Perez",
    "phone": "+5492235961983",
    "email": "juan@ejemplo.com",
    "contactListId": 5,
    "contactListName": "Lista Principal",
    "source": "organic",
    "createdAt": "2025-01-15T10:30:00Z"
  },
  "hasReplied": true,
  "lastReplyAt": "2025-03-28T14:22:00Z",
  "sessionWindowActive": true,
  "sessionExpiresAt": "2025-03-29T14:22:00Z"
}

{
  "found": false,
  "contact": null,
  "hasReplied": false,
  "lastReplyAt": null,
  "sessionWindowActive": false,
  "sessionExpiresAt": null
}

{
  "error": "El parametro 'phone' es requerido"
}

{
  "error": "Este endpoint requiere autenticacion con API Key (header X-API-Key)"
}

Description

This endpoint allows you to look up contact information by phone number. It returns contact data, whether they have replied to messages, and the WhatsApp session window status. It’s useful for conditional sending and automated follow-up workflows: before sending a follow-up, you can check if the contact has already replied and if the session window is active.

The endpoint returns 200 even if the contact doesn’t exist. Use the found field to verify existence.

Authentication header

string

required

Your Mindo API Key. Format: mindo_xxxxxxxxxxxxxxxxxxxxxxxx

Query parameters

string

required

Phone number to look up. The system automatically normalizes the number, so it accepts multiple formats (E.164 with or without +, with 15 for Argentina, with spaces or dashes).

Response (200 OK)

boolean

true if the contact exists in any company list.

object

Contact information. null if not found.

Show contact properties

integer

Internal contact ID.

string

Contact’s full name. Can be null.

string

Phone number in E.164 format.

string

Contact’s email. Can be null.

integer

ID of the contact list they belong to.

string

Name of the contact list.

string

Contact origin: manual, csv_import, organic, whatsapp_sync, instagram_sync, group, api, other. Can be null.

string (ISO 8601)

Contact creation date.

boolean

true if the contact has sent at least one message in any chat. Useful for follow-up logic: if false, the contact is a candidate for re-sending.

string (ISO 8601)

Date/time of the last message sent by the contact. null if they never replied.

boolean

true if there’s an active WhatsApp session window (24h since the user’s last message). If active, free-text messages can be sent; if not, only approved templates.

string (ISO 8601)

Expiration date/time of the active session window. null if there’s no active window.

curl -X GET "https://api.mindosoftware.com/api/v1/contact-lookup/?phone=5492235961983" \
  -H "X-API-Key: mindo_xxxxxxxxxxxxxxxxxxxxxxxx"

import requests

response = requests.get(
    "https://api.mindosoftware.com/api/v1/contact-lookup/",
    params={"phone": "5492235961983"},
    headers={"X-API-Key": "mindo_xxxxxxxxxxxxxxxxxxxxxxxx"}
)

data = response.json()

if data["found"]:
    print(f"Contact: {data['contact']['fullName']}")
    print(f"Replied: {data['hasReplied']}")
    print(f"Window active: {data['sessionWindowActive']}")
else:
    print("Contact not found")

const response = await fetch(
  "https://api.mindosoftware.com/api/v1/contact-lookup/?phone=5492235961983",
  {
    headers: {
      "X-API-Key": "mindo_xxxxxxxxxxxxxxxxxxxxxxxx"
    }
  }
);

const data = await response.json();

if (data.found) {
  console.log("Contact:", data.contact.fullName);
  console.log("Replied:", data.hasReplied);
  console.log("Window active:", data.sessionWindowActive);
} else {
  console.log("Contact not found");
}

{
  "found": true,
  "contact": {
    "id": 123,
    "fullName": "Juan Perez",
    "phone": "+5492235961983",
    "email": "juan@ejemplo.com",
    "contactListId": 5,
    "contactListName": "Lista Principal",
    "source": "organic",
    "createdAt": "2025-01-15T10:30:00Z"
  },
  "hasReplied": true,
  "lastReplyAt": "2025-03-28T14:22:00Z",
  "sessionWindowActive": true,
  "sessionExpiresAt": "2025-03-29T14:22:00Z"
}

{
  "found": false,
  "contact": null,
  "hasReplied": false,
  "lastReplyAt": null,
  "sessionWindowActive": false,
  "sessionExpiresAt": null
}

{
  "error": "El parametro 'phone' es requerido"
}

{
  "error": "Este endpoint requiere autenticacion con API Key (header X-API-Key)"
}

Accepted phone formats

The system automatically normalizes the number. All these formats are equivalent:

Format	Example
E.164 with `+`	`+5492235961983`
E.164 without `+`	`5492235961983`
With `15` (Argentina)	`+54223155961983`
With `15` without `+`	`54223155961983`
With spaces/dashes	`+54 223 15-596-1983`

For numbers outside Argentina, use E.164 format with country code.

Use case: Conditional follow-up

Automated follow-up workflow

Typical workflow for follow-up campaigns:

Send initial template via /api/v1/meta-templates/send/
Wait a period (e.g.: 24-48 hours)
Check status via /api/v1/contact-lookup/?phone=...
Decide action based on the response:
- found: false — Contact doesn’t exist, check the number
- hasReplied: true — Already replied, don’t send follow-up
- hasReplied: false + sessionWindowActive: true — Send free-text follow-up message
- hasReplied: false + sessionWindowActive: false — Send follow-up template

Python

import requests

API_KEY = "mindo_xxxxxxxxxxxxxxxxxxxxxxxx"
BASE_URL = "https://api.mindosoftware.com"

# Step 1: check contact status
lookup = requests.get(
    f"{BASE_URL}/api/v1/contact-lookup/",
    params={"phone": "5492235961983"},
    headers={"X-API-Key": API_KEY}
).json()

# Step 2: decide action
if not lookup["found"]:
    print("Contact doesn't exist in the platform")
elif lookup["hasReplied"]:
    print(f"Already replied on {lookup['lastReplyAt']}, skip follow-up")
else:
    print("Didn't reply, send follow-up")
    if lookup["sessionWindowActive"]:
        print("Window active: can send free-text message")
    else:
        print("Window expired: use template")

JavaScript

const API_KEY = "mindo_xxxxxxxxxxxxxxxxxxxxxxxx";
const BASE_URL = "https://api.mindosoftware.com";

// Step 1: check contact status
const response = await fetch(
  `${BASE_URL}/api/v1/contact-lookup/?phone=5492235961983`,
  { headers: { "X-API-Key": API_KEY } }
);
const lookup = await response.json();

// Step 2: decide action
if (!lookup.found) {
  console.log("Contact doesn't exist in the platform");
} else if (lookup.hasReplied) {
  console.log(`Already replied on ${lookup.lastReplyAt}, skip follow-up`);
} else {
  console.log("Didn't reply, send follow-up");
  if (lookup.sessionWindowActive) {
    console.log("Window active: can send free-text message");
  } else {
    console.log("Window expired: use template");
  }
}

Get started

Business accounts

Business info

Messages

Contacts

Bulk sending

Qualitative export

Description

Authentication header

Query parameters

Response (200 OK)

Accepted phone formats

Use case: Conditional follow-up

​Description

​Authentication header

​Query parameters

​Response (200 OK)

​Accepted phone formats

​Use case: Conditional follow-up

Description

Authentication header

Query parameters

Response (200 OK)

Accepted phone formats

Use case: Conditional follow-up