> ## 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.

# Presence Probe

> Gets the latest presence issued by a contact in your roster who has approved your presence subscription request.
Note: The result to the presence probe request will give you the latest Full JID published by the contact.

## Overview

Gets the latest presence issued by a contact in your roster who has approved your presence subscription request.

Note: The result to the presence probe request will give you the latest Full JID published by the contact. This Full JID can be used to make directed information queries to the contact.

Security Note: You are only allowed to send a presence probe to contacts that have approved a presence subscription from you.

Note 2: If you request the presence of an entity to which you do not have a presence subscription, one will be sent automatically. If you want to send custom XML in the presence subscription request, you should call SendPresenceSubscription.md first.

## Authentication

Requires a valid JWT bearer token.

## Notes

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


## OpenAPI

````yaml /test-api/openapi.yaml post /Agent/Xmpp/PresenceProbe
openapi: 3.1.0
info:
  title: Neuron Agent API
  version: 1.0.0
  description: |-
    The Agent API exposes core Neuron functionality over HTTP so services can
    operate without a persistent XMPP connection. Endpoints are grouped by
    capability, starting with Accounts and XMPP messaging.
servers:
  - url: https://{host}
    variables:
      host:
        default: neuron.example.com
        description: Neuron domain issued to you.
security:
  - bearerAuth: []
tags:
  - name: Accounts
  - name: Crypto
  - name: Open intelligence
  - name: Legal and contracts
  - name: State machines
  - name: Storage
  - name: Tokens
  - name: Wallet
  - name: XMPP messaging
paths:
  /Agent/Xmpp/PresenceProbe:
    post:
      tags:
        - XMPP messaging
      summary: Presence Probe
      description: >-
        Gets the latest presence issued by a contact in your roster who has
        approved your presence subscription request.

        Note: The result to the presence probe request will give you the latest
        Full JID published by the contact.
      operationId: post_Agent_Xmpp_PresenceProbe
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                to:
                  type: string
              additionalProperties: true
              required:
                - to
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  jid:
                    type: string
                  type:
                    type: string
                  received:
                    type: string
                    format: date-time
                  Stanza:
                    type: object
                    additionalProperties: true
                additionalProperties: true
                required:
                  - jid
                  - type
                  - received
                  - Stanza
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````