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

# List stops

> Returns a paginated list of bus stops across all cities. Optionally filtered by city ID or country code.



## OpenAPI

````yaml /docs/openapi/openapi.json get /v2/stops
openapi: 3.1.0
info:
  title: PREXSELL REST v2
  version: 5.97.1
  description: REST API for the PREXSELL bus booking management platform.
servers:
  - url: https://staging.api.prexsell.com
    description: Staging
  - url: https://api.prexsell.com
    description: Production
security: []
paths:
  /v2/stops:
    get:
      tags:
        - Stops
      summary: List stops
      description: >-
        Returns a paginated list of bus stops across all cities. Optionally
        filtered by city ID or country code.
      operationId: listStops
      parameters:
        - schema:
            type: string
            description: Filter stops by the parent city identifier.
            example: cld1a2b3c4d5e6f7g8h9i0j1
          required: false
          description: Filter stops by the parent city identifier.
          name: cityId
          in: query
        - schema:
            type: string
            enum:
              - UA
              - TR
              - PL
              - CZ
              - IT
              - DE
              - SK
              - HU
              - BE
              - NL
              - RO
              - BG
              - FR
              - AT
              - LT
              - LV
              - EE
              - ES
              - LU
              - CH
              - GR
              - MD
              - SI
            description: ISO 3166-1 alpha-2 country code to filter stops.
            example: UA
          required: false
          description: ISO 3166-1 alpha-2 country code to filter stops.
          name: country
          in: query
        - schema:
            type: integer
            minimum: 1
            maximum: 1000
            default: 50
            description: Maximum number of stops to return (1–1000).
            example: 50
          required: false
          description: Maximum number of stops to return (1–1000).
          name: take
          in: query
        - schema:
            type:
              - integer
              - 'null'
            minimum: 0
            default: 0
            description: Number of items to skip for offset pagination.
            example: 0
          required: false
          description: Number of items to skip for offset pagination.
          name: skip
          in: query
      responses:
        '200':
          description: >-
            Paginated list of bus stops, each embedding a summary of the parent
            city.
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      stops:
                        type: array
                        items:
                          type: object
                          properties:
                            id:
                              type: string
                            place:
                              type: string
                            type:
                              type: string
                              enum:
                                - Airport
                                - TrainStation
                                - BusStation
                                - Regular
                            latitude: {}
                            longitude: {}
                            city:
                              type: object
                              properties:
                                id:
                                  type: string
                                name:
                                  type: string
                                slug:
                                  type: string
                                country:
                                  type: string
                                  enum:
                                    - UA
                                    - TR
                                    - PL
                                    - CZ
                                    - IT
                                    - DE
                                    - SK
                                    - HU
                                    - BE
                                    - NL
                                    - RO
                                    - BG
                                    - FR
                                    - AT
                                    - LT
                                    - LV
                                    - EE
                                    - ES
                                    - LU
                                    - CH
                                    - GR
                                    - MD
                                    - SI
                                timeZone:
                                  type:
                                    - string
                                    - 'null'
                              required:
                                - id
                                - name
                                - slug
                                - country
                                - timeZone
                              additionalProperties: false
                          required:
                            - id
                            - place
                            - type
                            - city
                          additionalProperties: false
                      total:
                        type: integer
                        minimum: 0
                        description: >-
                          Total number of stops matching the filter (unpaginated
                          count).
                        example: 120
                    required:
                      - stops
                      - total
                required:
                  - data
                example:
                  data:
                    stops:
                      - id: cst1a2b3c4d5e6f7g8h9
                        place: Центральний автовокзал
                        type: BUS_STATION
                        latitude: 50.4501
                        longitude: 30.5234
                        city:
                          id: cld1a2b3c4d5e6f7g8h9i0j1
                          name: Київ
                          slug: kyiv
                          country: UA
                          timeZone: Europe/Kyiv
                    total: 1

````