> ## Documentation Index
> Fetch the complete documentation index at: https://docs.neuro-tech.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Information query

## Overview

Sends an Information Query (iq) to an entity on the XMPP network, given its Full JID. For connected entities, you need to have a presence subscription to that entity, approved by the entity, to get the Full JID. You get the Full JID using the [Presence probe](/neuron-api/api-reference/messaging/presence-probe) resource.

## HTTP request

`POST /Agent/Xmpp/InformationQuery`

## Authentication

Requires a valid JWT bearer token.

## Request (JSON)

```json theme={null}
{
	"to":Required(Str(PTo)),
	"type":Required(Str(PType)),
	"xml":Required(Xml(PQuery))
}
```

## Input parameters

| Parameter | Description                                                             |
| --------- | ----------------------------------------------------------------------- |
| PTo       | Bare JID of contact to whom the presence probe is directed.             |
| PType     | Type of Information Query. Must be get or set.                          |
| PQuery    | Valid XML (or string-representation of valid XML) of the query to send. |

## Response (JSON)

```json theme={null}
{
	"ok": Required(Boolean(POk)),
	"errorCode": Optional(Int(PErrorCode)),
	"errorText": Optional(Str(PErrorText)),
	"errorType": Optional(Str(PErrorType)),
	"ErrorElement": Optional(PErrorElement),
	"Stanza": Optional(PStanza)
}
```

## Response parameters

| Parameter  | Description                                         |
| ---------- | --------------------------------------------------- |
| POk        | If query executed without error.                    |
| PErrorCode | Optional error code, in case an error was returned. |
| PErrorText | Optional error text, in case an error was returned. |
| PErrorType | Optional error type, in case an error was returned. |
| PContent   | Any XML content returned in the query result.       |

## Notes

This endpoint uses the request schema notation described in [Pattern matching](/neuron-api/pattern-matching).