RaiseIt API Reference

Overview #

The RaiseIt API provides programmatic access to campaigns, pledges, users, and analytics. All endpoints require authentication and support standard HTTP methods. Responses are returned in JSON format.

ℹ️

Base URL: https://api.raiseit.com/v1
All requests must be made over HTTPS.

Authentication #

Access the API using your secret API key or OAuth 2.0 Bearer token. Include credentials in the request headers:

curl -X GET "https://api.raiseit.com/v1/campaigns" \
  -H "Authorization: Bearer $RAISEIT_API_KEY"const response = await fetch('https://api.raiseit.com/v1/campaigns', {
  headers: {
    'Authorization': `Bearer ${process.env.RAISEIT_API_KEY}`
  }
});

🔒

Keep your API keys secure. Never expose them in client-side code or public repositories. Rotate keys via the Developer Dashboard.

Rate Limits #

API requests are rate-limited to ensure platform stability. Limits are applied per API key:

Free Tier: 100 requests / minute
Pro Tier: 1,000 requests / minute
Enterprise: Custom limits (up to 10k/min)

Rate limit headers are included in every response: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset.

Endpoints #

GET /campaigns

Retrieve a paginated list of active campaigns. Supports filtering by status, category, and creation date.

Parameter	Type	Required	Description
`status`	string	optional	Filter by: `active`, `completed`, `cancelled`
`category`	string	optional	Filter by campaign category slug
`limit`	integer	optional	Number of results (default: 20, max: 100)

POST /campaigns

Create a new crowdfunding campaign. Requires a valid user context and project details.

title"Smart Garden AI"description"Autonomous hydroponics system for urban spaces"goal_amount2500000currency"USD"category"technology"duration_days30
}

POST /campaigns/{id}/pledges

Create a new pledge for a campaign. Automatically processes payment and updates campaign progress.

Parameter	Type	Required	Description
`amount`	integer	required	Pledge amount in cents
`payment_method`	string	required	Stripe customer ID or token
`tier`	string	optional	Reward tier ID if applicable

Webhooks #

Receive real-time HTTP POST notifications when events occur in your RaiseIt account. Configure webhook endpoints via the Dashboard or API.

id"evt_8x29dk3j2"type"campaign.pledged"timestamp"2025-11-20T14:32:00Z"datacampaign_id"cmp_92j3kd"pledge_amount2500total_raised1485000
}
}

🔐

Verify webhook signatures using the X-RaiseIt-Signature header and your webhook secret. Payloads are signed with HMAC-SHA256.

Error Codes #

RaiseIt uses standard HTTP status codes. Detailed error information is returned in the response body.

Status	Code	Description
400	invalid_request	Malformed payload or missing required parameters
401	unauthorized	Missing or invalid API key/token
404	not_found	Requested resource does not exist
429	rate_limited	Too many requests. Retry after reset window
500	internal_error	Server error. Contact support if persistent

SDKs & Libraries #

Official and community-maintained libraries for rapid integration:

npm install @raiseit/sdk — TypeScript/Node.js
pip install raiseit-py — Python
gem install raiseit-ruby — Ruby
composer require raiseit/php — PHP

Full documentation for each SDK is available in the Developer Dashboard. Contribute to community libraries via our open GitHub organization.