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

# Get Tracking Status

> Get the mention check status for an entity. Returns when the last check completed, when the next check is scheduled, and whether a check is currently in progress. Useful for syncing — poll this endpoint to know when new data is available.



## OpenAPI

````yaml get /entities/tracking-status
openapi: 3.1.0
info:
  title: Geogen API
  description: >-
    API for accessing LLM visibility data, managing entities, and tracking AI
    mentions.
  version: 1.0.0
servers:
  - url: https://api.geogen.io/v1
    description: Production server
security:
  - bearerAuth: []
paths:
  /entities/tracking-status:
    get:
      tags:
        - Entities
      summary: Get Tracking Status
      description: >-
        Get the mention check status for an entity. Returns when the last check
        completed, when the next check is scheduled, and whether a check is
        currently in progress. Useful for syncing — poll this endpoint to know
        when new data is available.
      operationId: getEntityTrackingStatus
      parameters:
        - name: entityId
          in: query
          required: true
          schema:
            type: string
          description: Entity ID
      responses:
        '200':
          description: Tracking status retrieved successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                  data:
                    type: object
                    properties:
                      scheduled:
                        type: boolean
                        description: Whether the entity has a tracking schedule
                      lastCheckCompletedAt:
                        type: string
                        nullable: true
                        format: date-time
                        description: >-
                          ISO timestamp of the last completed mention check, or
                          null if no check has completed yet
                      nextCheckScheduledAt:
                        type: string
                        format: date-time
                        description: ISO timestamp of the next scheduled mention check
                      isProcessing:
                        type: boolean
                        description: Whether a mention check is currently in progress
                      frequencyHours:
                        type: number
                        description: How often mention checks run (in hours)
              examples:
                scheduled:
                  summary: Entity with active tracking
                  value:
                    success: true
                    data:
                      scheduled: true
                      lastCheckCompletedAt: '2026-03-06T10:00:00.000Z'
                      nextCheckScheduledAt: '2026-03-07T10:00:00.000Z'
                      isProcessing: false
                      frequencyHours: 24
                not_scheduled:
                  summary: Entity without tracking schedule
                  value:
                    success: true
                    data:
                      scheduled: false
                      message: No tracking schedule found for this entity
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: Entity not found in this workspace
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    Error:
      type: object
      properties:
        error:
          type: string
          description: Error message
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: 'API key authentication. Format: Bearer wsk_your_api_key'

````