> ## Documentation Index > Fetch the complete documentation index at: https://docs.octavehq.com/llms.txt > Use this file to discover all available pages before exploring further. # List intel > Read researched competitor, segment and market intel. Respects workspace and target intel settings. List defaults to active, non-archived records; use lifecycleStatuses for retired intel. Timestamps reflect record changes, including revalidation, rather than source publication dates. ## OpenAPI ````yaml get /api/v2/intel/list openapi: 3.0.0 info: version: 6.0.0 title: Octave API description: API for Octave workspace management and AI-powered content generation servers: - url: https://app.octavehq.com security: - ApiKeyAuth: [] paths: /api/v2/intel/list: get: tags: - Intel summary: List intel description: >- Read researched competitor, segment and market intel. Respects workspace and target intel settings. List defaults to active, non-archived records; use lifecycleStatuses for retired intel. Timestamps reflect record changes, including revalidation, rather than source publication dates. operationId: listIntel parameters: - schema: type: integer minimum: 1 maximum: 100 default: 20 required: false name: limit in: query - schema: type: integer nullable: true minimum: 0 default: 0 required: false name: offset in: query - schema: type: string enum: - createdAt - updatedAt - name default: createdAt description: 'Field used to order matching intel (default: createdAt).' required: false description: 'Field used to order matching intel (default: createdAt).' name: orderBy in: query - schema: type: string enum: - asc - desc default: desc description: 'Sort direction (default: desc).' required: false description: 'Sort direction (default: desc).' name: sortDirection in: query - schema: type: string enum: - segment - competitor - workspace_company description: >- Only return intel for this target type: segment, competitor, or workspace_company. required: false description: >- Only return intel for this target type: segment, competitor, or workspace_company. name: intelTargetType in: query - schema: anyOf: - type: string minLength: 1 - type: array items: type: string minLength: 1 minItems: 1 required: false name: intelTargetOIds in: query - schema: type: string format: date-time description: >- Return records updated after this ISO timestamp. Revalidation also updates timestamps; this is a sync filter, not an activity count. required: false description: >- Return records updated after this ISO timestamp. Revalidation also updates timestamps; this is a sync filter, not an activity count. name: updatedSince in: query - schema: anyOf: - type: string enum: - ACTIVE - INVALIDATED - EXPIRED - type: array items: type: string enum: - ACTIVE - INVALIDATED - EXPIRED minItems: 1 required: false name: lifecycleStatuses in: query - schema: type: string enum: - 'true' - 'false' default: false required: false name: hydrate in: query responses: '200': description: Intel content: application/json: schema: type: object properties: _metadata: $ref: '#/components/schemas/Metadata' intel: type: array items: type: object properties: oId: type: string name: type: string description: type: string nullable: true type: type: string enum: - MICRO - MACRO permanence: type: string nullable: true enum: - PASSING - LASTING - null confidence: type: string enum: - SPECULATIVE - CONSENSUS - ESTABLISHED strategicImpact: type: string enum: - CRITICAL - NOTABLE - MINOR mode: type: string enum: - AUTO - MANUAL source: type: string enum: - RESEARCH - MANUAL - CALL_FINDING citationCount: type: number default: 0 expectedDuration: type: string nullable: true createdAt: type: string updatedAt: type: string lifecycleStatus: type: string enum: - ACTIVE - INVALIDATED - EXPIRED targetEntityType: type: string enum: - segment - competitor - workspace_company targetEntityOId: type: string targetName: type: string nullable: true detail: type: object properties: oId: type: string targetEntityType: type: string enum: - segment - competitor - workspace_company targetEntityOId: type: string targetName: type: string nullable: true name: type: string description: type: string nullable: true type: type: string enum: - MICRO - MACRO permanence: type: string nullable: true enum: - PASSING - LASTING - null confidence: type: string enum: - SPECULATIVE - CONSENSUS - ESTABLISHED strategicImpact: type: string enum: - CRITICAL - NOTABLE - MINOR lifecycleStatus: type: string enum: - ACTIVE - INVALIDATED - EXPIRED mode: type: string enum: - AUTO - MANUAL source: type: string enum: - RESEARCH - MANUAL - CALL_FINDING data: anyOf: - type: object properties: howThisImpactsThem: type: array items: type: string default: [] howThisInfluencesOurApproach: type: array items: type: string default: [] expectedDuration: type: string citations: type: array items: type: string default: [] required: - expectedDuration additionalProperties: false - type: object properties: whatTheyreTryingToDo: type: array items: type: string default: [] howThisInfluencesTheirApproach: type: array items: type: string default: [] whyThisMattersToUs: type: array items: type: string default: [] howWeCounter: type: array items: type: string default: [] expectedDuration: type: string citations: type: array items: type: string default: [] required: - expectedDuration additionalProperties: false - type: object properties: howThisImpactsUs: type: array items: type: string default: [] howThisInfluencesOurApproach: type: array items: type: string default: [] expectedDuration: type: string citations: type: array items: type: string default: [] required: - expectedDuration additionalProperties: false archivedReason: type: string nullable: true invalidationReason: type: string nullable: true invalidatedBy: type: string nullable: true enum: - USER - SYSTEM - null user: type: object nullable: true properties: oId: type: string nullable: true firstName: type: string nullable: true lastName: type: string nullable: true createdAt: type: string updatedAt: type: string expiresAt: type: string nullable: true lastValidatedAt: type: string nullable: true archivedAt: type: string nullable: true required: - oId - targetEntityType - targetEntityOId - name - type - confidence - strategicImpact - lifecycleStatus - mode - source - data - createdAt - updatedAt required: - oId - name - type - confidence - strategicImpact - mode - source - createdAt - updatedAt - lifecycleStatus - targetEntityType - targetEntityOId description: The requested page of intel. total: type: number description: Total intel items matching the filters. hasNext: type: boolean description: >- Whether there are more matching intel items after this page. limit: type: number description: Maximum results per page. offset: type: number description: Current pagination offset. intelEnabled: type: boolean description: >- False when Intel is turned off for every target type in Library Settings. hydrated: type: boolean description: Whether `detail` is populated on each item. required: - _metadata - intel - total - hasNext - limit - offset - intelEnabled - hydrated components: schemas: Metadata: type: object properties: usage: type: number default: 0 example: 0 description: API usage requestId: type: string example: requestId description: Request ID message: type: string example: message description: Message timestamp: type: string example: '2021-01-01T00:00:00.000Z' description: Timestamp required: - requestId - timestamp securitySchemes: ApiKeyAuth: type: apiKey in: header name: api_key ````