Skip to main content
GET
https://api.givebutter.com
/
v1
/
campaigns
curl "https://api.givebutter.com/v1/campaigns?page=1&per_page=20" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "data": [
    {
      "id": "camp_abc123",
      "title": "Annual Gala 2024",
      "goal": 5000000,
      "total_raised": 1250000,
      "status": "active",
      "url": "https://givebutter.com/annual-gala-2024",
      "created_at": "2024-01-15T10:30:00Z",
      "updated_at": "2024-01-20T14:22:00Z"
    },
    {
      "id": "camp_def456",
      "title": "Summer Camp Scholarships",
      "goal": 2500000,
      "total_raised": 2750000,
      "status": "completed",
      "url": "https://givebutter.com/summer-camp-2024",
      "created_at": "2024-01-10T09:15:00Z",
      "updated_at": "2024-01-18T16:45:00Z"
    }
  ],
  "links": {
    "first": "https://api.givebutter.com/v1/campaigns?page=1",
    "last": "https://api.givebutter.com/v1/campaigns?page=5",
    "prev": null,
    "next": "https://api.givebutter.com/v1/campaigns?page=2"
  },
  "meta": {
    "current_page": 1,
    "per_page": 20,
    "total": 87
  }
}
Returns a list of campaigns you’ve created. The campaigns are returned sorted by creation date, with the most recent campaigns appearing first.

​
Query Parameters

​
page
integer
default:"1"
The page number to retrieve. Pages start at 1.
​
per_page
integer
default:"20"
Number of campaigns to return per page. Maximum of 100.
​
status
string
Filter by campaign status. Options: draft, active, paused, completed
​
search
string
Search campaigns by title or description.

​
Response

​
data
array
Array of campaign objects
​
links
object
Pagination links
​
meta
object
Pagination metadata
curl "https://api.givebutter.com/v1/campaigns?page=1&per_page=20" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "data": [
    {
      "id": "camp_abc123",
      "title": "Annual Gala 2024",
      "goal": 5000000,
      "total_raised": 1250000,
      "status": "active",
      "url": "https://givebutter.com/annual-gala-2024",
      "created_at": "2024-01-15T10:30:00Z",
      "updated_at": "2024-01-20T14:22:00Z"
    },
    {
      "id": "camp_def456",
      "title": "Summer Camp Scholarships",
      "goal": 2500000,
      "total_raised": 2750000,
      "status": "completed",
      "url": "https://givebutter.com/summer-camp-2024",
      "created_at": "2024-01-10T09:15:00Z",
      "updated_at": "2024-01-18T16:45:00Z"
    }
  ],
  "links": {
    "first": "https://api.givebutter.com/v1/campaigns?page=1",
    "last": "https://api.givebutter.com/v1/campaigns?page=5",
    "prev": null,
    "next": "https://api.givebutter.com/v1/campaigns?page=2"
  },
  "meta": {
    "current_page": 1,
    "per_page": 20,
    "total": 87
  }
}

​
Filtering Campaigns

You can filter campaigns by status: 
# Get only active campaigns
curl "https://api.givebutter.com/v1/campaigns?status=active" \
  -H "Authorization: Bearer YOUR_API_KEY"

# Get only draft campaigns
curl "https://api.givebutter.com/v1/campaigns?status=draft" \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Searching Campaigns

Search campaigns by title or description: 
curl "https://api.givebutter.com/v1/campaigns?search=gala" \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Pagination

See the Pagination guide for details on iterating through results.

​
Next Steps

Get Campaign

Retrieve a single campaign by ID

Create Campaign

Create a new campaign

Campaign Object

Learn about the campaign object structure

Transactions

View campaign transactions