---
title: "Search blocklists by filter"
method: POST
path: "/glossary-api/v3/accounts/{accountUid}/blocklists/search"
tags: ["Blocklist API"]
---

# Search blocklists by filter

`POST /glossary-api/v3/accounts/{accountUid}/blocklists/search`

## Request

- Base URL: `https://api.smartling.com`
- URL: `https://api.smartling.com/glossary-api/v3/accounts/{accountUid}/blocklists/search`
- Auth: HTTP bearer

Search blocklists by filter endpoint.

## Path parameters

- `accountUid` string, required

## Request body

- GetBlocklistByFilterCommandPTO: Blocklist filter command.
  - `query` string: Allow to search blocklists by query in scope of name or description property.
  - `blocklistState` 'ACTIVE' | 'ARCHIVED' | 'BOTH': Blocklist state. ACTIVE is used if omitted.
  - `glossaryUids` string[]: Associated glossaryUids filter.
  - `paging` PaginationCommandPTO: Pagination options. If `paging` is omitted, offset 0 and limit 500 are used. If `paging` is passed, set `limit` explicitly: an omitted `limit` returns a single item.
    - `offset` integer: Amount of items to skip. Negative values are treated as 0.
    - `limit` integer: Amount of items to fetch. Values below 1 are raised to 1, and values above 500 are reduced to 500.
  - `sorting` BlocklistSortCommandPTO: Sorting options for the filter.
    - `field` 'name' | 'createdDate' | 'lastModifiedDate': Sorting field.
    - `direction` 'ASC' | 'DESC': Sorting direction.

## Response `200`

- BlocklistSearchListResponsePTO
  - `response` object, required
    - `code` 'SUCCESS', required: Indicates whether the response was successful or what error has occurred.
    - `data` object
      - `totalCount` integer: total blocklists amount
      - `items` BlocklistSearchResponsePTO[]
        - `blocklistUid` string: Blocklist uid.
        - `accountUid` string: Account uid.
        - `blocklistName` string: Blocklist name.
        - `description` string: Blocklist description.
        - `glossaryUids` string[]: Associated glossary uids.
        - `archived` boolean: Blocklist archived. In case if {@code true} set, then blocklist is archived.
        - `createdByUserUid` string: Unique identifier of a user — 12 lowercase alphanumeric characters.
        - `modifiedByUserUid` string: Unique identifier of a user — 12 lowercase alphanumeric characters.
        - `createdDate` string, date-time: ISO 8601 UTC timestamp.
        - `modifiedDate` string, date-time: ISO 8601 UTC timestamp.
        - `termsCount` integer: Amount of blocklist-terms in current blocklist.
        - `associatedGlossaries` integer: Amount of glossaries associated with current blocklist.

## Other responses

- `400`: Provided request parameters are invalid.
- `401`: Provided credentials are not valid.
- `403`: Access denied.
- `429`: Too many simultaneous API requests.
- `500`: Unexpected error.

## Changes

- **2026-10-26** `0da6569bfcb7`: 2 warning, 1 info
  - removed the optional property `items` from the response with the `200` status
  - removed the optional property `totalCount` from the response with the `200` status
  - added the required property `response` to the response with the `200` status
- **2026-10-17** `2cd7a8215799`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/smartling/apis/smartling-rest-api-reference/changes/glossary-api/v3/accounts/:accountUid/blocklists/search/post.md)

---

[API](https://skmtc.dev/smartling/apis/smartling-rest-api-reference.md) - [All operations](https://skmtc.dev/smartling/apis/smartling-rest-api-reference/llms.txt) - [OpenAPI document](https://skmtc.dev/smartling/apis/smartling-rest-api-reference/revisions/e63066e7f5e9?raw)