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

# Search transfers

> Requires `transfers:read` and a linked Vulcano sale channel. The channel is injected server-side. Returns vehicles that cover origin, destination, date, time and passengers.



## OpenAPI

````yaml /openapi.json get /transfers
openapi: 3.0.0
info:
  title: Vulcano Partners API
  description: >-
    Public API for external partners integrating with Vulcano Pro.


    **Authentication:** send `X-API-KEY` and `X-API-SECRET` on protected
    endpoints.


    **IDs:** `countryId`, `zone`, `category`, `tour_id`, `transfer_id`, and
    place IDs are Vulcano canonical IDs.


    **Permissions:** `/countries`, `/zones`, and `/categories` are available to
    any authenticated partner. `/tours` requires `tours:read`. `/transfers`
    requires `transfers:read`. Reservations (`/reservations` and
    `/transfers/reservations`) require `reservations:write` and a linked Vulcano
    sale channel.
  version: '1.0'
  contact: {}
servers:
  - url: https://api-sandbox.vulcanopro.com/api/v1
    description: Sandbox
  - url: https://api.vulcanopro.com/api/v1
    description: Production
security: []
tags: []
paths:
  /transfers:
    get:
      tags:
        - Transfers
      summary: Search transfers
      description: >-
        Requires `transfers:read` and a linked Vulcano sale channel. The channel
        is injected server-side. Returns vehicles that cover origin,
        destination, date, time and passengers.
      operationId: TransfersController_findAll
      parameters:
        - name: origin_place_id
          required: true
          in: query
          schema:
            type: integer
            minimum: 1
        - name: destination_place_id
          required: true
          in: query
          schema:
            type: integer
            minimum: 1
        - name: date
          required: true
          in: query
          schema:
            type: string
            format: date
        - name: time
          required: true
          in: query
          schema:
            type: string
            example: '12:30'
        - name: passengers
          required: true
          in: query
          schema:
            type: integer
            minimum: 1
            maximum: 99
        - name: page
          required: false
          in: query
          schema:
            type: integer
            minimum: 1
        - name: per_page
          required: false
          in: query
          schema:
            type: integer
            minimum: 1
            maximum: 100
      responses:
        '200':
          description: Transfers listed
        '403':
          description: Missing transfers:read or partner without sale channel
      security:
        - api-key: []
        - api-secret: []
components:
  securitySchemes:
    api-key:
      type: apiKey
      in: header
      name: X-API-KEY
      description: Partner API key
    api-secret:
      type: apiKey
      in: header
      name: X-API-SECRET
      description: Partner API secret

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.