GET /v1/forms — list your donation forms

The List Forms endpoint returns all donation forms associated with your CharityStack account. Each form object includes the public URL, fund assignments, available frequencies, styling options, and active status. Forms that have been deleted are excluded from the list. Use the limit and lastEvaluatedKey parameters to page through results.

The list endpoint returns a summary of each form. To retrieve the full configuration (amounts, tickets, toggles, custom inputs, etc.), use Get Form by ID.

Endpoint

GET https://0k90mc4jjj.execute-api.us-east-2.amazonaws.com/v1/forms

Authentication

Authorization

string

required

Bearer token using your API key. Format: Bearer cs_live_your_key

Query parameters

limit

number

default:"50"

Maximum number of forms to return per page. Accepted range is 1–100.

lastEvaluatedKey

string

Pagination cursor from a previous response. Pass this to retrieve the next page.

Response

forms

FormSummary[]

required

Array of form summary objects for your account.

Show Form summary fields

formID

string

Unique identifier for the form.

formUrl

string

Public URL where donors can access the form (e.g., https://charitystack.com/donate/form_abc123).

title

string

Display name for the form.

description

string

Form description text shown to donors.

formType

string

Internal form type. One of: EMBED_FORM, CROWDFUNDING_FORM, PRODUCT, EVENT. See Form type mapping for how these relate to the formType and amountType values used during creation.

funds

string[]

List of fund names available on the form.

frequencies

string[]

Enabled donation frequencies. Possible values: ONE_TIME, DAILY, WEEKLY, MONTHLY, ANNUALLY.

color

string

Hex color code used for form styling (e.g., #3B82F6).

headerImage

string

URL of the form’s header image, if set.

active

boolean

Whether the form is currently active and accepting donations.

goal

number

Fundraising goal amount. Present when the fundraising bar is enabled.

eventDate

string

Event date in YYYY-MM-DD format. Present on event forms.

startTime

string

Event start time in HH:MM 24-hour format. Present on event forms.

endTime

string

Event end time in HH:MM 24-hour format. Present on event forms.

location

string

Event location. Present on event forms.

count

number

required

Number of forms returned in this response page.

hasMore

boolean

required

true if additional pages of results exist.

lastEvaluatedKey

string

Pagination cursor for the next request. Only present when hasMore is true.

Example

cURL

curl https://0k90mc4jjj.execute-api.us-east-2.amazonaws.com/v1/forms?limit=25 \
  -H "Authorization: Bearer cs_live_your_key"

200 response

{
  "forms": [
    {
      "formID": "550e8400-e29b-41d4-a716-446655440000",
      "formUrl": "https://charitystack.com/donate/550e8400-e29b-41d4-a716-446655440000",
      "title": "Annual Giving Campaign 2025",
      "description": "Support our mission with a tax-deductible donation.",
      "formType": "CROWDFUNDING_FORM",
      "funds": ["General Fund", "Education Program"],
      "frequencies": ["ONE_TIME", "MONTHLY"],
      "color": "#2563EB",
      "headerImage": "https://example.com/images/campaign-header.jpg",
      "active": true,
      "goal": 50000
    },
    {
      "formID": "661f9511-f30c-52e5-b827-557766551111",
      "formUrl": "https://charitystack.com/donate/661f9511-f30c-52e5-b827-557766551111",
      "title": "Annual Gala 2025",
      "description": "Join us for an evening of celebration.",
      "formType": "EVENT",
      "funds": ["Event Fund"],
      "frequencies": ["ONE_TIME"],
      "color": "#7C3AED",
      "headerImage": "",
      "active": true,
      "eventDate": "2025-06-15",
      "startTime": "18:00",
      "endTime": "22:00",
      "location": "Grand Ballroom, 123 Main St"
    }
  ],
  "count": 2,
  "hasMore": false
}

​Endpoint

​Authentication

​Query parameters

​Response

​Example

Endpoint

Authentication

Query parameters

Response

Example