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

Documentation Index

Fetch the complete documentation index at: https://docs.blackbox.ai/llms.txt

Use this file to discover all available pages before exploring further.

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

​
Error Codes

Status CodeErrorDescription
200SuccessIssues retrieved successfully
400Bad RequestMissing required parameters: owner and repo
401UnauthorizedInvalid or missing API key
404Not FoundGitHub token not found, expired, or repository not found
502Bad GatewayGitHub API error occurred
500Internal Server ErrorDatabase or server error occurred