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

# mta.stops.byIds() — batch stop lookup

> Reference for GET /api/v1/stops. Resolve multiple stop IDs in a single request, preserving request order, optionally with served routes.

Resolves many stops at once. Pass a comma-separated `ids` list (for example `A27,L06,308214`) to hydrate a saved-stops list or a map viewport without one request per ID.

The response preserves one result per requested ID, in order: `{ requestedId, found, stop?, servedRoutes? }`. When `found` is `false`, the ID didn't resolve. Set `includeRoutes=true` to attach `servedRoutes` for each resolved stop. For nearby/geo search, use the [Stops reference](/api-reference/stops).

### SDK

```typescript theme={null}
const results = await mta.stops.byIds({
  ids: ['A27', 'L06', '308214'],
  includeRoutes: true,
})

for (const result of results) {
  if (result.found) console.log(result.stop.name)
  else console.log(`${result.requestedId} not found`)
}
```

See the [Routes & Stations guide](/guides/routes-and-stations).


## OpenAPI

````yaml GET /api/v1/stops
openapi: 3.0.3
info:
  title: MTA API
  description: Managed, API-key protected access to MTA realtime and static data.
  version: 0.1.0
servers:
  - url: https://www.mtaapi.dev
    description: Production
security:
  - bearerAuth: []
  - apiKeyAuth: []
tags:
  - name: subway
    description: Subway realtime data
  - name: bus
    description: BusTime realtime data
  - name: alerts
    description: Service alerts
  - name: stops
    description: Route-aware static GTFS stop lookup
  - name: system
    description: Health and database status
paths:
  /api/v1/stops:
    get:
      tags:
        - stops
      summary: Get stops by ID
      description: Look up multiple subway or bus stops while preserving request order.
      operationId: getApiV1Stops
      parameters:
        - name: ids
          in: query
          required: true
          schema:
            minLength: 1
            description: Comma-separated stop IDs, such as A27,L06,308214.
            type: string
        - name: includeRoutes
          in: query
          required: false
          schema:
            description: Include route metadata for each found stop.
            type: boolean
      responses:
        '200':
          description: Response for status 200
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  required:
                    - requestedId
                    - found
                  properties:
                    requestedId:
                      type: string
                    found:
                      type: boolean
                    stop:
                      type: object
                      required:
                        - id
                        - name
                      properties:
                        id:
                          type: string
                        name:
                          type: string
                        displayName:
                          type: string
                        lat:
                          type: number
                        lon:
                          type: number
                        mode:
                          enum:
                            - subway
                            - bus
                          type: string
                        parentId:
                          type: string
                    servedRoutes:
                      type: array
                      items:
                        type: object
                        required:
                          - id
                        properties:
                          id:
                            type: string
                          shortName:
                            type: string
                          longName:
                            type: string
                          type:
                            type: number
                          color:
                            type: string
                          textColor:
                            type: string
                          headsigns:
                            type: array
                            items:
                              type: string
                          directionHeadsigns:
                            additionalProperties:
                              type: array
                              items:
                                type: string
                            type: object
                            properties: {}
                          directions:
                            type: array
                            items:
                              type: number
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API Key
    apiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key

````