Skip to main content
GET
/
projects
List projects
curl --request GET \
  --url https://api.corebill.io/v1/projects \
  --header 'Authorization: Bearer <token>'
{
  "data": {
    "projects": [
      {
        "id": "pro_a1b2c3d4e5f6",
        "public_id": "PRO-2025-000001",
        "company_id": "com_a1b2c3d4e5f6",
        "customer_id": "cus_a1b2c3d4e5f6",
        "title": "Website Redesign",
        "description": "Complete redesign of the marketing website",
        "status": "in_progress",
        "priority": "high",
        "start_date": "2025-03-01",
        "due_date": "2025-05-01",
        "billing_type": "time_based",
        "budget_hours": 200,
        "budget_amount": 15000,
        "hourly_rate": 75,
        "progress_percentage": 45,
        "is_archived": false,
        "customer_name": "Acme Corp",
        "total_hours": 90.5,
        "total_revenue": 6787.5,
        "total_cost": 3393.75,
        "profit": 3393.75,
        "tasks_count": 12,
        "completed_tasks": 5,
        "created_at": "2025-03-01T10:00:00Z",
        "updated_at": "2025-04-15T14:30:00Z"
      }
    ],
    "pagination": {
      "total": 42,
      "limit": 50,
      "offset": 0
    }
  }
}

Authorizations

Authorization
string
header
required

API key authentication. Generate keys from the Corebill dashboard under the Developers section.

Example: Authorization: Bearer sk_live_abc123def456

Query Parameters

company_id
string
required

The company ID to scope the request to

limit
integer
default:50

Maximum number of records to return (default 50)

Required range: 1 <= x <= 100
offset
integer
default:0

Number of records to skip for pagination (default 0)

Required range: x >= 0
status
string

Filter by status. Comma-separated for multiple values (e.g. in_progress,review)

Example:

"in_progress"

priority
string

Filter by priority. Comma-separated for multiple values

Example:

"high"

customer_id
string

Filter by customer ID

Example:

"cus_a1b2c3d4e5f6"

assigned_to
string

Filter by assigned user ID

is_archived
boolean
default:false

Include archived projects

Search by title or public ID

start_date_from
string<date>

Filter projects starting from this date

start_date_to
string<date>

Filter projects starting up to this date

due_date_from
string<date>

Filter projects due from this date

due_date_to
string<date>

Filter projects due up to this date

Response

List of projects

data
object
required