Repository Endpoints

JSON values on this page are illustrative response shapes, not a live platform snapshot. Repository counts, scores, timestamps, and enrichment fields change as the corpus is refreshed; use the API response as the source of truth.

Common tasks

Goal	Request	Useful parameters
Browse the strongest repositories	`GET /api/repos`	`sort_by=score`, `sort_order=desc`, `page_size`.
Find a repository by name	`GET /api/search`	`q`, `page`, `page_size`.
Check current corpus coverage	`GET /api/stats`	None; read the returned aggregate fields.

All repository endpoints

Health Check

This is the only endpoint that does not require authentication.

GET /

Returns the service health status and high-level graph statistics. Example

curl https://api.agentic.forwardlane.com/

Response

{
  "status": "healthy",
  "service": "FL Repos Intelligence API",
  "repositories": 131,
  "graph_nodes": 22104,
  "graph_edges": 75735
}

List Repositories

GET /api/repos

Returns a paginated list of all repositories. Supports rich filtering and sorting.

Query Parameters

Parameter	Type	Default	Description
`language`	string	—	Filter by primary language (e.g. `python`, `javascript`, `typescript`).
`project`	string	—	Filter by project name substring.
`tier`	integer	—	Filter by tier (`1`, `2`, or `3`).
`min_contributors`	integer	—	Only repos with at least this many contributors.
`min_commits`	integer	—	Only repos with at least this many commits.
`sort_by`	string	`name`	Field to sort by: `name`, `score`, `commits`, `contributors`, `stars`.
`sort_order`	string	`asc`	Sort direction: `asc` or `desc`.
`page`	integer	`1`	Page number (1-indexed).
`page_size`	integer	`20`	Items per page (max 100).

Examples

curl -H "Authorization: Bearer $FL_API_TOKEN" \
  "https://api.agentic.forwardlane.com/api/repos?sort_by=score&sort_order=desc&limit=10"

curl -H "Authorization: Bearer $FL_API_TOKEN" \
  "https://api.agentic.forwardlane.com/api/repos?language=python&tier=1"

curl -H "Authorization: Bearer $FL_API_TOKEN" \
  "https://api.agentic.forwardlane.com/api/repos?min_commits=500&min_contributors=3&sort_by=commits&sort_order=desc"

Response

{
  "items": [
    {
      "name": "forwardlane-backend",
      "description": "Core Django REST API service",
      "language": "Python",
      "tier": 1,
      "score": 98.4,
      "commit_count": 4821,
      "contributor_count": 12,
      "stars": 0,
      "is_private": true,
      "last_commit_date": "2024-11-15T14:23:00Z",
      "topics": ["django", "api", "finance"],
      "project": "backend"
    }
  ],
  "total": 131,
  "page": 1,
  "page_size": 20,
  "pages": 7
}

Get Repository Detail

GET /api/repos/{name}

Returns full metadata and statistics for a single repository.

Path Parameters

Parameter	Type	Description
`name`	string	The repository name (e.g. `forwardlane-backend`).

Example

curl -H "Authorization: Bearer $FL_API_TOKEN" \
  https://api.agentic.forwardlane.com/api/repos/forwardlane-backend

Response

{
  "name": "forwardlane-backend",
  "description": "Core Django REST API service",
  "language": "Python",
  "tier": 1,
  "score": 98.4,
  "commit_count": 4821,
  "contributor_count": 12,
  "stars": 0,
  "is_private": true,
  "created_at": "2018-03-12T10:00:00Z",
  "last_commit_date": "2024-11-15T14:23:00Z",
  "topics": ["django", "api", "finance"],
  "project": "backend",
  "default_branch": "main",
  "size_kb": 18340,
  "open_issues": 0,
  "has_ci": true,
  "has_docker": true,
  "has_tests": true,
  "primary_language_pct": 92.3,
  "dependencies_count": 87,
  "function_count": 1243,
  "class_count": 318,
  "model_count": 64,
  "endpoint_count": 201,
  "test_count": 512,
  "security_issues": 3
}

If the repository is not found, the API returns 404:

{
  "detail": "Repository 'unknown-repo' not found"
}

Platform Statistics

GET /api/stats

Returns aggregate statistics across the currently enriched repository corpus.

Example

curl -H "Authorization: Bearer $FL_API_TOKEN" \
  https://api.agentic.forwardlane.com/api/stats

Response

The fields below are representative. Treat the returned values as the current enrichment snapshot.

{
  "total_repos": 131,
  "total_commits": 284930,
  "total_contributors": 47,
  "total_functions": 18420,
  "total_classes": 4210,
  "total_models": 312,
  "total_endpoints": 1847,
  "total_tests": 6930,
  "total_security_issues": 84,
  "languages": {
    "Python": 89,
    "TypeScript": 23,
    "JavaScript": 12,
    "Go": 4,
    "Other": 3
  },
  "tiers": {
    "1": 18,
    "2": 52,
    "3": 61
  },
  "graph_nodes": 22104,
  "graph_edges": 75735
}

Tier Groups

GET /api/tiers

Returns repositories grouped by tier, making it easy to see which repos are in each tier without additional filtering.

Example

curl -H "Authorization: Bearer $FL_API_TOKEN" \
  https://api.agentic.forwardlane.com/api/tiers

Response

{
  "tier_1": [
    {
      "name": "forwardlane-backend",
      "score": 98.4,
      "language": "Python",
      "commit_count": 4821
    }
  ],
  "tier_2": [...],
  "tier_3": [...]
}

Rankings

GET /api/rankings

Returns the top N repositories ranked by composite score. Optionally filter by tier.

Query Parameters

Parameter	Type	Default	Description
`top_n`	integer	`10`	How many repos to return.
`tier`	integer	—	Restrict ranking to repos in this tier.

Examples

curl -H "Authorization: Bearer $FL_API_TOKEN" \
  "https://api.agentic.forwardlane.com/api/rankings?top_n=20"

curl -H "Authorization: Bearer $FL_API_TOKEN" \
  "https://api.agentic.forwardlane.com/api/rankings?top_n=5&tier=1"

Response

{
  "rankings": [
    {
      "rank": 1,
      "name": "forwardlane-backend",
      "score": 98.4,
      "tier": 1,
      "language": "Python",
      "commit_count": 4821,
      "contributor_count": 12
    },
    {
      "rank": 2,
      "name": "forwardlane-frontend",
      "score": 91.2,
      "tier": 1,
      "language": "TypeScript",
      "commit_count": 3204,
      "contributor_count": 9
    }
  ],
  "total_ranked": 131,
  "filter": {
    "tier": null,
    "top_n": 10
  }
}

Full-Text Search

GET /api/search

Searches repository names and descriptions for a keyword or phrase.

Query Parameters

Parameter	Type	Required	Description
`q`	string	Yes	Search query (substring match on name and description).
`page`	integer	No	Page number.
`page_size`	integer	No	Items per page.

Example

curl -H "Authorization: Bearer $FL_API_TOKEN" \
  "https://api.agentic.forwardlane.com/api/search?q=authentication"

Response

{
  "items": [
    {
      "name": "fl-auth-service",
      "description": "Authentication and authorization microservice",
      "language": "Python",
      "tier": 1,
      "score": 84.1
    }
  ],
  "total": 3,
  "query": "authentication",
  "page": 1,
  "page_size": 20,
  "pages": 1
}

See the Search guide for tips on writing effective search queries.

Get Started

Products

API Reference

CLI

FL Web

Python SDK

MCP Server

Graph Schema

Repositories

Repository Endpoints

Common tasks

All repository endpoints

Health Check

List Repositories

Query Parameters

Examples

Response

Get Repository Detail

Path Parameters

Example

Response

Platform Statistics

Example

Response

Tier Groups

Example

Response

Rankings

Query Parameters

Examples

Response

Full-Text Search

Query Parameters

Example

Response

​Repository Endpoints

​Common tasks

​All repository endpoints

​Health Check

​List Repositories

​Query Parameters

​Examples

​Response

​Get Repository Detail

​Path Parameters

​Example

​Response

​Platform Statistics

​Example

​Response

​Tier Groups

​Example

​Response

​Rankings

​Query Parameters

​Examples

​Response

​Full-Text Search

​Query Parameters

​Example

​Response

Repository Endpoints

Common tasks

All repository endpoints

Health Check

List Repositories

Query Parameters

Examples

Response

Get Repository Detail

Path Parameters

Example

Response

Platform Statistics

Example

Response

Tier Groups

Example

Response

Rankings

Query Parameters

Examples

Response

Full-Text Search

Query Parameters

Example

Response