---
title: "Search Files (POST) (Deprecated)"
method: POST
path: "/v1/fileinfo/search"
tags: ["Search"]
---

# Search Files (POST) (Deprecated)

`POST /v1/fileinfo/search`

🚧 IMPORTANT The Search Files (POST) endpoint is on a deprecation path and does not support searching for files by metadata. It's recommended that you use the [/searchEql endpoint](<https://developers.tetrascience.com/reference/dl-fi-dl-search-files-via-elasticsearch-query>) instead. For more information, see [Search Files, Search Workflow, and Paginate through All Pipeline Details API Endpoints Deprecation](<https://developers.tetrascience.com/docs/tdp-deprecation-notices#search-files-search-workflow-and-paginate-through-all-pipeline-details-api-endpoints-deprecation>).

## Request body

- object
  - `category` string — Returns information on files from the RAW, IDS, or PROCESSED categories.
  - `from` integer — Display files started from specified number in the results array. By default, files are displayed from the start of the array (the number 0). This parameter is included if the result set is large, pagination might be required. This parameter is typically used in conjunction with size.
  - `fromDate` string, date — Search for files created on or after a specific date.
  - `excludeTags` string[] — Exclude files that have the specified tags from the search results.
  - `ids` string — Returns files that match the IDS schema.
  - `integrationId` string — Returns files that match the specified ID for the integration.
  - `integrationType` string — Returns files that are of the specified integration type. Types include: EGNYTE, BOX, DOTMATICS, HRB CELLARIO, DATAHUB, PIPELINE, RAW, and API.
  - `metadata` object — Search for files that have specific metadata.
  - `pipelineId` string — Returns information about files that match the pipeline file ID.
  - `rawFileId` string — Returns information about files that match the RAW file ID.
  - `size` integer — Indicates the number of results to return in the request. This parameter is included if the result set is large, pagination might be required. This parameter is typically used in conjunction with from.
  - `sort` string — Indicates the sort order for the search results. Sort occurs on the date (createAt timestamp, which occurred when the file was created in the data lake. Options: desc, asc
  - `sourceId` string — Returns files that match the specified ID for the source (typically an instrument that generated the RAW file).
  - `sourceType` string — Returns files that match the specified type of source. This is typically the name of an instrument.
  - `tags` string[] — Include files that have the specified tags in the search results.
  - `toDate` string, date — Search for files created on or before a specific date.
  - `traceId` string — Returns information about files that match the ID number generated when the RAW file is first uploaded to the data lake. To maintain traceability, all files derived from the RAW file, such as the IDS file, have the same traceId.
  - `workflowId` string — **(Added in TDP 3.1.0)** ID of the pipeline workflow.

## Response `200`

200

- object
  - `from` integer
  - `size` integer
  - `sort` string
  - `hasNext` boolean
  - `hits` object[]
    - `fileId` string
    - `filePath` string
    - `orgSlug` string
    - `traceId` string
    - `file` object
      - `bucket` string
      - `path` string
      - `checksum` string
      - `size` integer
      - `type` unknown
      - `version` string
    - `createdAt` string
    - `category` string
    - `integration` object
      - `id` string
      - `type` string
      - `name` string
      - `workflowId` string
      - `masterScript` string
      - `taskScript` string
      - `taskSlug` string
      - `taskExecutionId` string
    - `source` object
      - `id` string
      - `type` string
      - `name` string
      - `datapipeline` object
        - `workflowId` string
        - `taskExecutionId` string
        - `taskSlug` string
        - `taskScript` string
        - `masterScript` string
        - `inputFileId` string
    - `rawFileId` string
    - `ids` string
    - `metadata` object
      - `Version` string
      - `CREATED_FOR` string
      - `cheeeng` string
    - `tags` string[]
    - `deleted` boolean
    - `outdated` boolean

## Other responses

- `401` — 401
- `500` — 500

---

[API](https://skmtc.net/tetrascience/apis/tetra-data-lake.md) · [All operations](https://skmtc.net/tetrascience/apis/tetra-data-lake/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tetrascience/tetra-data-lake/versions/0205e2bace53/schema)