> ## Documentation Index > Fetch the complete documentation index at: https://developers.criteo.com/llms.txt > Use this file to discover all available pages before exploring further. # /2026-01/commerce-grid/audience-segments/search > Returns a list of segments that match the provided filters. If present, the filters are AND'ed together when applied. ## OpenAPI ````yaml https://api.criteo.com/2026-01/commercegrid/open-api-specifications.json post /2026-01/commerce-grid/audience-segments/search openapi: 3.0.1 info: title: Criteo API description: Criteo API - CommerceGrid version: 2026-01 servers: - url: https://api.criteo.com security: - oauth: [] tags: - name: Gateway - name: Segment paths: /2026-01/commerce-grid/audience-segments/search: post: tags: - Segment summary: /2026-01/commerce-grid/audience-segments/search description: >- Returns a list of segments that match the provided filters. If present, the filters are AND'ed together when applied. operationId: searchAudienceSegments parameters: - name: limit in: query description: >- The number of elements to be returned. The default is 50 and the maximum is 100. schema: maximum: 100 minimum: 0 type: integer format: int32 default: 50 - name: offset in: query description: The (zero-based) offset into the collection. The default is 0. schema: type: integer format: int32 default: 0 requestBody: description: '' content: application/json: schema: $ref: '#/components/schemas/CgAudienceSegmentSearchInputV1' required: true x-bodyName: request responses: '200': description: Success content: application/json: schema: $ref: >- #/components/schemas/CgAudienceSegmentEntityV1CgAudienceSegmentSearchMetadataV1ListResponse security: - oauth: - CommerceGrid_Segment_Read components: schemas: CgAudienceSegmentSearchInputV1: type: object properties: data: $ref: '#/components/schemas/CgAudienceSegmentSearchEntityV1Resource' description: >- A top-level object that encapsulates a Criteo API request for a single value. CgAudienceSegmentEntityV1CgAudienceSegmentSearchMetadataV1ListResponse: type: object properties: data: type: array items: $ref: '#/components/schemas/CgAudienceSegmentEntityV1Resource' nullable: true errors: type: array items: $ref: '#/components/schemas/CommonProblem' nullable: true readOnly: true meta: $ref: '#/components/schemas/CgAudienceSegmentSearchMetadataV1' warnings: type: array items: $ref: '#/components/schemas/CommonProblem' nullable: true readOnly: true description: >- A top-level object that encapsulates a Criteo API response for several entities and metadata CgAudienceSegmentSearchEntityV1Resource: type: object properties: attributes: $ref: '#/components/schemas/CgAudienceSegmentSearchEntityV1' type: type: string description: >- A top-level object that encapsulates a Criteo API response for a single value CgAudienceSegmentEntityV1Resource: type: object properties: attributes: $ref: '#/components/schemas/CgAudienceSegmentEntityV1' id: type: string description: Id of the entity nullable: true type: type: string nullable: true description: A class that represents a domain entity exposed by an API CommonProblem: type: object properties: code: type: string description: A machine-readable error code, expressed as a string value. nullable: true detail: type: string description: >- A human-readable explanation specific to this occurrence of the problem nullable: true instance: type: string description: A URI that identifies the specific occurrence of the problem. nullable: true source: type: object additionalProperties: type: string description: >- A machine-readable structure to reference to the exact location(s) causing the error(s) nullable: true stackTrace: type: string description: '' nullable: true title: type: string description: A short human-readable description of the problem type nullable: true traceId: type: string description: The request correlation ID this problem comes from. nullable: true traceIdentifier: type: string description: >- The request correlation ID this problem comes from. (deprecated, use traceId instead) nullable: true type: enum: - unknown - access-control - authentication - authorization - availability - deprecation - quota - validation type: string description: The problem's category. nullable: true description: Common problem object. CgAudienceSegmentSearchMetadataV1: type: object properties: limit: type: integer description: Max item of the current page format: int32 nullable: true offset: type: integer description: Number of item to skip format: int32 nullable: true totalItems: type: integer description: Total number of items format: int32 nullable: true description: Metadata for the audience segment search response. nullable: true CgAudienceSegmentSearchEntityV1: type: object properties: audienceSegmentIds: type: array items: type: string description: List of segment ids audienceSegmentTypes: type: array items: enum: - Unknown - ContactList type: string description: List of segment types dataProviderIds: type: array items: type: string description: List of data provider ids remoteIds: type: array items: type: string description: >- List of ids used to identify the segment in the data provider's system description: >- Available filters to perform a search on audience segments. If present, the filters are AND'ed together when applied. CgAudienceSegmentEntityV1: type: object properties: contactList: $ref: '#/components/schemas/CgContactListV1' createdAt: type: string description: ISO-8601 timestamp in UTC of segment creation (read-only) format: date-time nullable: true dataProviderId: type: string description: Data provider associated to the segment (read-only) nullable: true description: type: string description: Description of the segment nullable: true name: type: string description: Name of the segment nullable: true remoteId: type: string description: >- The ID used to identify the segment in the data provider's system (read-only) nullable: true type: enum: - Unknown - ContactList type: string description: Type of segment (read-only) nullable: true updatedAt: type: string description: ISO-8601 timestamp in UTC of segment update (read-only) format: date-time nullable: true description: Set of rules that defines specific people to target. nullable: true x-criteo-canonical: infoType: entity name: CommerceGridAudienceSegment version: v1 CgContactListV1: type: object description: Settings to target users with your contact lists. nullable: true securitySchemes: oauth: type: oauth2 flows: clientCredentials: tokenUrl: https://api.criteo.com/oauth2/token scopes: {} authorizationCode: authorizationUrl: https://api.criteo.com/oauth2 tokenUrl: https://api.criteo.com/oauth2/token scopes: {} ````