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

# Get API Log Facets

> Returns the distinct values your organization's API logs contain for each filter, so you can discover what to pass to the search endpoint. Scoped to the same connection, integration, and date range.



## OpenAPI

````yaml get /api-logs/facets
openapi: 3.1.0
info:
  description: >

    Trackstar is a Unified API that provides standard endpoints for Supply Chain
    Logistics. We currently offer an API for Warehouse Management Systems (WMS).
  title: Trackstar API
  version: 0.1.0
servers:
  - description: Trackstar API
    url: https://production.trackstarhq.com
security: []
tags: []
externalDocs:
  description: Trackstar API Documentation
  url: https://docs.trackstarhq.com
paths:
  /api-logs/facets:
    get:
      tags:
        - Auth
      summary: Get API Log Facets
      description: >-
        Returns the distinct values your organization's API logs contain for
        each filter, so you can discover what to pass to the search endpoint.
        Scoped to the same connection, integration, and date range.
      operationId: get_get_api_log_facets
      parameters:
        - in: query
          name: start_date
          description: >-
            Only return requests received at or after this time. Cannot be more
            than 180 days ago, which is how long we retain logs.
          schema:
            type: string
            format: date-time
            example: '2024-01-15T00:00:00Z'
          required: true
        - in: query
          name: end_date
          description: >-
            Only return requests received at or before this time. Defaults to
            now.
          schema:
            type: string
            format: date-time
            example: '2024-01-16T00:00:00Z'
          required: false
        - in: query
          name: connection_id
          description: Only return requests made against this connection.
          schema:
            type: string
            example: abc123def456abc123def456abc123de
          required: false
        - in: query
          name: integration_name
          description: >-
            Only return requests made against connections to this integration.
            The same name can exist across types, so pair it with
            `integration_type` to disambiguate.
          schema:
            type: string
            enum:
              - active-ants
              - adp
              - amazon
              - amphora
              - amplifier
              - ams
              - amware
              - atomix
              - bdi
              - bergen
              - bigblue
              - bigcommerce
              - bleckmann
              - bluebox
              - byrd
              - camelot
              - canary7
              - capacity
              - carton-cloud
              - cin7-omni
              - cirro
              - clarus
              - controlport
              - crafty
              - cwr
              - cybership
              - dart
              - darwynn-fulfillment
              - davinci
              - dcl
              - dear-systems
              - deposco
              - dhl-ecom
              - dhl-express
              - distribution-alternatives
              - distribution-management
              - dotcom-distribution
              - douyin
              - dpd
              - ebay
              - elite-ops
              - eshipping
              - etsy
              - evolve
              - excelsior
              - extensiv-3pl-central
              - fabfitfun
              - faire
              - fba
              - fedex
              - fedex-fulfillment
              - ffe
              - finale
              - flat-fee-shipping
              - flexport
              - florisoft
              - flowspace
              - forceget
              - fulfil
              - fulfillment
              - fulfillment-lab
              - fulfillor
              - fulfilmentcrowd
              - fullgood-fulfillment
              - g-global
              - gobolt
              - greenmark
              - groupon
              - helm-wms
              - hive
              - i-fulfilment
              - icreate
              - ilg
              - infoplus
              - itshere
              - jas
              - jaygroup
              - jazz-central
              - landmark
              - leanafy
              - leanware
              - lineage
              - linnall
              - linnworks
              - logicpod
              - logiwa
              - logiwa-io
              - longtail
              - luxroutage
              - mabang
              - magento
              - mai
              - mainfreight
              - masonhub
              - mayple
              - mintsoft
              - mirakl
              - mochila-fulfillment
              - monta
              - netsuite
              - next3pl
              - nfi
              - nimble
              - nlrp
              - nri
              - nuorder
              - oia-global
              - omnitrans
              - ongoing
              - orderflow
              - orderwise
              - osa-commerce
              - overstock
              - packem
              - packiyo
              - pattern
              - peoplevox
              - picqer
              - pimento
              - podfoods
              - portless
              - postnord
              - pulpo
              - qls
              - quiet
              - rjw
              - royal-mail
              - rush-order
              - salesupply
              - sandbox
              - shipbob
              - shipedge
              - shipfusion
              - shiphero
              - shipmonk
              - shipnetwork
              - shipoffers
              - shipout
              - shipping-and-handling
              - shipping-tree
              - shippingbo
              - shipstation
              - shipstream
              - shipwire
              - shopify
              - skladon
              - skulabs
              - skusavvy
              - skuvault
              - smart-warehousing
              - smartpack
              - sojo
              - souko
              - squarespace
              - star
              - states-logistics
              - stock-and-trace
              - stockhub
              - stord
              - teamship
              - teapplix
              - techship
              - tiktok
              - tradepeg
              - unis
              - unleashed
              - ups
              - usps
              - veeqo
              - veracore
              - vertical-cold
              - vox
              - walmart
              - warehance
              - warehouseos
              - wayfair
              - whiplash
              - wineshipping
              - wix
              - woocommerce
              - xb-fulfillment
              - xorosoft
              - zenventory
              - zoho
            example: example_wms
          required: false
        - in: query
          name: integration_type
          description: >-
            Only return requests made against connections of this integration
            type.
          schema:
            type: string
            enum:
              - wms
              - freight
              - cart
              - carrier
              - erp
            example: wms
          required: false
        - in: header
          name: x-trackstar-api-key
          description: Your organization-level Trackstar API key.
          schema:
            type: string
            example: <x-trackstar-api-key>
          required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/APILogFacetsResponseSchema'
          description: Successful response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ValidationError'
          description: Validation error
components:
  schemas:
    APILogFacetsResponseSchema:
      type: object
      properties:
        data:
          $ref: '#/components/schemas/APILogFacets'
      required:
        - data
      additionalProperties: false
      title: APILogFacetsResponseSchema
    ValidationError:
      properties:
        error:
          type: string
        detail:
          type: object
          properties:
            <location>:
              type: object
              properties:
                <field_name>:
                  type: array
                  items:
                    type: string
      required:
        - error
      type: object
      title: ValidationError
    APILogFacets:
      type: object
      properties:
        connection_id:
          type: array
          description: The distinct connections your requests were made against.
          example:
            - abc123def456abc123def456abc123de
          items:
            type: string
            description: ''
        integration_name:
          type: array
          description: The distinct integrations your requests were made against.
          example:
            - example_wms
          items:
            type: string
            description: ''
        request_path:
          type: array
          description: >-
            The distinct endpoints your requests were made to. Path parameters
            are replaced with `<path_param>`.
          example:
            - /wms/orders/<path_param>
          items:
            type: string
            description: ''
        status_code:
          type: array
          description: The distinct HTTP status codes your requests returned.
          example:
            - 200
            - 404
          items:
            type: integer
            description: ''
            example: 0
      required:
        - connection_id
        - integration_name
        - request_path
        - status_code
      additionalProperties: false
      title: APILogFacets

````