# Traces

## POST /api/traces/v2/search

> Traces search

OpenAPI:

```json
{"openapi":"3.1.1","info":{"title":"Groundcover API.","version":"1.0.0"},"servers":[{"url":"https://api.groundcover.com"}],"security":[{"Bearer":["[]"]}],"components":{"securitySchemes":{"Bearer":{"in":"header","name":"Authorization","type":"apiKey"}}},"paths":{"/api/traces/v2/search":{"post":{"description":"Traces search","operationId":"searchTraces","responses":{"200":{"description":"","schema":{}},"400":{"description":"ErrorResponse defines a common error response structure.","schema":{"properties":{"message":{"type":"string"}},"type":"object"}},"500":{"description":"ErrorResponse defines a common error response structure.","schema":{"$ref":"#/paths/~1api~1traces~1v2~1search/post/responses/400/schema"}}},"tags":["traces"],"requestBody":{"content":{"application/json":{"schema":{"properties":{"EnableStream":{"description":"EnableStream indicates if the response should be streamed","type":"boolean"},"End":{"description":"End time of the search range","format":"date-time","type":"string"},"Filters":{"description":"Extra filters to apply on the traces","type":"string"},"Pipeline":{"properties":{"except":{"items":{"properties":{"additionalFilter":{"type":"string"},"alias":{"type":"string"},"autoComplete":{"type":"boolean"},"filterKeys":{"items":{"type":"string"},"type":"array"},"isNullable":{"type":"boolean"},"key":{"type":"string"},"origin":{"type":"string"},"processors":{"items":{"properties":{"args":{"items":{"type":"string"},"type":"array"},"op":{"type":"string"}},"type":"object"},"type":"array"},"type":{"type":"string"}},"type":"object"},"type":"array"},"filters":{"properties":{"conditions":{"items":{"properties":{"additionalFilter":{"type":"string"},"autoComplete":{"type":"boolean"},"filterKeys":{"items":{"type":"string"},"type":"array"},"filters":{"items":{"properties":{"op":{"type":"string"},"value":{}},"title":"Filter represents an operation and value for a condition.","type":"object"},"type":"array"},"isNullable":{"type":"boolean"},"key":{"type":"string"},"origin":{"type":"string"},"type":{"type":"string"}},"title":"Condition specifies a search condition based on a column and filters.","type":"object"},"type":"array"},"disabled":{"type":"boolean"},"groups":{"items":{"properties":{"$ref":"#/paths/~1api~1traces~1v2~1search/post/requestBody/content/application~1json/schema/properties/Pipeline/properties/filters/properties"},"type":"object"},"type":"array"},"operator":{"type":"string"}},"type":"object"},"from":{"properties":{"$ref":"#/paths/~1api~1traces~1v2~1search/post/requestBody/content/application~1json/schema/properties/Pipeline/properties"},"title":"SqlPipeline defines a pipeline for search queries.","type":"object"},"groupBy":{"items":{"properties":{"$ref":"#/paths/~1api~1traces~1v2~1search/post/requestBody/content/application~1json/schema/properties/Pipeline/properties/except/items/properties"},"type":"object"},"type":"array"},"having":{"properties":{"$ref":"#/paths/~1api~1traces~1v2~1search/post/requestBody/content/application~1json/schema/properties/Pipeline/properties/filters/properties"},"type":"object"},"limit":{"format":"uint64","type":"integer"},"offset":{"format":"uint64","type":"integer"},"orderBy":{"items":{"properties":{"direction":{"type":"string"},"selector":{"properties":{"$ref":"#/paths/~1api~1traces~1v2~1search/post/requestBody/content/application~1json/schema/properties/Pipeline/properties/except/items/properties"},"type":"object"}},"title":"SearchOrderBy defines the order for a search pipeline.","type":"object"},"type":"array"},"selectors":{"items":{"properties":{"$ref":"#/paths/~1api~1traces~1v2~1search/post/requestBody/content/application~1json/schema/properties/Pipeline/properties/except/items/properties"},"type":"object"},"type":"array"}},"title":"SqlPipeline defines a pipeline for search queries.","type":"object"},"Query":{"description":"LogsQL Query to filter traces","type":"string"},"Sources":{"description":"Sources to filter traces","items":{"properties":{"$ref":"#/paths/~1api~1traces~1v2~1search/post/requestBody/content/application~1json/schema/properties/Pipeline/properties/filters/properties/conditions/items/properties"},"title":"Condition specifies a search condition based on a column and filters.","type":"object"},"type":"array"},"Start":{"description":"Start time of the search range","format":"date-time","type":"string"},"TryToUseBuckets":{"description":"TryToUseBuckets indicates if the search should be run using buckets","type":"boolean"}},"required":["Start","End"],"type":"object"}}},"description":"Traces search request","required":true}}}}}
```
