# Phone Lookup

**Endpoint:** <mark style="color:yellow;">POST</mark> <https://irbis.espysys.com/api/developer/combined_phone>

Below is a sample request to perform a lookup using the API:

```
{
  "key": "YOUR_API_KEY",
  "value": "PHONE_NUMBER",
  "lookupId": "LOOKUPID_VALUE"
}
```

**Instructions:**

* Replace `YOUR_API_KEY` in the "key" field with your actual API Key.
* For the "value" field, insert the phone number you wish to search for, ensuring you include the country code. For example: `+79017007397`.

Ensure you make the necessary substitutions in the provided fields for accurate and successful search queries.

The  lookupId must be set to what is shown in table API lookups types at [Developer page](https://espyosint.ddns.net/developer) or at [API lookup types](/api-lookup-types.md) page

## Headers and Body

{% content-ref url="/pages/myrKXoq3JKi3zx4dKdVQ" %}
[Headers and Body Request  by Phone](/phone-lookup/headers-and-body-request-by-phone.md)
{% endcontent-ref %}

## GET Get lookup data for a request

{% content-ref url="/pages/QCUhftK8qm4QXzSjAAPN" %}
[GET Get lookup data for a request by Phone](/phone-lookup/get-get-lookup-data-for-a-request-by-phone.md)
{% endcontent-ref %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://api-docs.espysys.com/phone-lookup.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.