GITHUB API

GitHub Projects API

List a GitHub user's public project boards, with each project's title, description, link, open or closed state and creation and update dates.

Endpoint
POST /github/list-projects
Price
1 credit per request
SDK
client.github.listProjects()
MCP tool
github_list_projects
Terminal
curl -X POST "https://api.bridgly.app/github/list-projects" \
-H "Authorization: Bearer $BRIDGLY_KEY" \
-H "Content-Type: application/json" \
-d '{
"username": "torvalds",
"count": 10
}'
[ REQUEST AND RESPONSE ]

What does the GitHub Projects API return?

GitHub projects API: list any user’s public GitHub Projects boards as JSON, with each project’s title, description, link, open or closed state and dates. Every response has the same envelope: the result in data, plus timeMs and the creditsCost of the call.

Request body

usernamestringrequired
GitHub username (login), or the profile link, e.g. "torvalds" or "https://github.com/torvalds".
countinteger · 1–10 · default 10
Number of results to return (1–10). Defaults to 10.
cursorstring
The previous response's `nextCursor`, to fetch the next page. Omit it for the first page.

Example response

200 OK · application/json
{
"timeMs": 1840,
"creditsCost": 1,
"data": {
"nextCursor": "string",
"username": "string",
"projects": [
{
"id": "string",
"number": 0,
"title": "string",
"shortDescription": "string",
"url": "string",
"closed": true,
"public": true,
"createdAt": "string",
"updatedAt": "string"
}
]
}
}
[ USE CASES ]

What can you build with the GitHub Projects API?

Follow roadmaps

Track the public project boards maintainers use to plan work.

Show planning work

Display someone’s public projects next to their repositories.

Spot active projects

Find open projects that were updated recently.

[ FAQ ]

GitHub Projects API questions

How do I list a GitHub user’s projects?

Send the username. Each public project board comes back with its title, description, link, whether it is open or closed, and its creation and update dates.

Does it return the items on each board?

No. It lists the boards themselves, so you can see which projects a user runs and when they were last updated.

How do I get all of a user’s GitHub projects?

Each call returns up to 10 projects and a nextCursor. Send it back as cursor to get the next page; it is null when there are no more.

How do I use the GitHub Projects API?

Send a POST request to https://api.bridgly.app/github/list-projects with username in the JSON body and your API key in the Authorization header. In the TypeScript SDK, call client.github.listProjects(). AI agents connected to Bridgly over MCP can call the github_list_projects tool.

How much does the GitHub Projects API cost?

Costs 1 credit per request. Credits cost $2.00 per 1,000 on pay-as-you-go and as low as $1.00 per 1,000 at volume. New accounts on a business email start with 100 free credits, and failed requests are never charged.

Try the GitHub Projects API

100 free credits on business email, no card. Your first call takes a minute.

APIMCPSDKCLI
free credits

On business email signup. No credit card required.

Start free with 100 credits