Get GitHub Issues

Retrieve issues from a specific GitHub repository.

GET https://cloud.blackbox.ai/api/github/issues

cURL

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

Success Response

[
    {
        "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

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

Success Response

[
    {
        "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"
            }
        ]
    }
]

Error Codes

Status Code	Error	Description
200	Success	Issues retrieved successfully
400	Bad Request	Missing required parameters: owner and repo
401	Unauthorized	Invalid or missing API key
404	Not Found	GitHub token not found, expired, or repository not found
502	Bad Gateway	GitHub API error occurred
500	Internal Server Error	Database or server error occurred