GET/v2/issues

List all issues in a team or workspace. Issues are returned in reverse chronological order. Filter by status, priority, assignee, label, or cycle.

Path parameters

Name
team_idrequiredstring · UUID	The team identifier — find it in your workspace settings.

Query parameters

statusenum · open \| active \| backlog \| done	Filter by issue status. Multiple values can be passed as a comma-separated list.
priorityenum · low \| medium \| high \| critical	Filter by priority. Same comma-list semantics as status.
limitint · default 50 · max 250	How many records to return.
cursorstring · opaque	Pagination cursor from the previous response.

Returns

An object with data (array of Issue) and next_cursor for pagination.

cURLNodePython

⌃ Copy

# Request
curl https://api.plane.app/v2/issues \
  -H "Authorization: Bearer $PLANE_API_KEY" \
  -H "X-Team-ID: $TEAM" \
  -d "status=open&priority=high&limit=20"

200 OK400401

{
  "data": [
    {
      "id": "iss_28a3f1",
      "identifier": "ENG-284",
      "title": "Audit findings: JWT exp check missing",
      "status": "in_progress",
      "priority": "high",
      "assignee": "usr_maya",
      "created_at": "2026-05-18T07:42:00Z"
    },
    // 19 more issues
  ],
  "next_cursor": "eyJ0Ijoi...",
  "total": 42
}