---
title: "InfoQuery"
method: POST
path: "/InfoQuery"
tags: ["Transactions"]
---

# InfoQuery

`POST /InfoQuery`

## Request body

- InfoQueryRequest, nullable — The request payload sent by Spark to the integrator's configured `InfoQuery` endpoint to retrieve information about a service and its availability.
  - `HwSerial` string — The serial number of the hardware terminal where the `InfoQuery` originated.
  - `MachineId` integer — The unique identifier for the machine or device.
  - `SparkTransactionId` string, nullable — The unique transaction ID assigned by Spark. This ID is used to track the session throughout its lifecycle.
  - `ServiceStationNumber` string, nullable — 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` integer — The ID of the site where the terminal is operating. This indicates the location where the transaction flow originated.

## Response `200`

Success. The requested information has been successfully retrieved.

- InfoQueryResponse, nullable — desc
  - `SparkTransactionId` string, nullable — - Transaction ID generated in the /StartSession response
  - `HwSerial` string — - Length: 255 - Unique Identifier for the Nayax Device - Echo value from InfoQuery Request
  - `MachineId` integer — - Length: 255 - Unique Identifier for the Nayax Machine - Echo value from InfoQuery Request
  - `ServiceStationNumber` string, nullable — - 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` integer — - Indictaes if selected Service Station is (1) Available, (2) In Session / Busy, (3) Out of Service
  - `PosDisplay` string, nullable — - Optional - Allows presenting information on the payment terminal screen
  - `Amount` number, double — - Length: 3 - A value that will be provided to the Terminal for transaction initiation
  - `SiteId` integer — - Mandatory - Echo value from InfoQuery Request
  - `Status` Status — Transaction Status Details
    - `Verdict` string — Status of the request (Approved / Declined)
    - `ErrorCode` integer, nullable — - Conditional - Reason for declined request
    - `ErrorDescription` string, nullable — - Conditional - Length: 255 - Error description
    - `StatusMessage` string, nullable — - Optional - Length: 255 - Transaction status message as free text field

---

[API](https://skmtc.net/nayax/apis/nayax-cortina-api.md) · [All operations](https://skmtc.net/nayax/apis/nayax-cortina-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/nayax/nayax-cortina-api/versions/421f6f83c257/schema)