---
title: "Search for issues across the repositories that the user has access to"
method: GET
path: "/repos/issues/search"
tags: ["issue"]
---

# Search for issues across the repositories that the user has access to

`GET /repos/issues/search`

## Query parameters

- `state` 'open' | 'closed' | 'all'
- `labels` string
- `milestones` string
- `q` string
- `type` 'issues' | 'pulls'
- `since` string, date-time
- `before` string, date-time
- `assigned` boolean
- `created` boolean
- `mentioned` boolean
- `review_requested` boolean
- `reviewed` boolean
- `owner` string
- `created_by` string
- `team` string
- `page` integer
- `limit` integer

## Response `200`

IssueList

- Issue[]
  - `assets` Attachment[]
    - `browser_download_url` string — DownloadURL is the URL to download the attachment
    - `created_at` string, date-time — Created is the time when the attachment was uploaded
    - `download_count` integer — DownloadCount is the number of times the attachment has been downloaded
    - `id` integer — ID is the unique identifier for the attachment
    - `name` string — Name is the filename of the attachment
    - `size` integer — Size is the file size in bytes
    - `uuid` string — UUID is the unique identifier for the attachment file
  - `assignee` User — User represents a user
    - `active` boolean — Is user active
    - `avatar_url` string — URL to the user's avatar
    - `created` string, date-time
    - `description` string — the user's description
    - `email` string, email
    - `followers_count` integer — user counts
    - `following_count` integer
    - `full_name` string — the user's full name
    - `html_url` string — URL to the user's gitea page
    - `id` integer — the user's id
    - `is_admin` boolean — Is the user an administrator
    - `language` string — User locale
    - `last_login` string, date-time
    - `location` string — the user's location
    - `login` string — login of the user, same as `username`
    - `login_name` string — identifier of the user, provided by the external authenticator (if configured)
    - `prohibit_login` boolean — Is user login prohibited
    - `restricted` boolean — Is user restricted
    - `source_id` integer — The ID of the user's Authentication Source
    - `starred_repos_count` integer
    - `visibility` 'public' | 'limited' | 'private' — User visibility level option: public, limited, private
    - `website` string — the user's website
  - `assignees` User[]
    - `active` boolean — Is user active
    - `avatar_url` string — URL to the user's avatar
    - `created` string, date-time
    - `description` string — the user's description
    - `email` string, email
    - `followers_count` integer — user counts
    - `following_count` integer
    - `full_name` string — the user's full name
    - `html_url` string — URL to the user's gitea page
    - `id` integer — the user's id
    - `is_admin` boolean — Is the user an administrator
    - `language` string — User locale
    - `last_login` string, date-time
    - `location` string — the user's location
    - `login` string — login of the user, same as `username`
    - `login_name` string — identifier of the user, provided by the external authenticator (if configured)
    - `prohibit_login` boolean — Is user login prohibited
    - `restricted` boolean — Is user restricted
    - `source_id` integer — The ID of the user's Authentication Source
    - `starred_repos_count` integer
    - `visibility` 'public' | 'limited' | 'private' — User visibility level option: public, limited, private
    - `website` string — the user's website
  - `body` string
  - `closed_at` string, date-time
  - `comments` integer
  - `content_version` integer — The version of the issue content for optimistic locking
  - `created_at` string, date-time
  - `due_date` string, date-time
  - `html_url` string
  - `id` integer
  - `is_locked` boolean
  - `labels` Label[]
    - `color` string
    - `description` string — Description provides additional context about the label's purpose
    - `exclusive` boolean
    - `id` integer — ID is the unique identifier for the label
    - `is_archived` boolean
    - `name` string — Name is the display name of the label
    - `url` string — URL is the API endpoint for accessing this label
  - `milestone` Milestone — Milestone milestone is a collection of issues on one repository
    - `closed_at` string, date-time
    - `closed_issues` integer — ClosedIssues is the number of closed issues in this milestone
    - `created_at` string, date-time
    - `description` string — Description provides details about the milestone
    - `due_on` string, date-time
    - `id` integer — ID is the unique identifier for the milestone
    - `open_issues` integer — OpenIssues is the number of open issues in this milestone
    - `state` 'open' | 'closed' — State indicates if the milestone is open or closed
    - `title` string — Title is the title of the milestone
    - `updated_at` string, date-time
  - `number` integer
  - `original_author` string
  - `original_author_id` integer
  - `pin_order` integer
  - `projects` Project[]
    - `closed_at` string, date-time
    - `created_at` string, date-time
    - `creator_id` integer — CreatorID is the user who created the project
    - `description` string — Description provides details about the project
    - `id` integer — ID is the unique identifier for the project
    - `is_closed` boolean — IsClosed indicates if the project is closed
    - `owner_id` integer — OwnerID is the owner of the project (for org-level projects)
    - `repo_id` integer — RepoID is the repository this project belongs to (for repo-level projects)
    - `title` string — Title is the title of the project
    - `updated_at` string, date-time
  - `pull_request` PullRequestMeta — PullRequestMeta PR info if an issue is a PR
    - `draft` boolean
    - `html_url` string
    - `merged` boolean
    - `merged_at` string, date-time
  - `ref` string
  - `repository` RepositoryMeta — RepositoryMeta basic repository information
    - `full_name` string
    - `id` integer
    - `name` string
    - `owner` string
  - `state` 'open' | 'closed'
  - `time_estimate` integer
  - `title` string
  - `updated_at` string, date-time
  - `url` string
  - `user` User — User represents a user
    - `active` boolean — Is user active
    - `avatar_url` string — URL to the user's avatar
    - `created` string, date-time
    - `description` string — the user's description
    - `email` string, email
    - `followers_count` integer — user counts
    - `following_count` integer
    - `full_name` string — the user's full name
    - `html_url` string — URL to the user's gitea page
    - `id` integer — the user's id
    - `is_admin` boolean — Is the user an administrator
    - `language` string — User locale
    - `last_login` string, date-time
    - `location` string — the user's location
    - `login` string — login of the user, same as `username`
    - `login_name` string — identifier of the user, provided by the external authenticator (if configured)
    - `prohibit_login` boolean — Is user login prohibited
    - `restricted` boolean — Is user restricted
    - `source_id` integer — The ID of the user's Authentication Source
    - `starred_repos_count` integer
    - `visibility` 'public' | 'limited' | 'private' — User visibility level option: public, limited, private
    - `website` string — the user's website

## Other responses

- `400` — APIError is error format response
- `422` — APIValidationError is error format response related to input validation

---

[API](https://skmtc.net/gitea/apis/gitea-api.md) · [All operations](https://skmtc.net/gitea/apis/gitea-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gitea/gitea-api/versions/350de506cefa/schema)