> ## 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. # Get Offering > Returns an offering. ## OpenAPI ````yaml /api-reference/customer/openapi.json get /api/v1/customer/offerings/trips/{tripId}/trip-itineraries/{tripItineraryId} 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/offerings/trips/{tripId}/trip-itineraries/{tripItineraryId}: get: tags: - Offering summary: Get Offering description: Returns an offering. operationId: getOffering parameters: - name: tripId required: true in: path schema: type: string format: uuid description: Trip identifier example: 0195e7a1-8b5c-7d3e-9f4a-2c6b8d0e1f3b - name: tripItineraryId required: true in: path schema: type: string format: uuid description: Trip itinerary identifier example: 0195e7a1-8b5c-7d3e-9f4a-2c6b8d0e1f3a - 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: $ref: '#/components/schemas/Offering' 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 '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 components: schemas: Offering: type: object properties: tripItineraryId: type: string format: uuid description: Trip itinerary identifier example: 0195e7a1-8b5c-7d3e-9f4a-2c6b8d0e1f3a tripId: type: string format: uuid description: Trip identifier example: 0195e7a1-8b5c-7d3e-9f4a-2c6b8d0e1f3b fromStopId: type: string format: uuid description: Origin stop identifier example: 0195e7a1-8b5c-7d3e-9f4a-2c6b8d0e1f3c toStopId: type: string format: uuid description: Destination stop identifier example: 0195e7a1-8b5c-7d3e-9f4a-2c6b8d0e1f3d price: type: integer description: Price in centavos example: 15000 fromStop: type: object properties: tripStopId: type: string format: uuid description: Trip stop identifier example: 0195e7a1-8b5c-7d3e-9f4a-2c6b8d0e1f3a tripId: type: string format: uuid description: Trip identifier example: 0195e7a1-8b5c-7d3e-9f4a-2c6b8d0e1f3b pointId: type: string format: uuid description: Point identifier example: 0195e7a1-8b5c-7d3e-9f4a-2c6b8d0e1f3c stopOrder: type: integer description: Stop sequence order example: 1 arrivalAt: type: string format: date-time description: Arrival time example: '2026-04-15T10:00:00.000Z' nullable: true departureAt: type: string format: date-time description: Departure time example: '2026-04-15T10:15:00.000Z' nullable: true point: type: object properties: pointId: type: string format: uuid description: Point identifier example: 0195e7a1-8b5c-7d3e-9f4a-2c6b8d0e1f3a name: type: string description: Point name example: São Paulo description: type: string description: Additional description example: Terminal Rodoviário Tietê nullable: true lat: type: number minimum: -90 maximum: 90 description: Latitude example: -23.5155 nullable: true lng: type: number minimum: -180 maximum: 180 description: Longitude example: -46.6254 nullable: true createdAt: type: string format: date-time description: Created at example: '2026-01-01T00:00:00.000Z' updatedAt: type: string format: date-time description: Updated at example: '2026-01-01T00:00:00.000Z' required: - pointId - name - createdAt - updatedAt description: Stop point createdAt: type: string format: date-time description: Created at example: '2026-01-01T00:00:00.000Z' updatedAt: type: string format: date-time description: Updated at example: '2026-01-01T00:00:00.000Z' required: - tripStopId - tripId - pointId - stopOrder - point - createdAt - updatedAt description: Origin stop toStop: type: object properties: tripStopId: type: string format: uuid description: Trip stop identifier example: 0195e7a1-8b5c-7d3e-9f4a-2c6b8d0e1f3a tripId: type: string format: uuid description: Trip identifier example: 0195e7a1-8b5c-7d3e-9f4a-2c6b8d0e1f3b pointId: type: string format: uuid description: Point identifier example: 0195e7a1-8b5c-7d3e-9f4a-2c6b8d0e1f3c stopOrder: type: integer description: Stop sequence order example: 1 arrivalAt: type: string format: date-time description: Arrival time example: '2026-04-15T10:00:00.000Z' nullable: true departureAt: type: string format: date-time description: Departure time example: '2026-04-15T10:15:00.000Z' nullable: true point: type: object properties: pointId: type: string format: uuid description: Point identifier example: 0195e7a1-8b5c-7d3e-9f4a-2c6b8d0e1f3a name: type: string description: Point name example: São Paulo description: type: string description: Additional description example: Terminal Rodoviário Tietê nullable: true lat: type: number minimum: -90 maximum: 90 description: Latitude example: -23.5155 nullable: true lng: type: number minimum: -180 maximum: 180 description: Longitude example: -46.6254 nullable: true createdAt: type: string format: date-time description: Created at example: '2026-01-01T00:00:00.000Z' updatedAt: type: string format: date-time description: Updated at example: '2026-01-01T00:00:00.000Z' required: - pointId - name - createdAt - updatedAt description: Stop point createdAt: type: string format: date-time description: Created at example: '2026-01-01T00:00:00.000Z' updatedAt: type: string format: date-time description: Updated at example: '2026-01-01T00:00:00.000Z' required: - tripStopId - tripId - pointId - stopOrder - point - createdAt - updatedAt description: Destination stop createdAt: type: string format: date-time description: Created at example: '2026-01-01T00:00:00.000Z' updatedAt: type: string format: date-time description: Updated at example: '2026-01-01T00:00:00.000Z' availableSeats: type: integer description: Seats available for this itinerary example: 12 availableSeatsStatus: type: string enum: - AVAILABLE - LIMITED - SOLD_OUT description: Seat availability tier example: AVAILABLE trip: type: object properties: tripId: type: string format: uuid description: Trip identifier example: 0195e7a1-8b5c-7d3e-9f4a-2c6b8d0e1f3a companyId: type: string format: uuid description: Company identifier example: 0195e7a1-8b5c-7d3e-9f4a-2c6b8d0e1f3b routeId: type: string format: uuid description: Route identifier example: 0195e7a1-8b5c-7d3e-9f4a-2c6b8d0e1f3c vehicleId: type: string format: uuid description: Vehicle identifier example: 0195e7a1-8b5c-7d3e-9f4a-2c6b8d0e1f3d driverId: type: string format: uuid description: Driver identifier example: 0195e7a1-8b5c-7d3e-9f4a-2c6b8d0e1f3e status: type: string enum: - SCHEDULED - IN_PROGRESS - COMPLETED - CANCELLED description: Trip status example: SCHEDULED events: type: array items: type: object properties: tripEventId: type: string format: uuid description: Trip event identifier example: 0195e7a1-8b5c-7d3e-9f4a-2c6b8d0e1f3a tripId: type: string format: uuid description: Trip identifier example: 0195e7a1-8b5c-7d3e-9f4a-2c6b8d0e1f3b tripStopId: type: string format: uuid description: Trip stop identifier example: 0195e7a1-8b5c-7d3e-9f4a-2c6b8d0e1f3c nullable: true type: type: string enum: - DRIVER_CHANGED - VEHICLE_CHANGED - DEPARTURE_DELAYED - ARRIVAL_DELAYED - BOARDING_STARTED - BOARDING_COMPLETED - INCIDENT description: Trip event type example: DEPARTURE_DELAYED description: type: string description: Event description example: Departure delayed by 15 minutes due to traffic nullable: true metadata: type: object additionalProperties: {} description: Event metadata nullable: true createdAt: type: string format: date-time description: Created at example: '2026-01-01T00:00:00.000Z' updatedAt: type: string format: date-time description: Updated at example: '2026-01-01T00:00:00.000Z' required: - tripEventId - tripId - type - createdAt - updatedAt description: Trip events departureAt: type: string format: date-time description: Departure time example: '2026-04-15T08:00:00.000Z' estimatedArrivalAt: type: string format: date-time description: Estimated arrival time example: '2026-04-15T14:00:00.000Z' stops: type: array items: type: object properties: tripStopId: type: string format: uuid description: Trip stop identifier example: 0195e7a1-8b5c-7d3e-9f4a-2c6b8d0e1f3a tripId: type: string format: uuid description: Trip identifier example: 0195e7a1-8b5c-7d3e-9f4a-2c6b8d0e1f3b pointId: type: string format: uuid description: Point identifier example: 0195e7a1-8b5c-7d3e-9f4a-2c6b8d0e1f3c stopOrder: type: integer description: Stop sequence order example: 1 arrivalAt: type: string format: date-time description: Arrival time example: '2026-04-15T10:00:00.000Z' nullable: true departureAt: type: string format: date-time description: Departure time example: '2026-04-15T10:15:00.000Z' nullable: true point: type: object properties: pointId: type: string format: uuid description: Point identifier example: 0195e7a1-8b5c-7d3e-9f4a-2c6b8d0e1f3a name: type: string description: Point name example: São Paulo description: type: string description: Additional description example: Terminal Rodoviário Tietê nullable: true lat: type: number minimum: -90 maximum: 90 description: Latitude example: -23.5155 nullable: true lng: type: number minimum: -180 maximum: 180 description: Longitude example: -46.6254 nullable: true createdAt: type: string format: date-time description: Created at example: '2026-01-01T00:00:00.000Z' updatedAt: type: string format: date-time description: Updated at example: '2026-01-01T00:00:00.000Z' required: - pointId - name - createdAt - updatedAt description: Stop point createdAt: type: string format: date-time description: Created at example: '2026-01-01T00:00:00.000Z' updatedAt: type: string format: date-time description: Updated at example: '2026-01-01T00:00:00.000Z' required: - tripStopId - tripId - pointId - stopOrder - point - createdAt - updatedAt description: Trip stops itineraries: type: array items: type: object properties: tripItineraryId: type: string format: uuid description: Trip itinerary identifier example: 0195e7a1-8b5c-7d3e-9f4a-2c6b8d0e1f3a tripId: type: string format: uuid description: Trip identifier example: 0195e7a1-8b5c-7d3e-9f4a-2c6b8d0e1f3b fromStopId: type: string format: uuid description: Origin stop identifier example: 0195e7a1-8b5c-7d3e-9f4a-2c6b8d0e1f3c toStopId: type: string format: uuid description: Destination stop identifier example: 0195e7a1-8b5c-7d3e-9f4a-2c6b8d0e1f3d price: type: integer description: Price in centavos example: 15000 fromStop: type: object properties: tripStopId: type: string format: uuid description: Trip stop identifier example: 0195e7a1-8b5c-7d3e-9f4a-2c6b8d0e1f3a tripId: type: string format: uuid description: Trip identifier example: 0195e7a1-8b5c-7d3e-9f4a-2c6b8d0e1f3b pointId: type: string format: uuid description: Point identifier example: 0195e7a1-8b5c-7d3e-9f4a-2c6b8d0e1f3c stopOrder: type: integer description: Stop sequence order example: 1 arrivalAt: type: string format: date-time description: Arrival time example: '2026-04-15T10:00:00.000Z' nullable: true departureAt: type: string format: date-time description: Departure time example: '2026-04-15T10:15:00.000Z' nullable: true point: type: object properties: pointId: type: string format: uuid description: Point identifier example: 0195e7a1-8b5c-7d3e-9f4a-2c6b8d0e1f3a name: type: string description: Point name example: São Paulo description: type: string description: Additional description example: Terminal Rodoviário Tietê nullable: true lat: type: number minimum: -90 maximum: 90 description: Latitude example: -23.5155 nullable: true lng: type: number minimum: -180 maximum: 180 description: Longitude example: -46.6254 nullable: true createdAt: type: string format: date-time description: Created at example: '2026-01-01T00:00:00.000Z' updatedAt: type: string format: date-time description: Updated at example: '2026-01-01T00:00:00.000Z' required: - pointId - name - createdAt - updatedAt description: Stop point createdAt: type: string format: date-time description: Created at example: '2026-01-01T00:00:00.000Z' updatedAt: type: string format: date-time description: Updated at example: '2026-01-01T00:00:00.000Z' required: - tripStopId - tripId - pointId - stopOrder - point - createdAt - updatedAt description: Origin stop toStop: type: object properties: tripStopId: type: string format: uuid description: Trip stop identifier example: 0195e7a1-8b5c-7d3e-9f4a-2c6b8d0e1f3a tripId: type: string format: uuid description: Trip identifier example: 0195e7a1-8b5c-7d3e-9f4a-2c6b8d0e1f3b pointId: type: string format: uuid description: Point identifier example: 0195e7a1-8b5c-7d3e-9f4a-2c6b8d0e1f3c stopOrder: type: integer description: Stop sequence order example: 1 arrivalAt: type: string format: date-time description: Arrival time example: '2026-04-15T10:00:00.000Z' nullable: true departureAt: type: string format: date-time description: Departure time example: '2026-04-15T10:15:00.000Z' nullable: true point: type: object properties: pointId: type: string format: uuid description: Point identifier example: 0195e7a1-8b5c-7d3e-9f4a-2c6b8d0e1f3a name: type: string description: Point name example: São Paulo description: type: string description: Additional description example: Terminal Rodoviário Tietê nullable: true lat: type: number minimum: -90 maximum: 90 description: Latitude example: -23.5155 nullable: true lng: type: number minimum: -180 maximum: 180 description: Longitude example: -46.6254 nullable: true createdAt: type: string format: date-time description: Created at example: '2026-01-01T00:00:00.000Z' updatedAt: type: string format: date-time description: Updated at example: '2026-01-01T00:00:00.000Z' required: - pointId - name - createdAt - updatedAt description: Stop point createdAt: type: string format: date-time description: Created at example: '2026-01-01T00:00:00.000Z' updatedAt: type: string format: date-time description: Updated at example: '2026-01-01T00:00:00.000Z' required: - tripStopId - tripId - pointId - stopOrder - point - createdAt - updatedAt description: Destination stop createdAt: type: string format: date-time description: Created at example: '2026-01-01T00:00:00.000Z' updatedAt: type: string format: date-time description: Updated at example: '2026-01-01T00:00:00.000Z' required: - tripItineraryId - tripId - fromStopId - toStopId - price - fromStop - toStop - createdAt - updatedAt description: Trip itineraries createdAt: type: string format: date-time description: Created at example: '2026-01-01T00:00:00.000Z' updatedAt: type: string format: date-time description: Updated at example: '2026-01-01T00:00:00.000Z' required: - tripId - companyId - routeId - vehicleId - driverId - status - events - departureAt - estimatedArrivalAt - stops - itineraries - createdAt - updatedAt description: Trip required: - tripItineraryId - tripId - fromStopId - toStopId - price - fromStop - toStop - createdAt - updatedAt - availableSeats - availableSeatsStatus - trip description: Trip itinerary offering ````