> ## Documentation Index > Fetch the complete documentation index at: https://docs.devmob.app.br/llms.txt > Use this file to discover all available pages before exploring further. # List Trips > Lists trips. ## OpenAPI ````yaml /api-reference/customer/openapi.json get /api/v1/customer/trips openapi: 3.0.0 info: title: DEVMOB Customer API description: DEVMOB API version: '1.0' contact: {} servers: [] security: [] tags: - name: Address description: Customer addresses - name: Auth description: Authentication and token lifecycle - name: Benefit Program description: Fare benefit programs - name: Benefit Request description: Fare benefit requests and documents - name: Checkout description: Checkout creation and retrieval - name: Credit Grant description: Customer credits - name: Invite description: Invitation preview and acceptance - name: Notification description: Customer inbox notifications - name: Offering description: Trip offerings and seat maps - name: Order description: Customer orders - name: OTP description: One-time password flows - name: Payment description: Payments - name: Payment Method description: Saved payment methods - name: Point description: Point lookup - name: Profile description: Authenticated customer profile - name: Promotion description: Promotions - name: Routing description: Routing helpers - name: Session description: Authenticated sessions - name: Storage description: Storage uploads - name: Support description: Support cases - name: Ticket description: Customer tickets - name: Trip description: Customer trip access - name: Trip Review description: Trip reviews paths: /api/v1/customer/trips: get: tags: - Trip summary: List Trips description: Lists trips. operationId: listTrips parameters: - name: limit required: false in: query schema: default: 10 description: Items per page example: 10 type: number - name: page required: false in: query schema: default: 1 description: Page number example: 1 type: number - name: sortBy required: false in: query schema: default: departureAt description: Field to sort by example: departureAt type: string enum: - departureAt - estimatedArrivalAt - createdAt - name: sortOrder required: false in: query schema: default: desc description: Sort order example: desc type: string enum: - asc - desc - name: fields required: false in: query description: >- Comma-separated list of fields to include in the response. Supports dot notation for nested projection (e.g. `id,name,user.email,trips.route.id`). Unknown fields are silently dropped. schema: type: string responses: '200': content: application/json: schema: type: object properties: data: type: array items: $ref: '#/components/schemas/Trip' meta: $ref: '#/components/schemas/PageMeta' required: - data - meta description: OK '400': content: application/json: example: errors: - message: required path: name message: Bad Request Error statusCode: 400 schema: properties: message: type: string statusCode: enum: - 400 type: number errors: items: properties: message: type: string path: type: string required: - message - path type: object type: array required: - message - statusCode type: object description: Bad Request Error '401': content: application/json: example: message: Missing or invalid access token statusCode: 401 schema: properties: message: type: string statusCode: enum: - 401 type: number required: - message - statusCode type: object description: Unauthorized '500': content: application/json: example: message: Internal Server Error statusCode: 500 schema: properties: message: type: string statusCode: enum: - 500 type: number required: - message - statusCode type: object description: Internal Server Error security: - bearer: [] components: schemas: Trip: type: object properties: tripId: type: string format: uuid description: Identificador único companyId: type: string format: uuid description: Referência à empresa routeId: type: string format: uuid description: Referência à rota vehicleId: type: string format: uuid description: Referência ao veículo driverId: type: string format: uuid description: Referência ao motorista departureAt: type: string format: date-time description: Data e hora de partida estimatedArrivalAt: type: string format: date-time description: Data e hora estimada de chegada status: type: string enum: - SCHEDULED - IN_PROGRESS - COMPLETED - CANCELLED description: Status da viagem createdBy: type: string format: uuid nullable: true description: Usuário que criou o registro, quando aplicável createdAt: type: string format: date-time description: Data de criação updatedBy: type: string format: uuid nullable: true description: Usuário que fez a última atualização, quando aplicável updatedAt: type: string format: date-time description: Data da última atualização deletedBy: type: string format: uuid nullable: true description: Usuário que removeu o registro, quando aplicável deletedAt: type: string format: date-time nullable: true description: Data de remoção required: - tripId - companyId - routeId - vehicleId - driverId - departureAt - estimatedArrivalAt - status - createdBy - createdAt - updatedBy - updatedAt - deletedBy - deletedAt description: Viagens programadas combinando rota, veículo e motorista PageMeta: type: object properties: limit: type: integer description: Items per page. example: 10 page: type: integer description: Current page. example: 1 totalItems: type: integer description: Total items. example: 142 totalPages: type: integer description: Total pages. example: 15 required: - limit - page - totalItems - totalPages description: Page-based pagination metadata. securitySchemes: bearer: scheme: bearer bearerFormat: JWT type: http ````