API Reference

The Commitloom REST API allows you to retrieve review results, trigger on-demand reviews, and manage integration settings programmatically.

Authentication

All API requests require a Bearer token. Generate an API key from your Commitloom dashboard under Settings → API Keys.

Authorization: Bearer clm_live_xxxxxxxxxxxxxxxxxxxxxxxxxx

Keep your API key secret. Do not commit it to source control or include it in client-side code.

https://api.commitloom.com/v1

GET /reviews

List all reviews for repositories connected to your account. Supports pagination and filtering by repo, date range, and severity.

Query parameters:

Parameter	Type	Description
`repo`	string	Filter by repository slug (e.g. `owner/repo`)
`since`	ISO 8601	Reviews opened after this date
`limit`	integer	Max results, default 20, max 100
`cursor`	string	Pagination cursor from previous response

GET /reviews/{review_id}

Get a single review result, including all comments and the generated summary.

POST /reviews/trigger

Trigger an on-demand review of an existing pull request.

Request body:

{
  "repo": "owner/repo-name",
  "pr_number": 247
}

Response:

{
  "review_id": "rev_01hxyz...",
  "status": "queued",
  "estimated_ready_at": "2026-02-18T14:31:45Z"
}

GET /repositories

List all repositories connected to your Commitloom account.

DELETE /repositories/{repo_id}

Disconnect a repository from Commitloom. Existing reviews are not deleted.

API requests are limited to 60 requests per minute per API key. Rate limit headers are included in every response:

X-RateLimit-Limit: 60
X-RateLimit-Remaining: 54
X-RateLimit-Reset: 1708266700

All errors return a JSON body:

{
  "error": {
    "code": "not_found",
    "message": "Review rev_01abc not found or not accessible"
  }
}