---
title: "Search Machine Basic Info"
method: POST
path: "/v1/machines/search"
tags: ["Machines"]
---

# Search Machine Basic Info

`POST /v1/machines/search`

## Request

- Base URL: `https://example.com:443`
- URL: `https://example.com:443/v1/machines/search`
- Auth: none required
- TypeScript: <https://skmtc.dev/nayax/apis/nayax-cortina-api/docs/v1/machines/search/post.ts> (a function with typed inputs; its response is checked against the schema)

Retrieves a list of machines based on the search criteria provided in the request body. This allows users to filter and find specific machines or groups of machines by applying various parameters.

## Request body

- MachineSearchRequest
  - `MachineID` integer, nullable: The unique identifier of the machine to search for.
  - `StatusID` integer, nullable: The status identifier to filter the machines by status.
  - `Search` string, nullable: The search query string to filter machines by name or number.

## Response `200`

A list of machines matching the search criteria, including their basic details.

- MachineSearchResult[]
  - `typeID` integer, nullable: The type identifier associated with the machine.
  - `ID` string, nullable: The unique identifier for the machine search result.
  - `parentID` string, nullable: The parent identifier associated with the machine, if any.
  - `Disabled` integer, nullable: Indicator if the machine is disabled (1 for disabled, 0 for enabled).
  - `Name` string, nullable: The name of the machine associated with the search result.

---

[API](https://skmtc.dev/nayax/apis/nayax-cortina-api.md) - [All operations](https://skmtc.dev/nayax/apis/nayax-cortina-api/llms.txt) - [OpenAPI document](https://skmtc.dev/nayax/apis/nayax-cortina-api/revisions/421f6f83c257?raw)