API reference · Campaigns
Get a campaign
GET/v1/campaigns/{campaignId}
Retrieve information about one of your campaigns
Requires a Bearer access token.
Parameters
4 of 12 fields have no description in the spec.
campaignId#stringin pathrequiredincludeMetrics#booleanin queryInclude metrics
includeMatchedDonationsInMetrics#booleanin queryInclude matched donations made by and charged to the beneficiary in the metrics
includeSiteUrl#booleanin queryInclude site url
includeReminders#booleanin queryInclude the reminders of an EMAIL or SLACK campaign, as set with update-campaign-reminders.
includeAssets#booleanin queryInclude assets such as the QR code linking to the campaign page for a public campaign.
includeTranslations#booleanin queryInclude available translations if any for every localized fields.
includeCampaignTemplate#booleanin queryInclude campaign template
Required in the spec, optional for the API.
includeDonationMatching#booleanin queryInclude donation matching
Required in the spec, optional for the API.
includeCharitiesSelection#booleanin queryincludeRecurringDonationsInfo#booleanin queryincludeMatchedDonationsInfo#booleanin query
Response
200 · CampaignNo field is described in the spec.
campaignId#stringalways returnedname#stringalways returnedtype#CampaignTypeTIME_BASEDPERMANENTamountType#CampaignAmountTypeFIXED_AMOUNTFREE_AMOUNTaudienceType#CampaignAudienceTypePRIVATEPUBLICdonationType#CampaignDonationTypeFACE_VALUEDISTRIBUTIONgivingType#GivingTypealways returnedFINANCIALPAYROLLPAID_TIME_OFFrecurringType#RecurringTypealways returnedNONEFREQUENCYMANUALstartDate#string (date-time)always returnedendDate#string (date-time)budget#integer (int64)sendingMode#CampaignSendingModeMANUALEMAILPHYSICALSLACKPOSTALstatus#CampaignStatusDRAFTPENDINGACTIVECOMPLETECANCELEDslug#stringpublicKey#stringalways returnedwithFiscalReceipts#booleanalways returnedlanguage#Languagefrenfrequency#stringbudgetFrequency#stringbillingStatus#BillingStatusalways returnedPENDINGBILLEDPAIDdefaultHideAmount#booleanwithHideAmountCustomization#booleanwithGiftCards#booleanwithLeadCollection#booleanwithoutCustomization#booleanalways returnedmomentType#MomentTypeOCCASIONKEY_MOMENTEDITIONmomentSlug#stringleadCollectionOptions#objectdonationsBilledOn#DonationBilledOnalways returnedCREATIONCLAIMwithDonationsValidation#booleanalways returnedfiscalReceiptType#FiscalReceiptTypealways returnedYEARLYSINGLE_DONATIONfiscalReceiptSendingMode#FiscalReceiptSendingModealways returnedMANUALEMAILdefaultHasBeenCharged#booleanalways returneddefaultFeeType#FeeTypealways returnedEXCLUDEDINCLUDEDdonationValidityPeriod#stringalways returnedtemplate#stringphysicalFormat#PhysicalFormatCUSTOMPRINTPARCELwithEmailWall#booleanpostDonationWidgets#PostDonationWidget[]always returnedtitle#stringdescription#stringlogoUrl#stringfaviconUrl#stringtitleColor#stringaccentColor#stringgivingTarget#integer (int64)message#stringreminderMessage#stringemailSenderName#stringemailSenderPictureUrl#stringemailSubject#stringemailTemplate#stringemailReplyTo#stringemailDisplayCard#booleanlastCustomerReminderId#stringcharitiesSelectionId#stringaccountId#stringalways returnedcampaignTemplateId#stringdonorPlatformId#stringcreatedAt#string (date-time)always returnedupdatedAt#string (date-time)always returned
Errors
400A field is missing, has the wrong type, or is not part of the request schema.
Every request with a body or query is validated.
{ "statusCode": 400, "message": [ "amount must not be less than 1", "property foo should not exist" ], "error": "Bad Request" }401Unauthorized
Missing, expired or invalid access token.
{ "statusCode": 401, "message": "Unauthorized" }403Account closed
{ "message": "Account closed", "code": "ACCOUNT_CLOSED" }404Not Found
{ "statusCode": 404, "message": "Not Found" }
curl -X GET https://api.sandbox.charitips.com/v1/campaigns/<campaignId> \ -H "Authorization: Bearer $CHARITIPS_TOKEN"Request bodies are written for this docs and checked against the API's validation; ids in angle brackets are placeholders. Response values are placeholders built from the schema.