Skip to main content
POST
/
integrations
/
linear
/
search
Search for Linear issues
curl --request POST \
  --url https://api.getfernand.com/integrations/linear/search \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "query": "authentication bug"
}
'
[
  {
    "id": "8a7b93d1-18f7-4a9f-b5c6-3e2d1f9a8c7b",
    "title": "Fix authentication bug",
    "url": "https://linear.app/team/issue/ENG-123",
    "identifier": "ENG-123",
    "assignee": {
      "name": "Richard Hendricks",
      "avatar_url": "https://avatar.linear.app/9c0d1e2f"
    },
    "state": {
      "name": "In Progress",
      "type": "started",
      "color": "#f2c94c",
      "last_updated_at": "2026-01-15T10:30:00Z"
    },
    "labels": [
      {
        "name": "bug",
        "color": "#5e6ad2"
      }
    ],
    "priority": 1,
    "priority_label": "Urgent",
    "last_updated_at": "2026-01-15T10:30:00Z"
  }
]
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.

Authorizations

​
X-API-Key
string
header
required

Authenticate your account by including your secret key in API requests. You can manage your API keys in the Dashboard.

Authentication to the API is performed by using the HTTP Header X-API-Key.

Body

application/json
​
query
string

Search query string (optional, if empty returns recent issues).

Example:

"authentication bug"

Response

Search results retrieved successfully.

​
id
string

Unique identifier of the Linear issue.

Example:

"8a7b93d1-18f7-4a9f-b5c6-3e2d1f9a8c7b"

​
title
string

Title of the issue.

Example:

"Fix authentication bug"

​
url
string

URL to view the issue in Linear.

Example:

"https://linear.app/team/issue/ENG-123"

​
identifier
string

Human-readable issue identifier.

Example:

"ENG-123"

​
assignee
object

Assigned user (null if unassigned).

​
state
object

Current workflow state of the issue.

​
labels
object[]

List of labels applied to the issue.

​
priority
integer

Priority level (0=No priority, 1=Urgent, 2=High, 3=Medium, 4=Low).

Example:

1

​
priority_label
string

Display name of the priority level.

Example:

"Urgent"

​
last_updated_at
string

ISO 8601 timestamp of the last update.

Example:

"2026-01-15T10:30:00Z"