---
title: "Search Attribute Values"
method: POST
path: "/api/v1/search/attributes"
tags: ["Attribute"]
---

# Search Attribute Values

`POST /api/v1/search/attributes`

Search attributes based on filters specified in the request body.

## Request body

- C1ApiAttributeV1SearchAttributeValuesRequest — Search Attributes by a few properties.
  - `attributeTypeIds` string[], nullable — The attribute type ids for what type of attributes to search for.
  - `excludeIds` string[], nullable — Exclude attributes with these ids from the search results.
  - `ids` string[], nullable — Include attributes with these ids in the search results.
  - `pageSize` integer — The pageSize where 0 <= pageSize <= 100. Values < 10 will be set to 10. A value of 0 returns the default page size (currently 25)
  - `pageToken` string — The pageToken field.
  - `query` string — Query the attributes with a fuzzy search on display name and description.
  - `value` string — Search for attributes with a case insensitive match on the attribute value which is the attribute name.

## Response `200`

SearchAttributeValuesResponse is the response for searching AttributeValues.

- C1ApiAttributeV1SearchAttributeValuesResponse — SearchAttributeValuesResponse is the response for searching AttributeValues.
  - `list` C1ApiAttributeV1AttributeValue[], nullable — The list of returned AttributeValues.
    - `attributeTypeId` string — The ID of the AttributeType that this AttributeValue belongs to.
    - `createdAt` string, date-time
    - `deletedAt` string, date-time
    - `id` string — The ID of the AttributeValue.
    - `updatedAt` string, date-time
    - `value` string — The value of the AttributeValue. This is the string that will be displayed to the user.
  - `nextPageToken` string — The nextPageToken is shown for the next page if the number of results is larger than the max page size. The server returns one page of results and the nextPageToken until all results are retreived. To retrieve the next page, use the same request and append a pageToken field with the value of nextPageToken shown on the previous page.

---

[API](https://skmtc.net/conductorone/apis/c1-api.md) · [All operations](https://skmtc.net/conductorone/apis/c1-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/conductorone/c1-api/revisions/d391405a35d3/schema)