> ## 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 Request Documents > Lists benefit request documents. ## OpenAPI ````yaml /api-reference/ops/openapi.json get /api/v1/ops/benefits/requests/{passengerBenefitRequestId}/documents openapi: 3.0.0 info: title: OABUS OPS API description: OABUS API version: '1.0' contact: {} servers: [] security: [] tags: [] paths: /api/v1/ops/benefits/requests/{passengerBenefitRequestId}/documents: get: tags: - Benefit summary: List Benefit Request Documents description: Lists benefit request documents. operationId: listBenefitDocumentValidations parameters: - name: passengerBenefitRequestId required: true in: path schema: type: string format: uuid description: Benefit request identifier example: 0197f712-8a7e-7a53-9d28-51f8f3c77d41 - 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: status required: false in: query schema: type: string enum: - PENDING - APPROVED - REJECTED - EXPIRED description: Benefit document validation status example: PENDING - name: sortBy required: false in: query schema: default: createdAt description: Field to sort by example: createdAt type: string enum: - createdAt - validatedAt - 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': $ref: '#/components/responses/ListBenefitDocumentValidations200Response' '400': $ref: '#/components/responses/ListBenefitDocumentValidations400Response' '401': $ref: '#/components/responses/ListBenefitDocumentValidations401Response' '403': $ref: '#/components/responses/ListBenefitDocumentValidations403Response' '500': $ref: '#/components/responses/ListBenefitDocumentValidations500Response' security: - bearer: [] - bearer: [] components: responses: ListBenefitDocumentValidations200Response: content: application/json: schema: type: object properties: data: type: array items: type: object properties: benefitDocumentValidationId: type: string format: uuid description: Benefit document validation identifier example: 0197f713-cd5f-77d9-b8d5-9751e96f2b39 passengerBenefitRequestId: type: string format: uuid description: Benefit request identifier example: 0197f712-8a7e-7a53-9d28-51f8f3c77d41 customerId: type: string format: uuid description: Customer identifier example: 0197a7f6-4d36-7c0a-a7cb-54fcb33a3148 validatedByUserId: description: Validating user identifier example: null nullable: true type: string format: uuid documentType: type: string description: Document type example: STUDENT_ID storageKey: type: string description: Storage object key example: benefits/0197f712/student-id.pdf fileName: type: string description: Original file name example: student-id.pdf contentType: type: string description: File MIME type example: application/pdf status: type: string enum: - PENDING - APPROVED - REJECTED - EXPIRED description: Benefit document validation status example: PENDING rejectionReason: description: Rejection reason example: null nullable: true type: string createdBy: description: Created by example: null nullable: true type: string format: uuid updatedBy: description: Updated by example: null nullable: true type: string format: uuid deletedBy: description: Deleted by example: null nullable: true type: string format: uuid createdAt: type: string format: date-time description: Created at example: '2026-07-04T11:35:00.000Z' deletedAt: description: Deleted at example: null nullable: true type: string format: date-time expiresAt: description: Expiration date example: null nullable: true type: string format: date-time updatedAt: type: string format: date-time description: Updated at example: '2026-07-04T11:55:00.000Z' validatedAt: description: Validated at example: null nullable: true type: string format: date-time required: - benefitDocumentValidationId - passengerBenefitRequestId - customerId - documentType - storageKey - fileName - contentType - status - createdAt - updatedAt additionalProperties: false description: Benefit document validation meta: type: object properties: limit: type: number description: Items per page example: 10 page: type: number description: Current page example: 1 totalItems: type: number description: Total items example: 100 totalPages: type: number description: Total pages example: 10 required: - limit - page - totalItems - totalPages additionalProperties: false required: - data - meta additionalProperties: false description: List benefit documents description: OK ListBenefitDocumentValidations400Response: 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 ListBenefitDocumentValidations401Response: 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 ListBenefitDocumentValidations403Response: content: application/json: example: message: Insufficient permissions statusCode: 403 schema: properties: message: type: string statusCode: enum: - 403 type: number required: - message - statusCode type: object description: Forbidden ListBenefitDocumentValidations500Response: 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 securitySchemes: bearer: scheme: bearer bearerFormat: JWT type: http ````