> ## Documentation Index > Fetch the complete documentation index at: https://docs.payfi.global/llms.txt > Use this file to discover all available pages before exploring further. # List FX operations > Lists operations scoped to the signed partner integration. Supports exact ID filters, search terms, status filters, and page-based pagination. ## OpenAPI ````yaml /openapi/payfi-v1.json get /v1/operations openapi: 3.0.0 info: title: PayFi Partner API description: >- Partner API for PayFi compliance document automation. Dashboard Partner access is the admin role for exactly one partner integration; public API requests remain authenticated with signed partner API keys. version: 0.1.0 contact: {} servers: - url: https://sandbox.payfi.global description: Sandbox - url: https://api.payfi.global description: Production security: [] tags: - name: Customers description: Signed partner endpoints for customer records. - name: Operations description: Signed partner endpoints for operations, documents, and upload completion. - name: Webhooks description: Partner-managed webhook endpoints and signed callback tests. paths: /v1/operations: get: tags: - Operations summary: List FX operations description: >- Lists operations scoped to the signed partner integration. Supports exact ID filters, search terms, status filters, and page-based pagination. operationId: PartnerApiController_listOperations parameters: - name: operationId in: query required: false description: Exact PayFi operation ID filter. schema: type: string example: op_example - name: partnerOperationId in: query required: false description: Exact partner operation ID filter. schema: type: string example: acme-op-123 - name: customerId in: query required: false description: Exact PayFi customer ID filter. schema: type: string example: cus_example - name: search in: query required: false description: >- Searches operation IDs, partner operation IDs, customer IDs, customer legal names, partner customer IDs, status fields, and operation type aliases such as Importação. schema: type: string example: Acme - name: page in: query required: false description: Page number starting at 1. schema: type: integer minimum: 1 example: 1 - name: limit in: query required: false description: Items per page. Maximum 100. schema: type: integer minimum: 1 maximum: 100 example: 20 responses: '200': description: Paginated operations. content: application/json: schema: $ref: '#/components/schemas/OperationListResponse' examples: firstPage: value: data: - operationId: op_example partnerOperationId: acme-op-123 customerId: cus_example status: REQUIREMENTS_REVIEW_REQUIRED operationType: IMPORT_GOODS exchangeModality: TERM requirementsStatus: REVIEW_REQUIRED requiredDocumentTypes: [] missingDocumentTypes: [] score0To100: null riskLevel: null createdAt: '2026-05-20T12:00:00.000Z' updatedAt: '2026-05-20T12:00:00.000Z' pagination: page: 1 limit: 20 total: 1 totalPages: 1 hasNextPage: false hasPreviousPage: false '400': description: Invalid request. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: invalidRequest: value: error: code: INVALID_REQUEST message: The request payload is invalid. '401': description: Authentication failed. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: unauthorized: value: error: code: UNAUTHORIZED message: Authentication failed. security: - PayFiApiKey: [] PayFiNonce: [] PayFiSignature: [] components: schemas: OperationListResponse: type: object properties: data: type: array items: $ref: '#/components/schemas/OperationListItem' example: [] pagination: $ref: '#/components/schemas/Pagination' required: - data - pagination ErrorResponse: type: object properties: error: type: object properties: code: type: string example: INVALID_SIGNATURE message: type: string example: The request signature is invalid. OperationListItem: type: object properties: operationId: type: string example: op_example partnerOperationId: type: string nullable: true example: acme-op-123 customerId: type: string nullable: true example: cus_example customerLegalName: type: string nullable: true example: Acme Ltda partnerCustomerId: type: string nullable: true example: acme-customer-123 status: type: string enum: - CREATED - REQUIREMENTS_PENDING - REQUIREMENTS_REVIEW_REQUIRED - REQUIREMENTS_FAILED - AWAITING_DOCUMENTS - DOCUMENTS_PARTIAL - DOCUMENTS_UPLOADED - PROCESSING - PROCESSING_FAILED - ACTION_REQUIRED - READY_FOR_MANUAL_REVIEW - MANUAL_REVIEW_APPROVED - MANUAL_REVIEW_REJECTED - MANUAL_REVIEW_CHANGES_REQUESTED - PARTNER_CALLBACK_PENDING - PARTNER_CALLBACK_DELIVERED - PARTNER_CALLBACK_FAILED - CANCELLED - FAILED example: REQUIREMENTS_REVIEW_REQUIRED operationType: type: string enum: - IMPORT_GOODS - EXPORT_GOODS - SERVICES nullable: true example: IMPORT_GOODS exchangeModality: type: string enum: - ADVANCE - SIGHT - TERM nullable: true example: TERM requirementsStatus: type: string enum: - PENDING - REVIEW_REQUIRED - APPROVED - FAILED example: REVIEW_REQUIRED requiredDocumentTypes: type: array items: type: string enum: - invoice - bill_of_lading - packing_list - di_duimp - bank_details - proforma - service_contract - insurance_policy example: invoice example: - invoice - bill_of_lading - packing_list missingDocumentTypes: type: array items: type: string enum: - invoice - bill_of_lading - packing_list - di_duimp - bank_details - proforma - service_contract - insurance_policy example: invoice example: - invoice score0To100: type: number nullable: true example: null score1To10: type: number nullable: true example: null riskLevel: type: string enum: - low - medium - high - critical - unknown nullable: true example: null declaredBeneficiaryName: type: string nullable: true example: Shenzhen NovaTech Components Co Ltd declaredEconomicOwnerName: type: string nullable: true example: Shenzhen NovaTech Components Co Ltd buyerCountry: type: string nullable: true example: BR createdAt: type: string example: '2026-05-20T12:00:00.000Z' updatedAt: type: string example: '2026-05-20T12:00:00.000Z' Pagination: type: object properties: page: type: number example: 1 limit: type: number example: 20 total: type: number example: 1 totalPages: type: number example: 1 hasNextPage: type: boolean example: false hasPreviousPage: type: boolean example: false required: - page - limit - total - totalPages - hasNextPage - hasPreviousPage securitySchemes: PayFiApiKey: type: apiKey in: header name: X-PayFi-Api-Key PayFiNonce: type: apiKey in: header name: X-PayFi-Nonce PayFiSignature: type: apiKey in: header name: X-PayFi-Signature ````