Get requests by filter

POST https://{tenant}.atomicwork.com/api/v1/requests/list

Filtering

The request body is an array of filter objects. Send an empty array ([]) to retrieve all records.

Each filter object has the following fields:

Field	Type	Description
`attribute`	string	The field to filter on (see Supported attributes below)
`operator`	string	Comparison operator (see Available operators below)
`values`	array	One or more `\{ "value": \<scalar> \}` objects

Supported attributes

Attribute	Typical operator	Description
`status`	`IS_ANY_OF`	Ticket status (e.g. `OPEN`, `IN_PROGRESS`, `RESOLVED`, `CLOSED`).
`type`	`IS_ANY_OF`	Request type (e.g. `INCIDENT`, `SERVICE_REQUEST`, `GENERAL_REQUEST`).
`assignee_id`	`IS_ANY_OF`	Assigned agent user ID.
`requester_id`	`IS_ANY_OF`	Requester user ID.
`created_at`

Available operators

Operator	Meaning
`EQUALS`	Exact match
`NOT_EQUALS`	Exclude exact match
`IN` / `IS_ANY_OF`	Match any value in the list
`IS_NOT_ANY_OF`	Exclude all listed values
`IS_BETWEEN`	Inclusive range — pass exactly two values: `[start, end]`
`IS_ON_OR_BEFORE` / `IS_ON_OR_AFTER`	Date/time boundary comparisons
`CONTAINS` / `TEXT_CONTAINS`	Substring or set membership
`IS_NULL` / `IS_NOT_NULL`	Null checks — `values` array can be empty
/

Example

[
  {
    "attribute": "status",
    "operator": "IS_ANY_OF",
    "values": [
      {
        "value": "OPEN"
      },
      {
        "value": "IN_PROGRESS"
      }
    ]
  },
  {
    "attribute": "created_at",
    "operator": "IS_BETWEEN",
    "values": [
      {
        "value"

Authorization

X-Api-Keyheaderstringrequired

API key authentication.

Headers

X-Workspace-Idheaderstring

Query Parameters

filter_namequerystringrequired

sort_orderqueryenum (string)

Allowed valuesCREATED_AT_DESCCREATED_AT_ASCUPDATED_AT_DESCSLA_DUE_AT_DESCSLA_DUE_AT_ASCADDED_COMMENT_DESCPERFORMER_DESCPERFORMER_ASCNAME_ASCNAME_DESC

sortquerystring

Generic ordered sort as a compact string, e.g. created_at:ASC,subject:DESC. Field keys are validated server-side against the view-column allowlist. When present, takes precedence over the legacy sort_order enum.

pagequeryintegerrequired

per_pagequeryinteger

Response

200

Successful response