Skip to main content
GET
/
api
/
github
/
issues
curl --location 'https://cloud.blackbox.ai/api/github/issues?owner=example-user&repo=example-repo' \
--header 'Authorization: Bearer bb_YOUR_API_KEY'

[
    {
        "number": 42,
        "title": "Fix authentication bug",
        "state": "open",
        "html_url": "https://github.com/example-user/example-repo/issues/42",
        "created_at": "2025-11-10T09:15:30Z",
        "updated_at": "2025-11-18T14:22:45Z",
        "labels": [
            {
                "name": "bug",
                "color": "d73a4a"
            }
        ],
        "assignees": [
            {
                "login": "developer1",
                "avatar_url": "https://avatars.githubusercontent.com/u/12345?v=4"
            }
        ]
    }
]
This endpoint returns a list of issues from a specified GitHub repository, including issue details such as title, state, labels, and assignees.

​
Authentication

To use this API, you need a BLACKBOX API Key. Follow these steps to get your API key:
  1. Click on your Profile Image in the top right corner at cloud.blackbox.ai
  2. Click on “BLACKBOX API Token” from the dropdown menu
  3. Copy the existing token or click “Generate” if you don’t have one yet
Your API key will be in the format: bb_xxxxxxxxxxxxxxxxxxxxxx

​
Headers

​
Authorization
string
required
API Key of the form Bearer <api_key>.Example: Bearer bb_b41b647ffbfed27f61656049d3eaeef3d903cc503345d9eb80080d98bc0

​
Query Parameters

​
owner
string
required
The GitHub username or organization name that owns the repository.Example: example-user or example-org
​
repo
string
required
The repository name from which to retrieve issues.Example: example-repo

​
Response

The endpoint returns an array of issue objects. If no issues exist, an empty array is returned.
​
number
number
The issue number.
​
title
string
The title of the issue.
​
state
string
The current state of the issue (open or closed).
​
html_url
string
The URL to view the issue on GitHub.
​
created_at
string
ISO 8601 timestamp of when the issue was created.
​
updated_at
string
ISO 8601 timestamp of when the issue was last updated.
​
labels
array
Array of label objects associated with the issue.
​
assignees
array
Array of user objects assigned to the issue.
curl --location 'https://cloud.blackbox.ai/api/github/issues?owner=example-user&repo=example-repo' \
--header 'Authorization: Bearer bb_YOUR_API_KEY'

[
    {
        "number": 42,
        "title": "Fix authentication bug",
        "state": "open",
        "html_url": "https://github.com/example-user/example-repo/issues/42",
        "created_at": "2025-11-10T09:15:30Z",
        "updated_at": "2025-11-18T14:22:45Z",
        "labels": [
            {
                "name": "bug",
                "color": "d73a4a"
            }
        ],
        "assignees": [
            {
                "login": "developer1",
                "avatar_url": "https://avatars.githubusercontent.com/u/12345?v=4"
            }
        ]
    }
]