Get GitHub Repositories

Retrieve repositories for a specific GitHub user or organization.

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

cURL

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

Success Response

[
    {
        "name": "example-repo",
        "full_name": "example-user/example-repo",
        "description": "An example repository",
        "private": false,
        "clone_url": "https://github.com/example-user/example-repo.git",
        "updated_at": "2025-11-15T10:30:00Z",
        "language": "JavaScript"
    },
    {
        "name": "another-repo",
        "full_name": "example-user/another-repo",
        "description": null,
        "private": false,
        "clone_url": "https://github.com/example-user/another-repo.git",
        "updated_at": "2025-10-20T14:22:15Z",
        "language": "Python"
    }
]

This endpoint returns a list of repositories belonging to a specified GitHub user or organization, including repository metadata such as name, description, language, and clone URL.

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 whose repositories you want to retrieve.

Example: example-user or example-org

Response

The endpoint returns an array of repository objects.

name · string

The repository name.

full_name · string

The full repository name including owner (format: owner/repo-name).

description · string

The repository description. Can be null if no description is set.

private · boolean

Whether the repository is private (true) or public (false).

clone_url · string

The HTTPS URL for cloning the repository.

updated_at · string

ISO 8601 timestamp of the last update to the repository.

language · string

The primary programming language of the repository. Can be null if not detected.

cURL

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

Success Response

[
    {
        "name": "example-repo",
        "full_name": "example-user/example-repo",
        "description": "An example repository",
        "private": false,
        "clone_url": "https://github.com/example-user/example-repo.git",
        "updated_at": "2025-11-15T10:30:00Z",
        "language": "JavaScript"
    },
    {
        "name": "another-repo",
        "full_name": "example-user/another-repo",
        "description": null,
        "private": false,
        "clone_url": "https://github.com/example-user/another-repo.git",
        "updated_at": "2025-10-20T14:22:15Z",
        "language": "Python"
    }
]

Error Codes

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