API Reference
API Reference
Complete reference for the FundLoop API
Last updated September 20, 2026
This section provides a complete reference to the FundLoop API, including all available endpoints, request formats, authentication requirements, and response schemas. These APIs enable projects to automate user syncing, revenue reporting, and validation queries.
Base URL
All API requests are served over HTTPS.
Base URL: https://api.fundloop.org/v1
Authentication
Each project must authenticate using a unique API key. This key can be generated from the project dashboard.
Include the key in the Authorization header of all requests:
```
Authorization: Bearer YOUR\_API\_KEY
````
Endpoints
`POST /project-users`
Submit or update your monthly list of active users.
#### Request Body
```json
{
"users": [
{
"id": "user-abc123",
"score": 1,
"comment": "Submitted several bug reports"
},
{
"id": "user-xyz456",
"score": 0.5,
"comment": "Joined two community calls"
}
]
}
````
* id: The user’s unique identifier (Cubid user ID or other authorized ID)
* score: Participation fraction between 0 and 1
* comment: Optional, for internal tracking
---
`POST /contributions`
Report your monthly revenue and calculate your contribution to the FundLoop pool.
#### Request Body
```json
{
"month": "2025-07",
"revenue_usd": 12800,
"contribution_usd": 128
}
```
* month: ISO date string representing the reporting period
* revenue_usd: Gross revenue for that month in USD
* contribution_usd: Your 1% pledge (or equivalent value)
---
`GET /user-validation/{user_id}`
Fetch Cubid validation status for a specific user.
#### Response Format
```json
{
"user_id": "user-abc123",
"tier": 2,
"valid": true,
"last_verified": "2025-06-28T13:32:00Z"
}
```
* tier: Validation tier (0 = unverified, 1 = basic, 2+ = fully validated)
* valid: Boolean flag indicating active validation
* last_verified: Timestamp of the most recent verification
---
Rate Limiting
Standard rate limits apply:
* 100 requests per minute
* Contact support for elevated access
Error Codes
* 401 Unauthorized: Invalid or missing API key
* 422 Unprocessable Entity: Validation error in submitted data
* 500 Internal Server Error: Unexpected error, try again later
Support
For questions, contact dev@fundloop.org or join the #api-support channel in Discord. For SDK integration, see the [SDK Documentation](/docs/sdk-documentation).
```