> ## 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 Benefit Requests > Lists benefit requests. ## OpenAPI ````yaml /api-reference/customer/openapi.json get /api/v1/customer/benefits/requests 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/benefits/requests: get: tags: - Benefit Request summary: List Benefit Requests description: Lists benefit requests. operationId: listCustomerBenefitRequests parameters: - name: limit in: query required: false schema: type: number default: 10 minimum: 1 maximum: 100 description: Items per page. - name: page in: query required: false schema: type: number default: 1 minimum: 1 description: Page number. - name: fareBenefitProgramId in: query required: false schema: type: string format: uuid description: Fare benefit program identifier. - name: status in: query required: false schema: type: string enum: - PENDING - IN_REVIEW - APPROVED - REJECTED - CANCELED - EXPIRED description: Request status. - name: sortBy in: query required: false schema: type: string enum: - createdAt - reviewedAt default: createdAt description: Field to sort by. - name: sortOrder in: query required: false schema: type: string enum: - asc - desc default: desc description: Sort direction. - name: fields in: query required: false description: >- Comma-separated list of fields to include in the response. Supports dot notation. schema: type: string responses: '200': description: OK content: application/json: schema: type: object properties: data: type: array items: $ref: '#/components/schemas/PassengerBenefitRequest' meta: $ref: '#/components/schemas/PageMeta' required: - data - meta '400': $ref: '#/components/responses/BadRequestError' '401': $ref: '#/components/responses/UnauthorizedError' '500': $ref: '#/components/responses/InternalServerError' components: schemas: PassengerBenefitRequest: type: object properties: passengerBenefitRequestId: type: string format: uuid description: Identificador único customerId: type: string format: uuid description: Cliente/passageiro solicitante fareBenefitProgramId: type: string format: uuid description: Programa de benefício solicitado requestedByUserId: type: string format: uuid description: Usuário que abriu a solicitação reviewedByUserId: type: string format: uuid nullable: true description: Usuário que analisou a solicitação code: type: string description: Código legível da solicitação notes: type: string nullable: true description: Observações informadas pelo passageiro rejectionReason: type: string nullable: true description: Motivo de rejeição, quando aplicável status: type: string enum: - PENDING - IN_REVIEW - APPROVED - REJECTED - CANCELED - EXPIRED description: Status atual da solicitação validFrom: type: string format: date-time nullable: true description: Início da validade do benefício aprovado validUntil: type: string format: date-time nullable: true description: Fim da validade do benefício aprovado reviewedAt: type: string format: date-time nullable: true description: Data de análise da solicitação 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 lógica required: - passengerBenefitRequestId - customerId - fareBenefitProgramId - requestedByUserId - reviewedByUserId - code - notes - rejectionReason - status - validFrom - validUntil - reviewedAt - createdBy - createdAt - updatedBy - updatedAt - deletedBy - deletedAt description: Solicitação de gratuidade ou desconto feita por um passageiro 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. ValidationError: type: object properties: statusCode: type: integer description: HTTP status code. example: 400 message: type: string description: Error message. example: Bad Request Error errors: type: array items: type: object properties: code: type: string description: Validation code. example: invalid_type message: type: string description: Validation message. example: Required path: type: string description: Invalid field path. example: name required: - code - message - path required: - statusCode - message - errors description: Validation error response. ApiError: type: object properties: statusCode: type: integer description: HTTP status code. example: 404 error: type: string description: HTTP error name. example: Not Found message: type: string description: Machine-readable error code. example: resource.not_found required: - statusCode - error - message description: Domain error response. responses: BadRequestError: description: Validation failed. content: application/json: schema: $ref: '#/components/schemas/ValidationError' UnauthorizedError: description: Authentication required. content: application/json: schema: $ref: '#/components/schemas/ApiError' InternalServerError: description: Internal server error. content: application/json: schema: $ref: '#/components/schemas/ApiError' ````