> ## Documentation Index > Fetch the complete documentation index at: https://docs.vinmake.com/llms.txt > Use this file to discover all available pages before exploring further. # List all RFQs with pagination > Retrieve a paginated list of RFQs with filtering, sorting, and search capabilities. **Query Parameters:** - `page`: Page number (default: 1) - `limit`: Items per page (default: 10, max: 100) - `status`: Filter by RFQ status - `sort`: Sort field (prefix with `-` for descending, e.g., `-created_at`) - `search`: Search in document_id **Available Status Values:** - Draft - Submitted - Work in progress - Partially approved - Approved - Rejected **Sort Fields:** - `created_at` (default: `-created_at` - newest first) - `planned_response_date` - `document_id` - `status` **Examples:** - Get first page: `GET /rfqs` - Filter by status: `GET /rfqs?status=Submitted` - Search: `GET /rfqs?search=vin_RFQ_0001` - Sort by date ascending: `GET /rfqs?sort=created_at` - Combine filters: `GET /rfqs?status=Submitted&page=2&limit=20&sort=-created_at` ## OpenAPI ````yaml /api/openapi-cutmake.json get /api/v1/rfqs openapi: 3.1.0 info: title: VM App API version: 0.1.0 servers: - url: https://vinmake-erp.onrender.com security: [] paths: /api/v1/rfqs: get: tags: - RFQs summary: List all RFQs with pagination description: >- Retrieve a paginated list of RFQs with filtering, sorting, and search capabilities. **Query Parameters:** - `page`: Page number (default: 1) - `limit`: Items per page (default: 10, max: 100) - `status`: Filter by RFQ status - `sort`: Sort field (prefix with `-` for descending, e.g., `-created_at`) - `search`: Search in document_id **Available Status Values:** - Draft - Submitted - Work in progress - Partially approved - Approved - Rejected **Sort Fields:** - `created_at` (default: `-created_at` - newest first) - `planned_response_date` - `document_id` - `status` **Examples:** - Get first page: `GET /rfqs` - Filter by status: `GET /rfqs?status=Submitted` - Search: `GET /rfqs?search=vin_RFQ_0001` - Sort by date ascending: `GET /rfqs?sort=created_at` - Combine filters: `GET /rfqs?status=Submitted&page=2&limit=20&sort=-created_at` operationId: list_rfqs_api_v1_rfqs_get parameters: - name: page in: query required: false schema: type: integer minimum: 1 description: Page number default: 1 title: Page description: Page number - name: limit in: query required: false schema: type: integer maximum: 100 minimum: 1 description: Items per page default: 10 title: Limit description: Items per page - name: status in: query required: false schema: type: string description: Filter by status title: Status description: Filter by status - name: sort in: query required: false schema: type: string description: Sort field (e.g., '-created_at') title: Sort description: Sort field (e.g., '-created_at') - name: search in: query required: false schema: type: string description: Search in document_id title: Search description: Search in document_id responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/PaginatedRFQListResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' security: - OAuth2PasswordBearer: [] components: schemas: PaginatedRFQListResponse: properties: data: items: $ref: '#/components/schemas/ListAllRFQResponse' type: array title: Data pagination: $ref: '#/components/schemas/schemas__rfq__PaginationMetadata' type: object required: - data - pagination title: PaginatedRFQListResponse description: Paginated response for RFQ list example: data: - client_id: client-uuid-123 client_name: Acme Corp created_at: '2026-01-27T10:00:00' document_id: vin_RFQ_0001 pic_id: user-uuid-456 pic_name: John Doe planned_response_date: '2026-02-15' status: Submitted pagination: hasNext: true hasPrev: false limit: 10 page: 1 total: 25 totalPages: 3 HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError ListAllRFQResponse: properties: document_id: type: string title: Document Id client_id: anyOf: - type: string - type: 'null' title: Client Id client_name: anyOf: - type: string - type: 'null' title: Client Name pic_id: anyOf: - type: string - type: 'null' title: Pic Id pic_name: anyOf: - type: string - type: 'null' title: Pic Name created_at: type: string format: date-time title: Created At planned_response_date: anyOf: - type: string format: date - type: 'null' title: Planned Response Date status: type: string enum: - Draft - Submitted - In Progress - Quoted - Accepted - Rejected - Expired - Canceled title: Status type: object required: - document_id - created_at - status title: ListAllRFQResponse description: Response schema for individual RFQ in list example: client_id: uuid-123 client_name: Acme Corp created_at: '2026-01-27T10:00:00' document_id: vin_RFQ_0001 pic_id: uuid-456 pic_name: John Doe planned_response_date: '2026-02-15' status: Submitted schemas__rfq__PaginationMetadata: properties: page: type: integer title: Page limit: type: integer title: Limit total: type: integer title: Total totalPages: type: integer title: Totalpages hasNext: type: boolean title: Hasnext hasPrev: type: boolean title: Hasprev type: object required: - page - limit - total - totalPages - hasNext - hasPrev title: PaginationMetadata description: Pagination metadata ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type input: title: Input ctx: type: object title: Context type: object required: - loc - msg - type title: ValidationError securitySchemes: OAuth2PasswordBearer: type: oauth2 flows: password: scopes: {} tokenUrl: /auth/login ````