> ## Documentation Index
> Fetch the complete documentation index at: https://devzone.nayax.com/llms.txt
> Use this file to discover all available pages before exploring further.

# InfoQuery

Nayax sends an `InfoQuery` API after a successful `StartSession`
response. Its main purposes are to retrieve information to be shown on
the POS device before payment begins and to check the availability
status of the requested service station.


## OpenAPI

````yaml /openapi/spark.yaml post /InfoQuery
openapi: 3.0.1
info:
  title: Nayax Spark API
  description: RemoteStart V2
  version: v2
servers:
  - url: https://{domain}/api
    variables:
      domain:
        default: nayax-spark-dmz.nayax.com
        description: >-
          Your Nayax-assigned domain (e.g., nayax-spark-dmz.nayax.com). Nayax
          provides a QA domain during sandbox onboarding and a production domain
          after certification.
security: []
tags:
  - name: Transactions
paths:
  /InfoQuery:
    post:
      tags:
        - Transactions
      summary: InfoQuery
      requestBody:
        description: The request payload containing details to query for.
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/InfoQueryRequest'
      responses:
        '200':
          description: Success. The requested information has been successfully retrieved.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InfoQueryResponse'
components:
  schemas:
    InfoQueryRequest:
      type: object
      nullable: true
      description: >
        The request payload sent by Spark to the integrator's configured
        `InfoQuery` endpoint to retrieve information about a service and its
        availability.
      properties:
        HwSerial:
          type: string
          nullable: false
          description: >
            The serial number of the hardware terminal where the `InfoQuery`
            originated.
        MachineId:
          type: integer
          format: int64
          description: |
            The unique identifier for the machine or device.
        SparkTransactionId:
          type: string
          nullable: true
          description: >
            The unique transaction ID assigned by Spark. This ID is used to
            track the session throughout its lifecycle.
        ServiceStationNumber:
          type: string
          nullable: true
          description: >
            An identifier for the selected service station (e.g., a charging
            point number). This value identifies the Point of Interaction number
            provided by the Spark Provider.
        SiteId:
          type: integer
          format: int16
          description: >
            The ID of the site where the terminal is operating. This indicates
            the location where the transaction flow originated.
      example:
        HwSerial: '0434334921100366'
        MachineId: 71234996
        SparkTransactionId: 12c7cec2-c690-4425-9a1f-db0db60e2d8c
        ServiceStationNumber: '5'
        SiteId: 2
    InfoQueryResponse:
      type: object
      nullable: true
      description: desc
      properties:
        SparkTransactionId:
          type: string
          nullable: true
          description: |
            - Transaction ID generated in the /StartSession response
        HwSerial:
          type: string
          nullable: false
          description: |
            - Length: 255
            - Unique Identifier for the Nayax Device
            - Echo value from InfoQuery Request
        MachineId:
          type: integer
          format: int64
          description: |
            - Length: 255
            - Unique Identifier for the Nayax Machine
            - Echo value from InfoQuery Request
        ServiceStationNumber:
          type: string
          nullable: true
          description: >
            - Identifies the Spark Provider’s Point of Interaction number

            - Will be provided by Nayax when the Nayax Device is configured to
            support several service points via the Nayax backoffice system

            - Echo value from InfoQuery Request
        ServiceStationAvailability:
          type: integer
          format: int32
          nullable: false
          description: >
            - Indictaes if selected Service Station is (1) Available, (2) In
            Session / Busy, (3) Out of Service
        PosDisplay:
          type: string
          nullable: true
          description: |
            - Optional
            - Allows presenting information on the payment terminal screen
        Amount:
          type: number
          format: double
          description: >
            - Length: 3

            - A value that will be provided to the Terminal for transaction
            initiation
        SiteId:
          type: integer
          format: int16
          nullable: false
          description: |
            - Mandatory
            - Echo value from InfoQuery Request
        Status:
          $ref: '#/components/schemas/Status'
    Status:
      type: object
      nullable: false
      description: Transaction Status Details
      properties:
        Verdict:
          type: string
          nullable: false
          description: Status of the request (Approved / Declined)
        ErrorCode:
          type: integer
          format: int16
          nullable: true
          description: |
            - Conditional
            - Reason for declined request
        ErrorDescription:
          type: string
          nullable: true
          description: |
            - Conditional
            - Length: 255
            - Error description
        StatusMessage:
          type: string
          nullable: true
          description: |
            - Optional
            - Length: 255
            - Transaction status message as free text field

````