Skip to main content
In Nayax Core, machines have various attributes, such as the Operator of the machine, the machine’s model or ID, and its status. These can all be seen in the Machines menu, which you can access in the following way:
  1. In your Dashboard, go to Operations > Machines.
  2. Use the search function to filter through the list of machines.
  3. Select the desired machine from the list.
  4. Open the General Information tab.
You can see all the key information about the machine you may need for other requests there.

​
Lynx API Methods

The Lynx API provides various methods to retrieve all this information, allowing you to programmatically access specific machine details, groups, statuses, and configurations. These are the available methods discussed on this page:

Get Specific Machine Basic Info by MachineID

GET

Get Specific Machine Basic Info by Device

GET

Get Specific Machine Basic Info by VPOS

GET

Get All Machine Basic Info

GET
See the following sections for more details on each method.
AuthenticationRefer to the Security & Token page of this documentation to learn how to access your tokens, and how to properly use it to authenticate your API requests.

​
Retrieve a Machine by MachineID

Using the Get Specific Machine Basic Info you can get the details of a machine with a specific MachineID. See an example request in the code block below: 
curl --request GET \
     --url https://qa-lynx.nayax.com/operational/v1/machines/{MachineID} \
     --header 'Authorization: BEARER-TOKEN' \
     --header 'accept: application/json'
Insert the MachineID in the path param of the request.

​
Retrieve a Machine by DeviceSerialNumber

Using the Get Specific Machine Basic Info by Device endpoint, you can retrieve the details of a machine associated with a specific DeviceSerialNumber. See an example request in the code block below: 
curl --request GET \
     --url https://qa-lynx.nayax.com/operational/v1/devices/{DeviceSerialNumber}/machine \
     --header 'Authorization: BEARER-TOKEN' \
     --header 'accept: application/json'
Insert the DeviceSerialNumber in the request path parameter to fetch the machine details associated with that device.

​
Retrieve a Machine by VPOSSerial

Using the Get Specific Machine Basic Info by VPOS endpoint, you can retrieve the details of a machine associated with a specific VPOSSerial. See an example request in the code block below: 
curl --request GET \
     --url https://qa-lynx.nayax.com/operational/v1/vpos/{VPOSSerial}/machine \
     --header 'Authorization: BEARER-TOKEN' \
     --header 'accept: application/json'
Insert the VPOSSerial in the path parameter of the request to fetch the machine details associated with that VPOS device.

​
Retrieve All Machine Basic Info

Using the Get All Machine Basic Info endpoint, you can retrieve basic information for all machines, with optional filtering by various parameters. See an example request in the code block below:
Request
curl --request GET \
     --url https://qa-lynx.nayax.com/operational/v1/machines \
     --header 'Authorization: BEARER-TOKEN' \
     --header 'accept: application/json'
You can use any of the query parameters in the table below to filter out the machines:
ParameterTypeDescription
ResultsLimitint32The maximum number of results to return; it is set to 100 by default.
ResultsOffsetint32The number of results to skip before starting to return results; set to 0 by default.
ActorIDint64Filter results by the actor ID associated with the machine.
OperatorIdentifierstringFilter results by the operator identifier.
MachineIDint64Filter results by the machine ID.
MachineSerialNumberstringFilter results by the machine’s serial number.
MachineNamestringFilter results by the machine’s name.
DeviceIDint32Filter results by the device ID associated with the machine.
VposIDint64Filter results by the VPOS ID associated with the machine.