View as Markdown
## 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: ``` json { "api_key": "{{api_key}}", "tags": [226, 227] } ``` ## Example request (placeholder) ``` bash 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. ``` json { "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.

Headers

X-Requested-WithstringOptional

Request

This endpoint expects a string.

Response

OK