---
title: "POST /hepsub/search"
method: POST
path: "/hepsub/search"
tags: ["hep"]
---

# POST /hepsub/search

`POST /hepsub/search`

Add hepsubsearch item

## Request body

- SearchObject
  - `param` object, required
    - `limit` integer, required — this controls the number of records to display
    - `location` object — location
      - `node` string[]
    - `orlogic` boolean — this control the type of search one can perform type: boolean
    - `search` object — this control the type of search one can perform type: string format: binary
    - `timezone` object — timezone settings type: object
      - `name` string
      - `value` integer
    - `transaction` object
    - `whitelist` string[] — ips to be removed from search
  - `timestamp` object — this control the time range for used for search
    - `from` integer, required — current timestamp in miliseconds
    - `to` integer, required — current timestamp in miliseconds

## Response `201`

HepsubCreateSuccessResponse

- HepsubCreateSuccessResponse
  - `data` string
  - `message` string

## Other responses

- `400` — FailureResponse

## Changes

- **2026-07-17** `2f261ecc6074` — 1 info
  - the security scope `[]` was added to the endpoint's security scheme `bearer`
- **2021-11-03** `8b089db7394c` — 1 info
  - the security scope `[]` was added to the endpoint's security scheme `bearer`
- **2021-11-03** `31e15898198d` — 7 info
  - the endpoint scheme security `SecurityDefinitions` was added to the API
  - the endpoint scheme security `in` was added to the API
  - the endpoint scheme security `name` was added to the API
  - the endpoint scheme security `type` was added to the API
  - …3 more
- **2020-04-01** `8739183b4c43` — 1 info
  - endpoint added
- **2020-01-12** `52987c8da72a` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/sipcapture/apis/homer-app/changes/hepsub/search/post.md)

---

[API](https://skmtc.dev/sipcapture/apis/homer-app.md) · [All operations](https://skmtc.dev/sipcapture/apis/homer-app/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/sipcapture/homer-app/revisions/2f261ecc6074/schema)