> ## Documentation Index
> Fetch the complete documentation index at: https://docs.promptlayer.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Search Request Suggestions

Get autocomplete suggestions for request log fields. Use this endpoint to power search UIs, discover values in your logs, or scope suggestions with the same filters used by request-log search.

## Behavior Notes

* This endpoint is rate limited to 10 requests per minute.
* `filter_group` uses the same JSON-encoded structured filter syntax as [Search Request Logs](/reference/search-request-logs).
* Fields that return nested values require `metadata_key` to identify the nested key.

## Related

* [Search Request Logs](/reference/search-request-logs)
* [Search Data Model](/features/prompt-history/search-data-model)
* [Advanced Search](/why-promptlayer/advanced-search)


## OpenAPI

````yaml GET /api/public/v2/requests/suggestions
openapi: 3.1.0
info:
  title: FastAPI
  version: 0.1.0
servers: []
security:
  - ApiKeyAuth: []
paths:
  /api/public/v2/requests/suggestions:
    get:
      tags:
        - tracking
      summary: Search Request Suggestions
      operationId: getRequestSearchSuggestions
      parameters:
        - name: field
          in: query
          required: true
          schema:
            type: string
            enum:
              - engine
              - provider_type
              - prompt_id
              - prompt
              - tags
              - metadata_keys
              - status
              - tool_names
              - output_keys
              - input_variable_keys
              - metadata_values
              - output_values
              - input_variable_values
          description: Request log field to get suggestions for.
          example: tags
        - name: prefix
          in: query
          required: false
          schema:
            type: string
          description: Case-insensitive prefix to filter suggestions.
          example: prod
        - name: metadata_key
          in: query
          required: false
          schema:
            type: string
          description: >-
            Required when field is metadata_values, output_values, or
            input_variable_values. Specifies which key to get values for.
          example: user_id
        - name: prompt_id
          in: query
          required: false
          schema:
            type: integer
            minimum: 1
          description: >-
            Filter suggestions to a specific prompt template (only used when
            field is prompt).
        - name: filter_group
          in: query
          required: false
          schema:
            type: string
          description: JSON-encoded filter group to scope suggestions to matching requests.
          example: >-
            {"logic":"AND","filters":[{"field":"engine","operator":"is","value":"gpt-4o"}]}
      responses:
        '200':
          description: Autocomplete suggestions.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SearchRequestSuggestionsResponse'
              examples:
                tags:
                  summary: Tag suggestions
                  value:
                    success: true
                    values:
                      - production
                      - staging
                      - prod-v2
        '401':
          $ref: '#/components/responses/UnauthorizedError'
        '403':
          $ref: '#/components/responses/ForbiddenError'
        '422':
          $ref: '#/components/responses/ValidationError'
        '429':
          $ref: '#/components/responses/TooManyRequestsError'
components:
  schemas:
    SearchRequestSuggestionsResponse:
      type: object
      title: SearchRequestSuggestionsResponse
      required:
        - success
        - values
      properties:
        success:
          type: boolean
          enum:
            - true
        values:
          type: array
          items:
            type: string
          description: Suggested values for the requested field.
    ErrorResponse:
      type: object
      properties:
        success:
          type: boolean
          default: false
          description: Indicates that the request failed.
        message:
          type: string
          description: Human-readable error message.
        error:
          type: string
          description: Machine-readable or fallback error message.
      additionalProperties: true
      description: >-
        Standard error response. Some legacy endpoints may return either message
        or error.
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
  responses:
    UnauthorizedError:
      description: Unauthorized - missing or invalid API key.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    ForbiddenError:
      description: Forbidden - API key does not have access to the requested resource.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    ValidationError:
      description: Validation error - request parameters or body are invalid.
      content:
        application/json:
          schema:
            oneOf:
              - $ref: '#/components/schemas/HTTPValidationError'
              - $ref: '#/components/schemas/ErrorResponse'
    TooManyRequestsError:
      description: Too many requests - the endpoint rate limit was exceeded.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          examples:
            rateLimited:
              summary: Rate limited
              value:
                success: false
                message: Rate limit exceeded. Please retry later.
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-KEY

````