> ## Documentation Index > Fetch the complete documentation index at: https://developer.finogates.com/llms.txt > Use this file to discover all available pages before exploring further. # List Submitted Files > List files you have submitted, newest first. Never includes a download link, at any status — fetch one file at a time for that. Signing a URL per row would put a live credential in a response that is far more likely to be logged whole than a single-file read. ## OpenAPI ````yaml GET /v1/platform/file-scans openapi: 3.1.0 info: title: Finogate Platform API v1 version: 0.1.0 servers: - url: https://api-sandbox.finogates.com description: Sandbox - url: https://api.finogates.com description: Production security: [] tags: - name: auth - name: users - name: payees - name: verification - name: bank accounts - name: card processing - name: digital-assets - name: international - name: fees - name: onboarding - name: pending-applications - name: wallets - name: payments - name: document mailing - name: merchant onboarding - name: catalog - name: webhooks - name: screening - name: Platform - File Scanning - name: phone-numbers - name: sms - name: calls - name: listings - name: Card Transfers - name: embed-tokens paths: /v1/platform/file-scans: get: tags: - Platform - File Scanning summary: List Submitted Files description: >- List files you have submitted, newest first. Never includes a download link, at any status — fetch one file at a time for that. Signing a URL per row would put a live credential in a response that is far more likely to be logged whole than a single-file read. operationId: list_submitted_files_v1_platform_file_scans_get parameters: - name: status in: query required: false schema: anyOf: - type: string - type: 'null' description: pending | clean | infected | unscannable | error title: Status description: pending | clean | infected | unscannable | error - name: category in: query required: false schema: anyOf: - type: string - type: 'null' title: Category - name: limit in: query required: false schema: type: integer maximum: 200 minimum: 1 title: Limit default: 50 - name: offset in: query required: false schema: type: integer minimum: 0 title: Offset default: 0 responses: '200': description: >- A page of files you have submitted, newest first. Never carries a link. content: application/json: schema: $ref: '#/components/schemas/ListResponse_list_FileScanRead__' example: status_code: 200 data: - id: 8d5e3f2b-9c4a-4e7d-8b2f-6a3c4d5e6f70 status: pending file_name: id-scan.jpg content_type: image/jpeg declared_content_type: image/jpeg size_bytes: 91840 category: contracts created_at: '2026-06-02T10:31:00Z' row_count: 1 query_generated_time: 1712847600000 '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' security: - _AuthenticatedBearer: [] components: schemas: ListResponse_list_FileScanRead__: properties: status_code: type: integer title: Status Code description: HTTP status code for the response. data: items: $ref: '#/components/schemas/FileScanRead' type: array title: Data description: Payload or error details. query_generated_time: type: integer title: Query Generated Time description: >- UTC timestamp (milliseconds since epoch) when response was generated. row_count: type: integer minimum: 0 title: Row Count description: Total rows matching the request filters (not just this page). limit: anyOf: - type: integer minimum: 1 - type: 'null' title: Limit description: >- Page size used for this response. Null for cursor-paginated endpoints. current_page: anyOf: - type: integer minimum: 1 - type: 'null' title: Current Page description: >- 1-indexed page number for this response. Null for cursor-paginated endpoints. total_page_number: anyOf: - type: integer minimum: 0 - type: 'null' title: Total Page Number description: >- Total number of pages given the current limit. Null for cursor-paginated endpoints. next_cursor: anyOf: - type: string - type: 'null' title: Next Cursor description: Cursor for the next page, if available. type: object required: - status_code - data - query_generated_time - row_count title: ListResponse[list[FileScanRead]] HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError FileScanRead: properties: id: type: string format: uuid title: Id description: Use this to fetch the file or match a webhook. status: type: string title: Status description: >- 'pending' (no verdict yet), 'clean', 'infected', 'unscannable' (we could not scan it -- which is not the same as safe), or 'error'. file_name: type: string title: File Name content_type: anyOf: - type: string - type: 'null' title: Content Type description: >- The type derived from the bytes where we could identify them, which is not necessarily the type that was declared on upload. declared_content_type: anyOf: - type: string - type: 'null' title: Declared Content Type description: What the uploader said it was. size_bytes: anyOf: - type: integer - type: 'null' title: Size Bytes category: anyOf: - type: string - type: 'null' title: Category description: The label supplied at upload, for your own grouping. created_at: type: string format: date-time title: Created At scanned_at: anyOf: - type: string format: date-time - type: 'null' title: Scanned At description: Null until a verdict lands. download_url: anyOf: - type: string - type: 'null' title: Download Url description: >- Short-lived download link. Present ONLY on a clean file and only on the single-file read -- never on the list, and never in a webhook. expires_in: anyOf: - type: integer - type: 'null' title: Expires In description: Seconds until ``download_url`` stops working. type: object required: - id - status - file_name - created_at title: FileScanRead description: One submitted file and its scan verdict. ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type type: object required: - loc - msg - type title: ValidationError securitySchemes: _AuthenticatedBearer: type: oauth2 flows: password: scopes: {} tokenUrl: /v1/platform/auth/token ````