> ## Documentation Index
> Fetch the complete documentation index at: https://api-docs.tarla.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Find Stations By Name Pattern



## OpenAPI

````yaml en/open-api/mgm-stations-v1.json post /v1/mgm-stations/by/name
openapi: 3.1.0
info:
  title: OpenAPI definition
  version: v0
servers:
  - url: https://risk-api.tarla.io
    description: Production server
  - url: https://risk-api-test.tarla.io
    description: Test server
security: []
tags:
  - name: MGM Stations Data API
    description: >-
      This web service provides daily precipitation sum, maximum and minimum
      weather temperatures, and minimum ground surface temperature values from
      MGM
paths:
  /v1/mgm-stations/by/name:
    post:
      tags:
        - MGM Stations Data API
      summary: Find Stations By Name Pattern
      operationId: getStationsByName
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/StationsByNameRequest'
        required: true
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Station'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StandardErrorResponse'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StandardErrorResponse'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StandardErrorResponse'
components:
  schemas:
    StationsByNameRequest:
      type: object
      properties:
        stationName:
          type: string
          description: Name of the station to be searched
          minLength: 1
        matchType:
          type: string
          description: >-
            Match type used to indicate where the search term appears in the
            search field
          enum:
            - STARTS_WITH
            - ENDS_WITH
            - CONTAINS
            - EQUALS
        limit:
          type: integer
          format: int32
          description: Records limit in response
          maximum: 100
          minimum: 1
        sort:
          type: string
          description: Records sort direction in response
          enum:
            - ASC
            - DESC
      required:
        - limit
        - matchType
        - stationName
    Station:
      type: object
      description: Represents a weather station with its location and name
      properties:
        stationId:
          type: integer
          format: int32
          description: Unique identifier of the weather station
        stationName:
          type: string
          description: Name of the weather station
        latitude:
          type: number
          format: double
          description: Latitude coordinate of the station
        longitude:
          type: number
          format: double
          description: Longitude coordinate of the station
        city:
          type: string
          description: City where the station is located
        district:
          type: string
          description: District where the station is located
    StandardErrorResponse:
      type: object
      description: Standard API error response structure
      properties:
        timestamp:
          type: string
          format: date-time
          description: Timestamp when the error occurred
        status:
          type: integer
          format: int32
          description: HTTP status code
        error:
          type: string
          description: Error name or type
        message:
          type: string
          description: Main error message
        messages:
          type: array
          description: Additional detailed error messages
          items:
            type: string
        path:
          type: string
          description: Request path that caused the error

````