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

# Vessel Location Bulk Search

> Query multiple vessel locations in a single request using comma-separated IMO or MMSI numbers. Maximum 50 vessels per request. Credits charged per vessel queried (1 credit per IMO/MMSI). Based on terrestrial AIS data only. Rate limit: 15 requests/min.

Query multiple vessel locations in a single request using comma-separated IMO or MMSI numbers.

<Info>
  **Credits:** 1 credit per vessel queried (variable total)
</Info>

## Usage

Pass a comma-separated list of IMO or MMSI numbers (no spaces) in the `imo_or_mmsi` parameter.

```
?imo_or_mmsi=9465411,215767000,9247431
```

## Limits

* Maximum **50 vessels** per request
* Credits charged per vessel found

<Warning>
  This endpoint currently uses **terrestrial AIS data only**. Satellite AIS coverage will be added in a future update.
</Warning>

## Response

The response includes:

* `total_requested`: Number of vessels in your query
* `successful`: Number of vessels found
* `failed`: Number of vessels not found
* `results`: Array of vessel location data


## OpenAPI

````yaml GET /get-vessels-location-bulk-search
openapi: 3.1.0
info:
  title: Data Docked Maritime API
  description: >-
    A comprehensive maritime data API providing real-time vessel tracking, port
    operations, inspection data, and more. Access AIS data, vessel particulars,
    management information, and historical tracking data.
  version: 1.0.0
  contact:
    name: Data Docked Support
    url: https://datadocked.com/contact
servers:
  - url: https://datadocked.com/api/vessels_operations
    description: Production server
security:
  - apiKey: []
tags:
  - name: Account
    description: Account management endpoints
  - name: Vessel Operations
    description: Vessel data, location, and tracking endpoints
  - name: Port Operations
    description: Port calls and port data endpoints
paths:
  /get-vessels-location-bulk-search:
    get:
      tags:
        - Vessel Operations
      summary: Vessel Location Bulk Search
      description: >-
        Query multiple vessel locations in a single request using
        comma-separated IMO or MMSI numbers. Maximum 50 vessels per request.
        Credits charged per vessel queried (1 credit per IMO/MMSI). Based on
        terrestrial AIS data only. Rate limit: 15 requests/min.
      operationId: getVesselsLocationBulkSearch
      parameters:
        - name: imo_or_mmsi
          in: query
          required: true
          description: >-
            Comma-separated list of IMO or MMSI numbers (no spaces). Maximum 50
            per request.
          schema:
            type: string
          example: 9465411,215767000
      responses:
        '200':
          description: Successful response with multiple vessel locations
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BulkLocationResponse'
        '400':
          description: Bad request - Invalid format or exceeds 50 vessels
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          description: Unauthorized - Invalid or missing API key
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    BulkLocationResponse:
      type: object
      properties:
        total_requested:
          type: integer
          description: Number of vessels requested
        successful:
          type: integer
          description: Number of vessels found
        failed:
          type: integer
          description: Number of vessels not found
        results:
          type: array
          items:
            type: object
            properties:
              name:
                type: string
              imo:
                type: string
              mmsi:
                type: string
              latitude:
                type: string
              longitude:
                type: string
              etaUtc:
                type: string
              atdUtc:
                type: string
              course:
                type: string
              heading:
                type: string
              speed:
                type: string
              draught:
                type: string
              navigationalStatus:
                type: string
              destination:
                type: string
              lastPort:
                type: string
              callsign:
                type: string
              positionReceived:
                type: string
              updateTime:
                type: string
              unlocodeDestination:
                type: string
              unlocodeLastport:
                type: string
              typeSpecific:
                type: string
              dataSource:
                type: string
        userRequest:
          type: string
          description: Original query string
    Error:
      type: object
      properties:
        error:
          type: string
          description: Error type
        message:
          type: string
          description: Error message
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: x-api-key
      description: >-
        Your personal API key found in your profile dashboard at
        https://datadocked.com/dashboard/my_keys

````