Goals.Gives
Back to Home

API Reference

Complete reference for the Goals.Gives REST API.

Base URLhttps://goals-referral-api.goalsfinance.workers.dev

Authentication

All authenticated endpoints require an API key passed in the X-API-Key header. Paste your API key below to enable the "Try It" feature on authenticated endpoints.

Rate Limits

120

requests / minute

30

webhook req / minute

Exceeding limits returns 429 Too Many Requests.

Error Handling

All errors follow a consistent format:

{
  "success": false,
  "error": "Description of what went wrong"
}
400 Bad Request
401 Unauthorized
403 Forbidden
404 Not Found
409 Conflict
429 Rate Limited
500 Server Error

Authentication

Referral Codes

Goals

Creative Generation

Partner Stats

Leaderboard

Webhook Subscriptions

Webhook Events (Incoming)

Need help? Reach out at api@goals.gives