API reference · Campaigns
Get a campaign report
GET/v1/campaigns/{campaignId}/reports
Retrieve the report generated when the campaign was closed, with its branded assets. Empty until all its assets are generated.
Requires a Bearer access token.
Parameters
This field has no description in the spec.
campaignId#stringin pathrequired
Response
200 · ReportWithAssets10 of 12 fields have no description in the spec.
reportId#stringalways returnedtype#ReportTypealways returnedCAMPAIGNACCOUNTstatus#ReportStatusalways returnedPENDINGSENTstartDate#string (date-time)endDate#string (date-time)accountId#stringalways returnedcampaignId#stringcreatedAt#string (date-time)always returnedupdatedAt#string (date-time)always returnedassets#AssetWithUrl[]always returned11 child fields
assetIdstringalways returnedtypeAssetTypealways returnedREPORT_INTROREPORT_TOP_SDGSREPORT_TOP_CHARITIESREPORT_GLOBALREPORT_CHARITY_FIRSTREPORT_CHARITY_SECONDREPORT_CHARITY_THIRDREPORT_CHARITY_FOURTHREPORT_CHARITY_FIFTHREPORT_OUTROREPORT_VIDEOREPORT_PDFcolorSchemeAssetColorSchemealways returnedDEFAULTCUSTOMERformatAssetFormatalways returnedSTORYFEEDhideAmountbooleanalways returnedfileRefstringalways returnedaccountIdstringalways returnedreportIdstringalways returnedcreatedAtstring (date-time)always returnedupdatedAtstring (date-time)always returnedurlstringalways returnedPublic url of the generated file.
donationsCSV#stringCampaign reports only. CSV of the claimed donations, or of the cast votes for a DISTRIBUTION campaign.
commentsCSV#stringCampaign reports only. CSV of the feedbacks left by the participants, null without any feedback.
Errors
401Unauthorized
Missing, expired or invalid access token.
{ "statusCode": 401, "message": "Unauthorized" }403Account closed
{ "message": "Account closed", "code": "ACCOUNT_CLOSED" }403Forbidden
Your credentials cannot perform this action on this resource. An id from another account answers 404 in the path, 400 in the body or the query.
{ "statusCode": 403, "message": "Forbidden" }404Not Found
No resource with this id on your account: the API answers as if it did not exist.
{ "statusCode": 404, "message": "Not Found" }
curl -X GET https://api.sandbox.charitips.com/v1/campaigns/<campaignId>/reports \ -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.