> ## Documentation Index > Fetch the complete documentation index at: https://altostrat.io/docs/llms.txt > Use this file to discover all available pages before exploring further. # List Products > Returns a paginated list of MikroTik products. The list can be filtered by product name or model number, allowing for powerful search and cataloging capabilities. ## OpenAPI ````yaml /api/en/mikrotik-oem-data.yaml get /oem/products openapi: 3.0.3 info: title: Altostrat OEM Data API version: 1.0.0 description: >- The Altostrat OEM Data API is the microservice responsible for providing comprehensive, structured data about MikroTik hardware products and official resellers. It serves as the canonical data source for the Altostrat SDX platform, enabling features like hardware inventory management, automated device configuration templating, and providing users with detailed device specifications directly within the SDX interface. This API allows you to programmatically manage: - **Products:** Detailed hardware specifications for MikroTik devices, including CPU, memory, ports, wireless capabilities, and performance benchmarks. - **Resellers:** A global directory of official MikroTik resellers, filterable by country, providing contact and purchasing information. Developers use this API to integrate up-to-date MikroTik product and reseller information into their own applications or to programmatically query hardware details for automation scripts. servers: - url: https://v1.api.altostrat.io security: [] tags: - name: Products description: Access detailed information about MikroTik hardware products. - name: Resellers description: Find and retrieve information about official MikroTik resellers. paths: /oem/products: get: tags: - Products summary: List Products description: >- Returns a paginated list of MikroTik products. The list can be filtered by product name or model number, allowing for powerful search and cataloging capabilities. parameters: - in: query name: board_name schema: type: string description: >- A case-insensitive, partial match search on the product's board name. example: hEX - in: query name: model schema: type: string description: >- A case-insensitive, partial match search on the product's model number. example: RB750Gr3 - in: query name: page schema: type: integer default: 1 description: The page number of the paginated results to retrieve. example: 2 responses: '200': description: A paginated list of products was successfully retrieved. content: application/json: schema: $ref: '#/components/schemas/ProductCollection' '500': description: Internal Server Error - An unexpected error occurred on the server. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' components: schemas: ProductCollection: type: object properties: data: type: array items: $ref: '#/components/schemas/Product' meta: $ref: '#/components/schemas/PaginationMeta' ErrorResponse: type: object properties: type: type: string description: A broad category for the error (e.g., 'invalid_request_error'). example: invalid_request_error code: type: string description: A short, unique string identifying the specific error. example: resource_not_found message: type: string description: A human-readable description of what went wrong. example: The requested product could not be found. doc_url: type: string description: >- A direct link to the documentation page for this specific error code. example: https://docs.altostrat.io/errors/resource_not_found Product: type: object properties: id: type: integer description: The unique identifier for the product. example: 1 slug: type: string description: The URL-friendly unique identifier for the product. example: hex-s product_category_id: type: integer description: The identifier for the product's category. example: 5 name: type: string description: The common name of the product. example: hEX S model: type: string description: The official model number of the product. example: RB750Gr3 short_description: type: string description: A brief, one-sentence summary of the product's key features. example: >- hEX S is a five port Gigabit Ethernet router for locations where wireless connectivity is not required. Compared to the hEX, the hEX S also features an SFP port and PoE output on the last port. price: type: number format: float description: The manufacturer's suggested retail price (MSRP) in USD. example: 69.95 thumbnail: type: string format: uri description: A URL to the product's thumbnail image. example: https://cdn.sdx.altostrat.io/hex_s.jpg archived: type: boolean description: Indicates if the product is archived or discontinued. example: false PaginationMeta: type: object properties: pagination: type: object properties: total: type: integer description: Total number of items available. example: 150 per_page: type: integer description: Number of items per page. example: 25 current_page: type: integer description: The current page number. example: 1 last_page: type: integer description: The last page number. example: 6 prev_page_url: type: string format: uri nullable: true description: URL for the previous page of results. example: null next_page_url: type: string format: uri nullable: true description: URL for the next page of results. example: https://v1.api.altostrat.io/oem/products?page=2 ````