Skip to main content
GET
/
api
/
orgs
/
:idOrSlug
/
campaigns
List Campaigns
curl --request GET \
  --url https://api.example.com/api/orgs/:idOrSlug/campaigns
{
  "data": [
    {
      "id": "<string>",
      "orgId": "<string>",
      "title": "<string>",
      "slug": "<string>",
      "description": {},
      "type": "<string>",
      "status": "<string>",
      "goalAmountCents": {},
      "raisedAmountCents": 123,
      "donationCount": 123,
      "coverImageUrl": {},
      "videoUrl": {},
      "color": {},
      "showDonorRoll": true,
      "showGoal": true,
      "startDate": {},
      "endDate": {},
      "suggestedAmounts": [
        {}
      ],
      "allowCustomAmount": true,
      "allowRecurring": true,
      "matchingEnabled": true,
      "matchingOrgName": {},
      "matchingMaxCents": {},
      "matchingRatioPct": 123,
      "minAmountCents": {},
      "ticketPriceCents": {},
      "ticketCapacity": {},
      "ticketsSold": 123,
      "parentCampaignId": {},
      "scheduledPublishAt": {},
      "createdAt": "<string>",
      "updatedAt": "<string>"
    }
  ]
}

​
List Campaigns

Returns all campaigns belonging to an organization. Requires authentication and org membership.

​
Path Parameters

​
idOrSlug
string
required
The organization’s internal ID or URL slug (e.g., "habitat-for-humanity").

​
Authentication

Requires a valid Clerk session JWT in the Authorization: Bearer header. The authenticated user must be a member of the specified organization.

​
Response

​
data
array
Array of campaign objects belonging to the organization, ordered by creation date descending (newest first).

​
Example

curl https://givelink-api-production.up.railway.app/api/orgs/habitat-for-humanity/campaigns \
  -H "Authorization: Bearer <clerk-session-jwt>"

{
  "data": [
    {
      "id": "clx9876543210",
      "orgId": "clxabc123456",
      "title": "Spring 2026 Annual Fund",
      "slug": "spring-2026-annual-fund",
      "description": "Help us reach our goal before June 30.",
      "type": "DONATION",
      "status": "ACTIVE",
      "goalAmountCents": 5000000,
      "raisedAmountCents": 1245000,
      "donationCount": 87,
      "coverImageUrl": "https://cdn.givelink.ai/images/abc123.jpg",
      "videoUrl": null,
      "color": "#C4501E",
      "showDonorRoll": true,
      "showGoal": true,
      "startDate": "2026-03-01T00:00:00.000Z",
      "endDate": "2026-06-30T23:59:59.000Z",
      "suggestedAmounts": [2500, 5000, 10000, 25000],
      "allowCustomAmount": true,
      "allowRecurring": true,
      "matchingEnabled": false,
      "matchingOrgName": null,
      "matchingMaxCents": null,
      "matchingRatioPct": 100,
      "minAmountCents": null,
      "ticketPriceCents": null,
      "ticketCapacity": null,
      "ticketsSold": 0,
      "parentCampaignId": null,
      "scheduledPublishAt": null,
      "createdAt": "2026-02-15T10:30:00.000Z",
      "updatedAt": "2026-03-01T00:00:01.000Z"
    }
  ]
}

​
Error Responses

StatusErrorDescription
401UnauthorizedMissing or invalid Authorization header.
403ForbiddenAuthenticated user is not a member of this organization.
404Organization not foundNo org exists with the given ID or slug.