Skip to content
Aller au contenu
Charitips

API reference · Votes

List votes

GET/v1/votes

List all your casted and uncasted votes.

Requires a Bearer access token.

Parameters

  • limit#numberin query

    The max number of items to return.

  • cursor#stringin query

    The id of the last item from the previous page. Used to fetch the next page.

  • createdAt_lt#string (date-time)in query

    Format: YYYY-MM-DDTHH:MM:SSZ.

  • createdAt_lte#string (date-time)in query

    Format: YYYY-MM-DDTHH:MM:SSZ.

  • createdAt_gt#string (date-time)in query

    Format: YYYY-MM-DDTHH:MM:SSZ.

  • createdAt_gte#string (date-time)in query

    Format: YYYY-MM-DDTHH:MM:SSZ.

  • campaignId#stringin queryUUID

    Id of one your campaigns

  • externalId#stringin query

    An optional internal id of your system e.g orderId or customerId. Can be used to link a donation to an entity in your system.

  • uniqueExternalId#stringin query

    Similar to externalId but should be unique across all votes. Can be used to prevent duplicate votes.

  • accountId#stringin queryUUID

    Id of the account. Only useful for Platform customers to filter donations by child accounts

  • includeUrl#booleanin query

    Include the url to the page where the vote can be casted

  • includeAssets#booleanin query

    Include dynamic assets such as donation cards and QR code

  • donorId#stringin queryUUID

    Id of the donor.

Response

200 · Vote[]

No field is described in the spec.

  • voteId#stringalways returned

  • weight#number

  • status#VoteStatusalways returned

    PENDINGDONEPROCESSED

  • secret#stringalways returned

  • externalId#string

  • uniqueExternalId#string

  • castedAt#string (date-time)

  • validatedAt#string (date-time)

  • processedAt#string (date-time)

  • billingStatus#BillingStatusalways returned

    PENDINGBILLEDPAID

  • autoAssigned#boolean

  • sendingMode#CampaignSendingModealways returned

    MANUALEMAILPHYSICALSLACKPOSTAL

  • sendingDate#string (date-time)

  • sendingStatus#DonationSendingStatusalways returned

    PENDINGFAILEDDONE

  • lastReminderId#string

  • message#string

  • reminderMessage#string

  • from#string

  • language#Languagealways returned

    fren

  • sharedOn#SocialNetwork

    LINKEDININSTAGRAMFACEBOOKTWITTERWHATSAPP

  • accountId#stringalways returned

  • campaignId#stringalways returned

  • charityId#string

  • transactionId#string

  • donorId#string

  • createdAt#string (date-time)always returned

  • updatedAt#string (date-time)always returned

Errors

  • 400Invalid parameter includeDonor
    {
      "statusCode": 400,
      "message": "Invalid parameter includeDonor",
      "error": "Bad Request"
    }
  • 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"
    }
GET /v1/votes
curl -X GET https://api.sandbox.charitips.com/v1/votes \  -H "Authorization: Bearer $CHARITIPS_TOKEN"
Built from the spec and the API code

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.