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

# Search for Linear issues

Searches for Linear issues in the organization based on the provided search query. If no query is provided, returns the most recent issues. Only returns issues in non-completed states (triage, unstarted, started, backlog). Results are limited to 20 issues, sorted by creation date.


## OpenAPI

````yaml https://api.getfernand.com/openapi.json post /integrations/linear/search
openapi: 3.0.3
info:
  title: Fernand API Documentation
  version: '3.0'
  description: This is the documentation for the [Fernand](https://getfernand.com) API.
  termsOfService: https://getfernand.com/terms
  contact:
    name: Fernand Support
    url: https://getfernand.com
    email: support@getfernand.com
  x-logo:
    url: https://app.getfernand.com/images/favicon/icon_128.png
servers:
  - url: https://api.getfernand.com
    description: ''
    x-last-modified: 1764750693905
security:
  - apiKeyHeader: []
externalDocs:
  description: You can access our documentation online by visiting https://api.fernand.help
  url: https://api.fernand.help
paths:
  /integrations/linear/search:
    post:
      tags:
        - Linear Integration
      summary: Search for Linear issues
      description: >-
        Searches for Linear issues in the organization based on the provided
        search query. If no query is provided, returns the most recent issues.
        Only returns issues in non-completed states (triage, unstarted, started,
        backlog). Results are limited to 20 issues, sorted by creation date.
      operationId: searchLinearIssues
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                query:
                  type: string
                  description: >-
                    Search query string (optional, if empty returns recent
                    issues).
                  example: authentication bug
      responses:
        '200':
          description: Search results retrieved successfully.
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    id:
                      type: string
                      description: Unique identifier of the Linear issue.
                      example: 8a7b93d1-18f7-4a9f-b5c6-3e2d1f9a8c7b
                    title:
                      type: string
                      description: Title of the issue.
                      example: Fix authentication bug
                    url:
                      type: string
                      description: URL to view the issue in Linear.
                      example: https://linear.app/team/issue/ENG-123
                    identifier:
                      type: string
                      description: Human-readable issue identifier.
                      example: ENG-123
                    assignee:
                      type: object
                      description: Assigned user (null if unassigned).
                      properties:
                        name:
                          type: string
                          description: Display name of the assignee.
                          example: Richard Hendricks
                        avatar_url:
                          type: string
                          description: URL to the assignee's avatar image.
                          example: https://avatar.linear.app/9c0d1e2f
                    state:
                      type: object
                      description: Current workflow state of the issue.
                      properties:
                        name:
                          type: string
                          description: Name of the workflow state.
                          example: In Progress
                        type:
                          type: string
                          description: Type of the workflow state.
                          example: started
                        color:
                          type: string
                          description: Color hex code of the workflow state.
                          example: '#f2c94c'
                        last_updated_at:
                          type: string
                          description: >-
                            ISO 8601 timestamp of when the issue entered this
                            state.
                          example: '2026-01-15T10:30:00Z'
                    labels:
                      type: array
                      description: List of labels applied to the issue.
                      items:
                        type: object
                        properties:
                          name:
                            type: string
                            description: Name of the label.
                            example: bug
                          color:
                            type: string
                            description: Color hex code of the label.
                            example: '#5e6ad2'
                    priority:
                      type: integer
                      description: >-
                        Priority level (0=No priority, 1=Urgent, 2=High,
                        3=Medium, 4=Low).
                      example: 1
                    priority_label:
                      type: string
                      description: Display name of the priority level.
                      example: Urgent
                    last_updated_at:
                      type: string
                      description: ISO 8601 timestamp of the last update.
                      example: '2026-01-15T10:30:00Z'
        '404':
          description: Linear integration not found for this organization.
components:
  securitySchemes:
    apiKeyHeader:
      type: apiKey
      description: >-
        Authenticate your account by including your secret key in API requests.

        You can manage your API keys in the
        [Dashboard](https://app.getfernand.com/).


        Authentication to the API is performed by using the HTTP Header
        X-API-Key.
      name: X-API-Key
      in: header
      x-last-modified: 1764750344730

````