The REST API is now versioned. For more information, see "About API versioning."

REST API endpoints for issue types

Use the REST API to manage issue types for a repository.

List issue types for a repository

Lists issue types available for a repository (inherited from its organization owner, with any per-repository overrides applied). OAuth app tokens and personal access tokens (classic) need the repo scope to use this endpoint. Fine-grained access tokens require the "Metadata" repository permission (read).

Fine-grained access tokens for "List issue types for a repository"

This endpoint works with the following fine-grained token types:

The fine-grained token must have the following permission set:

"Metadata" repository permissions (read)

This endpoint can be used without authentication or the aforementioned permissions if only public resources are requested.

Parameters for "List issue types for a repository"

Headers
Name, Type, Description
`accept` string Setting to `application/vnd.github+json` is recommended.

Path parameters
Name, Type, Description
`owner` string Required The account owner of the repository. The name is not case sensitive.
`repo` string Required The name of the repository without the `.git` extension. The name is not case sensitive.

HTTP response status codes for "List issue types for a repository"

Status code	Description
`200`	OK
`404`	Resource not found

Code samples for "List issue types for a repository"

Request example

get/repos/{owner}/{repo}/issue-types

Copy to clipboard curl request example

curl -L \
 -H "Accept: application/vnd.github+json" \
 -H "Authorization: Bearer <YOUR-TOKEN>" \
 -H "X-GitHub-Api-Version: 2026-03-10" \
 https://api.github.com/repos/OWNER/REPO/issue-types

Response

Status: 200

[
 {
 "id": 410,
 "node_id": "IT_kwDNAd3NAZo",
 "name": "Task",
 "description": "A specific piece of work",
 "created_at": "2024-12-11T14:39:09Z",
 "updated_at": "2024-12-11T14:39:09Z"
 },
 {
 "id": 411,
 "node_id": "IT_kwDNAd3NAZs",
 "name": "Bug",
 "description": "An unexpected problem or behavior",
 "created_at": "2024-12-11T14:39:09Z",
 "updated_at": "2024-12-11T14:39:09Z"
 }
]

URL: https://docs.github.com/en/rest/repos/issue-types