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

# /realms/{realmId}/organizations/{organizationId}/travel/trips



## OpenAPI

````yaml /api-reference/travel.openapi.json get /realms/{realmId}/organizations/{organizationId}/travel/trips
openapi: 3.0.3
info:
  title: Travel
  version: 1.0.0
  description: >-
    Portão 3 travel API. Generated by tools/openapi from code (routes +
    security) and the hand-written spec (request/response bodies). Search proxy
    (air/hotel/bus/vehicle) + passenger directory. Search POST bodies are
    validated per-vertical in the handler (tier=unknown); passenger bodies carry
    route-level zod schemas (typed). Responses proxied/presented without a
    schema layer. Confidence tiers: generated:typed=4 copied:manual=0
    unknown=17.
servers:
  - url: https://api.travel.v2.portao3.com.br/
    description: production
  - url: https://api.travel.dev.3pers.com.br/
    description: development
security:
  - bearerAuth: []
tags:
  - name: Travel Passengers
  - name: Travel Trips
  - name: Travel Search
paths:
  /realms/{realmId}/organizations/{organizationId}/travel/trips:
    get:
      tags:
        - Travel Trips
      summary: /realms/{realmId}/organizations/{organizationId}/travel/trips
      operationId: getRealmsByRealmIdOrganizationsByOrganizationIdTravelTrips
      parameters:
        - name: realmId
          in: path
          required: true
          schema:
            type: string
        - name: organizationId
          in: path
          required: true
          schema:
            type: string
        - name: from
          in: query
          required: false
          schema:
            type: string
            format: date
            pattern: >-
              ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$
        - name: to
          in: query
          required: false
          schema:
            type: string
            format: date
            pattern: >-
              ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$
        - name: vertical
          in: query
          required: false
          schema:
            type: string
            enum:
              - AIR
              - HOTEL
              - BUS
              - VEHICLE
        - name: state
          in: query
          required: false
          schema:
            type: string
            enum:
              - PENDING
              - RESERVED
              - ISSUED
              - CANCELED
        - name: status
          in: query
          required: false
          schema:
            type: string
            enum:
              - PROCESSING_RESERVATION
              - RESERVATION_FAILED
              - RESERVED
              - PROCESSING_ISSUE
              - ISSUED
              - PROCESSING_CANCELLATION
              - CANCELED
              - AWAITING_MANUAL_CANCELLATION
              - CANCELLATION_FAILED
              - FAILED
              - FAILED_BY_INCONSISTENT_DATA
              - FAILED_BY_UNAVAILABLE_RESOURCE
              - FAILED_BY_BUDGET_EXCEEDED
              - EXPIRED
              - BLOCKED
              - UNKNOWN
              - ISSUANCE_FAILED
        - name: userId
          in: query
          required: false
          schema:
            description: Filter by requesting user (ADMIN only — USERs are pre-scoped).
            type: string
        - name: passengerId
          in: query
          required: false
          schema:
            description: Trips where this LOCAL passenger travels on some item.
            type: string
            pattern: ^[0-9a-fA-F]{24}$
        - name: next
          in: query
          required: false
          schema:
            type: string
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            minimum: 0
            exclusiveMinimum: true
            maximum: 100
      responses:
        default:
          description: Undocumented response (no code type, no existing spec).
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````