---
title: "Get Specific Machine Basic Info by VPOS"
method: GET
path: "/v1/vpos/{VPOSSerial}/machine"
tags: ["Machines"]
---

# Get Specific Machine Basic Info by VPOS

`GET /v1/vpos/{VPOSSerial}/machine`

Retrieves the basic information of a specific machine associated with the provided VPOS serial number. This allows users to fetch machine details by referencing the VPOS device it is connected to.

## Path parameters

- `VPOSSerial` string, required

## Response `200`

The machine information associated with the provided VPOS serial number.

- MachineInfo — Contains basic information about a machine, including identifiers, location details, and configuration settings.
  - `MachineID` integer, nullable — The unique identifier of the machine.
  - `ActorID` integer, nullable — The identifier of the actor associated with the machine.
  - `CountryID` integer, nullable — The identifier of the country where the machine is located.
  - `CurrencyID` integer, nullable — The identifier of the currency used by the machine.
  - `InstituteID` integer, nullable — The identifier of the institute associated with the machine.
  - `LocationID` integer, nullable — The identifier of the location where the machine is installed.
  - `MachineGroupID` integer, nullable — The identifier of the group to which the machine belongs.
  - `MachineModelID` integer, nullable — The identifier of the machine's model.
  - `MachineName` string, nullable — The name of the machine.
  - `MachineNumber` string, nullable — The serial number or unique identifier assigned to the machine by the manufacturer.
  - `MachineStatusBit` integer — A bit field indicating the status of the machine.
  - `LanguageID` unknown
  - `OperatorActorID` integer, nullable — The identifier of the operator managing the machine.
  - `DistributorActorID` integer, nullable — The identifier of the distributor associated with the machine.
  - `AreaActorID` integer, nullable — The identifier of the area actor responsible for the machine.
  - `SalesSourceID` integer, nullable — The identifier of the sales source associated with the machine.
  - `MachineTypeID` 555001 | 555002 | 555003 | 555004 | 555005 | 555006 | 555007 | 555008 | 556017 | 556018 | 30000514 | 30000515 | 30000516 | 30000517 | 30000518 | 30000519 | 30000520 | 30000521 | 30000522 | 30000523 | 30000524 | 30000525 | 30000526 | 30000527 | 30000561 | 30000578 | 30000579 | 30000580 | 30000581 | 30000582 | 30000583 | 30000602 | 30000611 | 30000612 | 30000617 | 30000618 | 30000619 | 30000620 | 30000623 | 176649542 | 227707459 | 227707460 | 504059468 | 529079224 | 363311433 | 244797254
  - `SerialNumber` string, nullable — The serial number of the machine.
  - `VPOSSerialNumber` string, nullable — The VPOS serial number associated with the machine.
  - `DeviceSerialNumber` string, nullable — The serial number of the device installed in the machine.
  - `VPOSID` integer, nullable — The unique identifier of the VPOS device associated with the machine.
  - `DeviceID` integer, nullable — The unique identifier of the device installed in the machine.
  - `UseLocationFrom` integer, nullable — Specifies where the location information is sourced from.
  - `GeoCountry` integer, nullable — The country identifier based on geographic data.
  - `GeoState` string, nullable — The state or region based on geographic data.
  - `GeoCity` string, nullable — The city based on geographic data.
  - `GeoAddress` string, nullable — The full address based on geographic data.
  - `GeoStreetNumber` string, nullable — The street number based on geographic data.
  - `GeoLongitude` number, double, nullable — The geographic longitude where the machine is located.
  - `GeoLatitude` number, double, nullable — The geographic latitude where the machine is located.
  - `GeoZoom` integer, nullable — The zoom level for geographic data representation.
  - `GeoZipCode` string, nullable — The postal or ZIP code based on geographic data.
  - `SearchAddress` string, nullable — The address used for search purposes.
  - `Remarks` string, nullable — Additional remarks or notes about the machine.
  - `DexType` integer, nullable — The DEX type identifier.
  - `DexMidnightReadsEnableBit` boolean, nullable — Indicates if midnight DEX reads are enabled.
  - `DexG85CheckEnableBit` boolean, nullable — Indicates if the G85 check for DEX is enabled.
  - `DexDivideBillsBy` integer, nullable — The value by which DEX bills are divided.
  - `DexG85CheckParsingFilterEnableBit` boolean, nullable — Indicates if the parsing filter for DEX G85 check is enabled.
  - `UseCardPriceCorrectCashPriceBit` boolean, nullable — Indicates if card prices are used to correct cash prices.
  - `MachineTimeZoneOffset` number, double, nullable — The time zone offset for the machine.
  - `DexReadInterval` integer, nullable — The interval at which DEX reads occur.
  - `LocationType` integer, nullable — The identifier of the location type.
  - `ApplyDisplayPickListSelectionsToReportsBit` boolean, nullable — Indicates if picklist selections should be applied to reports.
  - `DisplayPickListSelectionsAs` integer, nullable — Specifies how picklist selections are displayed.
  - `LastUpdated` string, date-time, nullable — The date and time when the machine information was last updated.
  - `MachineProfile` integer, nullable — The identifier of the machine profile.
  - `CityID` integer, nullable — The identifier of the city where the machine is located.
  - `RegionID` integer, nullable — The identifier of the region where the machine is located.
  - `CountryDialingCode` integer, nullable — The dialing code for the country where the machine is located.
  - `DexIgnoreCRCCheckBit` boolean, nullable — Indicates if CRC checks are ignored in DEX.
  - `DexParseLABit` boolean, nullable — Indicates if the DEX LA parsing is enabled.
  - `ProductMapID` integer, nullable — The identifier of the product map associated with the machine.
  - `Longitude` number, double, nullable — The geographic longitude where the machine is located.
  - `Latitude` number, double, nullable — The geographic latitude where the machine is located.
  - `DexTotalSalesMinusCardSalesBit` boolean, nullable — Indicates if total sales should exclude card sales in DEX.
  - `RouteActorID` integer, nullable — The identifier of the route actor managing the machine.
  - `MachineLogicAlertEnableBit` boolean, nullable — Indicates if machine logic alerts are enabled.
  - `AlertRuleSetId` integer, nullable — The identifier of the alert rule set associated with the machine.
  - `MachineMemberTypePricingEnableBit` boolean, nullable — Indicates if member type pricing is enabled for the machine.
  - `DexMultiplyCoinsBy` integer, nullable — The value by which DEX coins are multiplied.
  - `DexMultiplyTubesBy` integer, nullable — The value by which DEX tubes are multiplied.
  - `CustomerID` integer, nullable — The unique identifier of the customer associated with the machine.
  - `CommissionType` integer, nullable — The type of commission applied to the machine.
  - `CommissionDefaultValue` number, double, nullable — The default commission value applied to the machine.
  - `CreatedBy` integer, nullable — The unique identifier of the user who created the machine entry.
  - `CreatedOn` string, date-time, nullable — The date and time when the machine entry was created.
  - `UpdateBy` integer, nullable — The unique identifier of the user who last updated the machine entry.
  - `TubeSource` integer, nullable — The source of the tube data for the machine.
  - `BillSource` integer, nullable — The source of the bill data for the machine.
  - `SmartStickerId` integer, nullable — The identifier of the smart sticker associated with the machine.
  - `EnableRemoveVendBit` boolean, nullable — Indicates if the remove vend functionality is enabled.
  - `EnableEreceiptBit` boolean, nullable — Indicates if the e-receipt functionality is enabled.
  - `ProductMapAutomaticCreationBit` boolean, nullable — Indicates if the product map is automatically created.
  - `Refs` object, nullable — Additional references associated with the machine.

---

[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)
