> ## 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 Resellers

> Returns a paginated list of official MikroTik resellers. This allows you to find resellers based on their geographical location or name, providing valuable information for procurement and partnership purposes.



## OpenAPI

````yaml /api/en/mikrotik-oem-data.yaml get /oem/mikrotik-resellers
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/mikrotik-resellers:
    get:
      tags:
        - Resellers
      summary: List Resellers
      description: >-
        Returns a paginated list of official MikroTik resellers. This allows you
        to find resellers based on their geographical location or name,
        providing valuable information for procurement and partnership purposes.
      parameters:
        - in: query
          name: country
          schema:
            type: string
          description: >-
            An ISO 3166-1 alpha-2 country code (e.g., 'us', 'gb', 'au') to
            filter resellers by. The match is case-insensitive.
          example: us
        - in: query
          name: name
          schema:
            type: string
          description: A case-insensitive, partial match search on the reseller's name.
          example: Streakwave
        - in: query
          name: page
          schema:
            type: integer
            default: 1
          description: The page number of the paginated results to retrieve.
          example: 1
      responses:
        '200':
          description: A paginated list of resellers was successfully retrieved.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResellerCollection'
        '500':
          description: Internal Server Error - An unexpected error occurred on the server.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
components:
  schemas:
    ResellerCollection:
      type: object
      properties:
        data:
          type: array
          items:
            $ref: '#/components/schemas/Reseller'
        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
    Reseller:
      type: object
      properties:
        name:
          type: string
          description: The official name of the reseller company.
          example: Streakwave Wireless, Inc.
        types:
          type: array
          items:
            type: string
          description: A list of roles the company holds (e.g., Reseller, Distributor).
          example:
            - Distributor
            - Reseller
        website:
          type: string
          format: uri
          description: The main URL for the reseller's website.
          example: http://www.streakwave.com
        address:
          type: string
          description: The physical or mailing address of the reseller.
          example: 2480 N. First St, Ste 100, San Jose, CA 95131
        email:
          type: string
          format: email
          description: The primary contact email address for the reseller.
          example: sales@streakwave.com
        phone:
          type: string
          description: The primary contact phone number for the reseller.
          example: 888-604-5234
        logo:
          type: string
          format: uri
          description: A URL to the reseller's logo.
          example: https://cdn.sdx.altostrat.io/streakwave_logo.png
        continent:
          type: string
          description: The continent where the reseller is located.
          example: America
        region:
          type: string
          description: The sub-region or country group.
          example: North America
        country:
          type: string
          description: The full country name.
          example: USA
        country_code:
          type: string
          description: The ISO 3166-1 alpha-2 country code.
          example: US
    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

````