https://business.me-mate.net/api/betav3/tagmanage/tag/fetchContactsTagWise

Purpose

Fetch contacts filtered tag-wise for the authenticated account. This endpoint returns the list of contacts associated with one or more tag IDs.

Endpoint

POST https://business.me-mate.net/api/betav3/tagmanage/tag/fetchContactsTagWise

Required variables

This request uses the following Postman variable(s):

• {{api_key}} (required): Your API key.

Ensure api_key is defined in the active scope (environment/collection/global) before sending.

Headers

• X-Requested-With: XMLHttpRequest

Request body (JSON)

Content-Type: application/json

Fields:

• api_key (string, required): API key value. In this collection it is typically set as "{{api_key}}".

• tags (array, required): List of tag IDs to filter by.

Example body:

{
  "api_key": "{{api_key}}",
  "tags": [226, 227]
}

Example request (placeholder)

curl --location 'https://business.me-mate.net/api/betav3/tagmanage/tag/fetchContactsTagWise' \
  --header 'X-Requested-With: XMLHttpRequest' \
  --header 'Content-Type: application/json' \
  --data '{
    "api_key": "<YOUR_API_KEY>",
    "tags": [226, 227]
  }'

Example success response (placeholder)

Response shape can vary by account and tag configuration.

{
  "success": true,
  "data": [
    {
      "contact_id": "<string|number>",
      "name": "<string>",
      "phone": "<string>",
      "email": "<string>",
      "tags": [226, 227]
    }
  ],
  "message": "<string>"
}

Common error cases

• 400 Bad Request

  • Missing required fields (api_key, tags)

  • tags is not an array or contains invalid IDs

• 401 Unauthorized / 403 Forbidden

  • Invalid/expired API key (api_key)

  • API key not permitted to access the requested resource

• 422 Unprocessable Entity

  • Validation errors for body fields (implementation dependent)

• 500 Internal Server Error

  • Unexpected server-side failure

Troubleshooting

• Confirm {{api_key}} resolves to a non-empty value (use the eye icon next to variables in Postman).

• Ensure tags contains numeric tag IDs that exist for the account.

• If you receive auth errors, re-check the active environment and the api_key variable value.