> ## Documentation Index
> Fetch the complete documentation index at: https://docs.onefirewall.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Files by TS



## OpenAPI

````yaml get /files
openapi: 3.0.2
info:
  title: OneFirewall Alliance - OpenAPI 3.0
  description: >-
    The API documentation site serves as a comprehensive resource for developers
    looking to utilize the OneFirewall Platform's application programming
    interface (API). It offers in-depth information on API endpoints,
    parameters, responses, and authentication processes. Additionally, it
    features practical examples and code snippets to assist developers in
    integrating the API into their own applications. The website is crafted to
    be user-friendly, intuitive, and easily navigable, enabling developers to
    swiftly locate the necessary information to begin working with the API.
  termsOfService: https://onefirewall.com/eula.html
  contact:
    email: support@onefirewall.com
    url: https://onefirewall.com/contact.html
    name: Engineering Division
  license:
    name: ''
    url: ''
  version: V4.18.0
servers:
  - url: https://app.onefirewall.com/api/v1
    description: OneFirewall Server
    variables: {}
security: []
tags:
  - name: IPv4 Feeds
    description: ''
    externalDocs:
      description: ''
      url: ''
  - name: IoCs
    description: ''
    externalDocs:
      description: ''
      url: ''
  - name: Tools
    description: ''
    externalDocs:
      description: ''
      url: ''
  - name: URL Feeds
    description: ''
    externalDocs:
      description: ''
      url: ''
  - name: Domain Feeds
    description: ''
    externalDocs:
      description: ''
      url: ''
  - name: Security Binary Feeds
    description: ''
    externalDocs:
      description: ''
      url: ''
  - name: Secure VPN
    description: Secure VPN by OneFirewall
    externalDocs:
      description: ''
      url: ''
  - name: WCF Agent
    description: ''
    externalDocs:
      description: ''
      url: ''
externalDocs:
  description: http://docs.onefirewall.com
  url: http://app.onefirewall.com
paths:
  /files:
    parameters: []
    get:
      tags:
        - Security Binary Feeds
      summary: Files by TS
      operationId: Retrieve the latest malicious files recorded
      parameters:
        - in: query
          name: ts
          description: Latest updates starting from this timestamp
          schema:
            type: number
          required: true
        - in: query
          name: page_size
          description: Maximum size to return
          schema:
            type: number
            default: 101
            exclusiveMinimum: true
            minimum: 100
            exclusiveMaximum: true
            maximum: 2000
          required: false
        - in: query
          name: min_score
          description: Filter based on minimum score
          schema:
            type: number
            exclusiveMinimum: true
            minimum: 0
            exclusiveMaximum: true
            maximum: 1000
            default: 1
        - in: query
          name: file_type
          description: Filter based on file type
          schema:
            type: string
        - in: query
          name: file_name
          description: Filter based on file name
          schema:
            type: string
        - in: query
          name: "tags\t"
          description: >-
            Array of strings separated by ‘,’ to return documents that contain
            at least one of the tags provided (default none)
          schema:
            type: array
            items:
              type: string
            minItems: 0
            maxItems: 100
            uniqueItems: true
      responses:
        '200':
          description: The request was received and processed successfully
          headers: {}
          content:
            application/json:
              schema:
                type: string
              examples:
                example1:
                  value:
                    header:
                      type: Malware
                      version: 4
                      ts: 1693519200
                      next_ts: 1693519490
                      page_size: 100
                      user:
                        guid: OFA-GUID-YORP-4193-FDFM
                        name: NAME
                        surname: Surname
                        username: name.surname@domain.com
                        role: 0
                        unsuccessful_login: 0
                        member_of:
                          gid: OFA-GID-dsfgdsfgfdj
                          name: Org1
                          trust: 0.85
                          delay: '0'
                          credit_tokens: 2000000000
                          debit_tokens: 1888915
                    body:
                      - md5: B3A5311FB0E11953EBD765D4231776EE
                        sha1: EE727E0FFE780EC24609B9FCCA8512ADE671E2D5
                        sha256: >-
                          15678297D3D6DA1D77C9B5C7B479F5C3C922D739C42CA00641F3D3587A829970
                        score: 96
                        ts: 1693519331
                        file_bytes: null
                        total_reports: 47
                        total_members: 1
                        file_type: application/x-executable
                        file_name: b3a5311fb0e11953ebd765d4231776ee
                        tags:
                          - n/a
                          - elf
                        elk_ts: '2023-08-31T22:02:11.000Z'
                        elk_entry_ts: '2023-08-30T00:03:23.000Z'
                        entry_ts: 1693353803
                      - md5: 947F536E12836C13CFC73638B796471D
                        sha1: F478B6E4653C4620AF43841CC1F0227BC79F3ADB
                        sha256: >-
                          1AE54CBDE48D74B3312771FCDB51E672CD0D60F737FA5FE09F9C83597B8A3B5F
                        score: 96
                        ts: 1693519331
                        file_bytes: null
                        total_reports: 47
                        total_members: 1
                        file_type: application/x-executable
                        file_name: 947f536e12836c13cfc73638b796471d
                        tags:
                          - n/a
                          - elf
                          - Gafgyt
                        elk_ts: '2023-08-31T22:02:11.000Z'
                        elk_entry_ts: '2023-08-30T00:03:23.000Z'
                        entry_ts: 1693353803
                      - md5: 9D6980C593C635DE0E0A37224272924D
                        sha1: 2EEA6F42D295AC7CEEB7FF079B99ADBB698C321F
                        sha256: >-
                          DE895366E2FB48A164C45082928A4AF3D08969A5218F8B9581455635F7922876
                        score: 96
                        ts: 1693519331
                        file_bytes: null
                        total_reports: 47
                        total_members: 1
                        file_type: application/x-executable
                        file_name: 9d6980c593c635de0e0a37224272924d
                        tags:
                          - n/a
                          - elf
                        elk_ts: '2023-08-31T22:02:11.000Z'
                        elk_entry_ts: '2023-08-30T00:03:23.000Z'
                        entry_ts: 1693353803
      security:
        - Authorization: []
components:
  securitySchemes:
    Authorization:
      type: apiKey
      in: header
      description: Authorization Token
      name: Authorization

````