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

GET

/repos/issues/search

curl --request GET \
  --url https://gitea.example.com/api/v1/repos/issues/search \
  --header 'Authorization: Basic <credentials>'

Authorizations

• BasicAuth
• Token
• AccessToken
• AuthorizationHeaderToken
• SudoParam
• SudoHeader
• TOTPHeader

Parameters

Query Parameters

state

string

Whether issue is open or closed

labels

string

Comma separated list of labels. Fetch only issues that have any of this labels. Non existent labels are discarded

milestones

string

Comma separated list of milestone names. Fetch only issues that have any of this milestones. Non existent are discarded

q

string

Search string

priority_repo_id

integer format: int64

Repository to prioritize in the results

type

string

Filter by type (issues / pulls) if set

since

string format: date-time

Only show notifications updated after the given time. This is a timestamp in RFC 3339 format

before

string format: date-time

Only show notifications updated before the given time. This is a timestamp in RFC 3339 format

assigned

boolean

Filter (issues / pulls) assigned to you, default is false

created

boolean

Filter (issues / pulls) created by you, default is false

mentioned

boolean

Filter (issues / pulls) mentioning you, default is false

review_requested

boolean

Filter pulls requesting your review, default is false

reviewed

boolean

Filter pulls reviewed by you, default is false

owner

string

Filter by owner

team

string

Filter by team (requires organization owner parameter to be provided)

page

integer

Page number of results to return (1-based)

limit

integer

Page size of results

Responses

200

IssueList

Media typeapplication/json

Array<object>

Issue represents an issue in a repository

object

assets

Array<object>

Attachment a generic attachment

object

browser_download_url

string

created_at

string format: date-time

download_count

integer format: int64

id

integer format: int64

name

string

size

integer format: int64

uuid

string

assignee

User represents a user

object

active

Is user active

boolean

avatar_url

URL to the user’s avatar

string

created

string format: date-time

description

The user’s description

string

email

string format: email

followers_count

User counts

integer format: int64

following_count

integer format: int64

full_name

The user’s full name

string

id

The user’s id

integer format: int64

is_admin

Is the user an administrator

boolean

language

User locale

string

last_login

string format: date-time

location

The user’s location

string

login

The user’s username

string

login_name

The user’s authentication sign-in name.

string

default: empty

prohibit_login

Is user login prohibited

boolean

restricted

Is user restricted

boolean

starred_repos_count

integer format: int64

visibility

User visibility level option: public, limited, private

string

website

The user’s website

string

assignees

Array<object>

User represents a user

object

active

Is user active

boolean

avatar_url

URL to the user’s avatar

string

created

string format: date-time

description

The user’s description

string

email

string format: email

followers_count

User counts

integer format: int64

following_count

integer format: int64

full_name

The user’s full name

string

id

The user’s id

integer format: int64

is_admin

Is the user an administrator

boolean

language

User locale

string

last_login

string format: date-time

location

The user’s location

string

login

The user’s username

string

login_name

The user’s authentication sign-in name.

string

default: empty

prohibit_login

Is user login prohibited

boolean

restricted

Is user restricted

boolean

starred_repos_count

integer format: int64

visibility

User visibility level option: public, limited, private

string

website

The user’s website

string

body

string

closed_at

string format: date-time

comments

integer format: int64

created_at

string format: date-time

due_date

string format: date-time

html_url

string

id

integer format: int64

is_locked

boolean

labels

Array<object>

Label a label to an issue or a pr

object

color

string

description

string

exclusive

boolean

id

integer format: int64

is_archived

boolean

name

string

url

string

milestone

Milestone milestone is a collection of issues on one repository

object

closed_at

string format: date-time

closed_issues

integer format: int64

created_at

string format: date-time

description

string

due_on

string format: date-time

id

integer format: int64

open_issues

integer format: int64

state

StateType issue state type

string

title

string

updated_at

string format: date-time

number

integer format: int64

original_author

string

original_author_id

integer format: int64

pin_order

integer format: int64

pull_request

PullRequestMeta PR info if an issue is a PR

object

merged

boolean

merged_at

string format: date-time

ref

string

repository

RepositoryMeta basic repository information

object

full_name

string

id

integer format: int64

name

string

owner

string

state

StateType issue state type

string

title

string

updated_at

string format: date-time

url

string

user

User represents a user

object

active

Is user active

boolean

avatar_url

URL to the user’s avatar

string

created

string format: date-time

description

The user’s description

string

email

string format: email

followers_count

User counts

integer format: int64

following_count

integer format: int64

full_name

The user’s full name

string

id

The user’s id

integer format: int64

is_admin

Is the user an administrator

boolean

language

User locale

string

last_login

string format: date-time

location

The user’s location

string

login

The user’s username

string

login_name

The user’s authentication sign-in name.

string

default: empty

prohibit_login

Is user login prohibited

boolean

restricted

Is user restricted

boolean

starred_repos_count

integer format: int64

visibility

User visibility level option: public, limited, private

string

website

The user’s website

string

Example

[
  {
    "assignee": {
      "login_name": "empty"
    },
    "assignees": [
      {
        "login_name": "empty"
      }
    ],
    "labels": [
      {
        "color": "00aabb",
        "exclusive": false,
        "is_archived": false
      }
    ],
    "user": {
      "login_name": "empty"
    }
  }
]