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

# List travel

> People's journeys to and from the festival in the edition.



## OpenAPI

````yaml https://api-test.fesutibaru.com/api/v1/openapi.json get /travel
openapi: 3.1.0
info:
  title: Fesutibaru Planner API
  version: 0.17.0
  description: >-
    The festival's working data, read as a signed-in person: what they can see
    in Planner, they can read here, and nothing else.


    Each festival has its own address: https://<festival>.fesutibaru.com/api/v1.


    Field names are the database's own, so a field you read is the field you
    change in a proposal. Times are instants (ISO 8601 with offset); the
    festival's own wall-clock time is alongside as <field>_local.


    Editions: event, travel, stay, pick-up, document and media records belong to
    one edition. Reads default to the current edition; ?edition=2027 reads
    another.


    Custom fields appear on records as cf_<field_key> (see /custom-fields).


    Changes are proposed, never made directly: POST /proposals, and the person
    accepts or rejects them in their Planner inbox.


    Public listings for websites, with an API key, are under /api/v1/public.
servers:
  - url: https://{festival}.fesutibaru.com/api/v1
    variables:
      festival:
        default: demo
        description: The festival's subdomain.
security:
  - agent:
      - planner:read
paths:
  /travel:
    get:
      tags:
        - Travel
      summary: List travel
      description: People's journeys to and from the festival in the edition.
      operationId: list_travel
      parameters:
        - name: edition
          in: query
          description: >-
            Read another edition by its year, e.g. 2027. Default: the current
            edition.
          schema:
            type: integer
        - name: edition_id
          in: query
          description: Read another edition by its id.
          schema:
            type: string
            format: uuid
        - name: include
          in: query
          description: 'Add related records, comma-separated: person (Who is travelling).'
          schema:
            type: string
          examples:
            all:
              value: person
        - name: page
          in: query
          schema:
            type: integer
            minimum: 1
            default: 1
        - name: per_page
          in: query
          schema:
            type: integer
            minimum: 1
            maximum: 200
            default: 50
        - name: q
          in: query
          description: >-
            Search departure_location, arrival_location, booking_reference (part
            of the value, any case).
          schema:
            type: string
        - name: updated_since
          in: query
          description: >-
            Only records changed at or after this time: for keeping a copy in
            sync.
          schema:
            type: string
            format: date-time
        - name: person_id
          in: query
          description: This person's journeys.
          schema:
            type: string
            format: uuid
        - name: travel_type
          in: query
          description: arrival or departure.
          schema:
            type: string
        - name: status
          in: query
          description: Booking status.
          schema:
            type: string
      responses:
        '200':
          description: A page of travel.
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/Travel'
                  meta:
                    type: object
                    properties:
                      page:
                        type: integer
                      per_page:
                        type: integer
                      total:
                        type: integer
                      edition:
                        $ref: '#/components/schemas/Edition'
        '400':
          description: 'Something in the request is wrong: detail says what.'
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
        '401':
          description: Not signed in.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
        '403':
          description: Not allowed.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
        '404':
          description: No such record, edition or resource.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
        '429':
          description: 'Too many requests: wait for Retry-After seconds.'
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
components:
  schemas:
    Travel:
      type: object
      description: >-
        People's journeys to and from the festival in the edition. Fields you
        may not see are left out. Custom fields appear as cf_<field_key>.
      properties:
        id:
          type: string
          format: uuid
        festival_id:
          type: string
          format: uuid
        person_id:
          type: string
          format: uuid
        travel_type:
          anyOf:
            - type: string
            - type: 'null'
        transport_mode:
          anyOf:
            - type: string
            - type: 'null'
        departure_location:
          anyOf:
            - type: string
            - type: 'null'
        arrival_location:
          anyOf:
            - type: string
            - type: 'null'
        departure_time:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
        departure_time_local:
          anyOf:
            - type: string
              pattern: ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}$
            - type: 'null'
          description: departure_time in the festival’s own time zone, as wall-clock time.
        arrival_time:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
        arrival_time_local:
          anyOf:
            - type: string
              pattern: ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}$
            - type: 'null'
          description: arrival_time in the festival’s own time zone, as wall-clock time.
        driver_id:
          anyOf:
            - type: string
              format: uuid
            - type: 'null'
        booking_reference:
          anyOf:
            - type: string
            - type: 'null'
        notes:
          anyOf:
            - type: string
            - type: 'null'
        created_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
        updated_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
        travel_companion:
          anyOf:
            - type: string
            - type: 'null'
        driver_pick_up_location:
          anyOf:
            - type: string
            - type: 'null'
        driver_drop_off_location:
          anyOf:
            - type: string
            - type: 'null'
        driver_pick_up_time:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
        driver_pick_up_time_local:
          anyOf:
            - type: string
              pattern: ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}$
            - type: 'null'
          description: >-
            driver_pick_up_time in the festival’s own time zone, as wall-clock
            time.
        accommodation_notes:
          anyOf:
            - type: string
            - type: 'null'
        edition_id:
          type: string
          format: uuid
        status:
          anyOf:
            - type: string
            - type: 'null'
        driver_notes:
          anyOf:
            - type: string
            - type: 'null'
        pickup_id:
          anyOf:
            - type: string
              format: uuid
            - type: 'null'
          description: The pick-up run this journey is on, if any.
        needs_pickup:
          type: boolean
        person:
          anyOf:
            - $ref: '#/components/schemas/People'
            - type: 'null'
          description: Who is travelling. Only with ?include=person.
      additionalProperties: true
    Edition:
      type: object
      properties:
        id:
          type: string
          format: uuid
        year:
          type: integer
        name:
          type: string
        is_current:
          type: boolean
    Problem:
      type: object
      description: 'An error (RFC 9457): detail says what went wrong and what to do.'
      properties:
        type:
          type: string
        title:
          type: string
        status:
          type: integer
        detail:
          type: string
      required:
        - title
        - status
        - detail
    People:
      type: object
      description: >-
        Everyone taking part in the edition: authors, chairs, staff, publicists…
        A person belongs to the festival and takes part in editions. Fields you
        may not see are left out. Custom fields appear as cf_<field_key>.
      properties:
        id:
          type: string
          format: uuid
        festival_id:
          type: string
          format: uuid
        name:
          type: string
        email:
          anyOf:
            - type: string
            - type: 'null'
        phone:
          anyOf:
            - type: string
            - type: 'null'
        role_type:
          anyOf:
            - type: string
            - type: 'null'
          description: >-
            Their role at the festival: participant (authors, chairs and other
            speakers), publicist, operations, administrator…
        bio:
          anyOf:
            - type: string
            - type: 'null'
        photo_url:
          anyOf:
            - type: string
            - type: 'null'
        dietary_requirements:
          anyOf:
            - type: string
            - type: 'null'
          description: 'Dietary needs. Personal: handle with care.'
        accessibility_needs:
          anyOf:
            - type: string
            - type: 'null'
          description: 'Access needs. Personal: handle with care.'
        created_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
        updated_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
        first_name:
          anyOf:
            - type: string
            - type: 'null'
        last_name:
          anyOf:
            - type: string
            - type: 'null'
        pronoun:
          anyOf:
            - type: string
            - type: 'null'
        address:
          anyOf:
            - type: string
            - type: 'null'
        website:
          anyOf:
            - type: string
            - type: 'null'
        facebook:
          anyOf:
            - type: string
            - type: 'null'
        instagram:
          anyOf:
            - type: string
            - type: 'null'
        tiktok:
          anyOf:
            - type: string
            - type: 'null'
        x_bluesky:
          anyOf:
            - type: string
            - type: 'null'
        other_social_media:
          anyOf:
            - type: string
            - type: 'null'
        contact_name:
          anyOf:
            - type: string
            - type: 'null'
        contact_email:
          anyOf:
            - type: string
            - type: 'null'
        contact_phone:
          anyOf:
            - type: string
            - type: 'null'
        home_location:
          anyOf:
            - type: string
            - type: 'null'
        nationality:
          anyOf:
            - type: string
            - type: 'null'
        accommodation_id:
          anyOf:
            - type: string
              format: uuid
            - type: 'null'
        accomm_status:
          anyOf:
            - type: string
            - type: 'null'
        contact_person_id:
          anyOf:
            - type: string
              format: uuid
            - type: 'null'
          description: Their contact, when someone else handles their arrangements.
        title:
          anyOf:
            - type: string
            - type: 'null'
        capabilities:
          type: array
          items:
            type: string
          description: Crew jobs they can also do (driver, foh, security, technician).
      additionalProperties: true
  securitySchemes:
    agent:
      type: oauth2
      description: >-
        Sign in as a person: Planner shows them what the agent asks for
        (planner:read, planner:propose) and they agree. The agent then sees what
        they can see. Discovery: /.well-known/oauth-protected-resource.
      flows:
        authorizationCode:
          authorizationUrl: https://clerk.fesutibaru.com/oauth/authorize
          tokenUrl: https://clerk.fesutibaru.com/oauth/token
          refreshUrl: https://clerk.fesutibaru.com/oauth/token
          scopes:
            planner:read: Read the festival records you can see in Planner.
            planner:propose: >-
              Propose changes for you to review in your Planner inbox. Nothing
              changes until you accept it.

````

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