Bonterra (fka EveryAction) Score Updates API

openapi: 3.2.0
info:
  title: everyaction-8 Score Updates API
  version: '1.0'
servers:
- url: https://api.securevan.com/v4
security:
- sec0: []
tags:
- name: ScoreUpdates
paths:
  /scoreUpdates:
    get:
      summary: /scoreUpdates
      description: Get all available Score Updates, optionally filtered by search parameters.
      operationId: scoreupdates
      parameters:
      - name: createdBefore
        in: query
        description: Optional; Filters Score Updates to those created before (and not including) a given date (in the format yyyy-mm-dd)
        schema:
          type: string
          format: date
          default: '2021-12-31'
      - name: createdAfter
        in: query
        description: Optional; Filters Score Updates to those created after (and not including) a given date (in the format yyyy-mm-dd)
        schema:
          type: string
          format: date
          default: '2021-01-01'
      - name: scoreId
        in: query
        description: Optional; Filters Score Updates to those of the given score
        schema:
          type: integer
          format: int32
          default: 999
      responses:
        '200':
          description: '200'
          content:
            application/json:
              examples:
                Result:
                  value: "{\n  \"items\": [\n    {\n      \"scoreUpdateId\": 1888,\n      \"score\": {\n        \"scoreId\": 888,\n        \"name\": \"Baseball cap wearer\",\n        \"shortName\": \"Likelihood of wearing a baseball cap\",\n        \"description\": \"Indicates our best guess as to whether this voter wears a baseball cap\",\n        \"minValue\": 1.00,\n        \"maxValue\": 100.00,\n      },\n      \"updateStatistics\": {\n        \"totalRows\": 100,\n        \"duplicateRows\": 3,\n        \"matchedRows\": 100,\n        \"matchPercent\": 100.0,\n        \"increasedBy\": 100,\n        \"decreasedBy\": 0,\n        \"nulledOut\": 0,\n        \"added\": 0,\n        \"outOfRange\": 0,\n        \"badValues\": 1,\n        \"maxValue\": 10.0,\n        \"minValue\": 90.00,\n        \"averageValue\": 50.0,\n        \"medianValue\": 47.0\n      },\n      \"loadStatus\": \"Completed\",\n      \"dateProcessed\": \"2015-08-23T02:00:00Z\"\n    }\n  ],\n  \"nextPageLink\": null,\n  \"count\": 1\n}"
        '400':
          description: '400'
          content:
            application/json:
              examples:
                Result:
                  value: "{\n    \"errors\": [\n        {\n            \"code\": \"Error code\",\n            \"text\": \"Error description\"\n        }\n    ]\n}"
              schema:
                type: object
                properties:
                  errors:
                    type: array
                    items:
                      type: object
                      properties:
                        code:
                          type: string
                          example: Error code
                        text:
                          type: string
                          example: Error description
      deprecated: false
      tags:
      - ScoreUpdates
  /scoreUpdates/{scoreUpdateId}:
    get:
      summary: /scoreUpdates/{scoreUpdateId}
      description: Retrieve a single score update
      operationId: scoreupdatesscoreupdateid
      parameters:
      - name: scoreUpdateId
        in: path
        description: Required; Unique identifier of the score update to be retrieved
        schema:
          type: integer
          format: int32
          default: 1888
        required: true
      responses:
        '200':
          description: '200'
          content:
            application/json:
              examples:
                Result:
                  value: "{\n  \"scoreUpdateId\": 1888,\n  \"score\": {\n    \"scoreId\": 888,\n    \"name\": \"Baseball cap wearer\",\n    \"shortName\": \"Likelihood of wearing a baseball cap\",\n    \"description\": \"Indicates our best guess as to whether this voter wears a baseball cap\",\n    \"minValue\": 1.00,\n    \"maxValue\": 100.00,\n  },\n  \"updateStatistics\": {\n    \"totalRows\": 100,\n    \"duplicateRows\": 3,\n    \"matchedRows\": 100,\n    \"matchPercent\": 100.0,\n    \"increasedBy\": 100,\n    \"decreasedBy\": 0,\n    \"nulledOut\": 0,\n    \"added\": 0,\n    \"outOfRange\": 0,\n    \"badValues\": 1,\n    \"maxValue\": 10.0,\n    \"minValue\": 90.00,\n    \"averageValue\": 50.0,\n    \"medianValue\": 47.0\n  },\n  \"loadStatus\": \"Completed\",\n  \"dateProcessed\": \"2015-08-23T02:00:00Z\"\n}"
        '400':
          description: '400'
          content:
            application/json:
              examples:
                Result:
                  value: "{\n    \"errors\": [\n        {\n            \"code\": \"Error code\",\n            \"text\": \"Error description\"\n        }\n    ]\n}"
              schema:
                type: object
                properties:
                  errors:
                    type: array
                    items:
                      type: object
                      properties:
                        code:
                          type: string
                          example: Error code
                        text:
                          type: string
                          example: Error description
        '404':
          description: '404'
          content:
            application/json:
              examples:
                Result:
                  value: "{\n  \"errors\": [\n    {\n      \"code\": \"NOT_FOUND\",\n      \"text\": \"The specified resource cannot be found.\"\n    }\n  ]\n}"
              schema:
                type: object
                properties:
                  errors:
                    type: array
                    items:
                      type: object
                      properties:
                        code:
                          type: string
                          example: NOT_FOUND
                        text:
                          type: string
                          example: The specified resource cannot be found.
      deprecated: false
      tags:
      - ScoreUpdates
    patch:
      summary: /scoreUpdates/{scoreUpdateId}
      description: Changes the status of a score (e.g., from `PendingApproval` to `Approved`). Score updates that are approved, are applied at off-peak hours.
      operationId: scoreupdatesscoreupdateid-1
      parameters:
      - name: scoreUpdateId
        in: path
        description: Required; Unique identifier of the score update to be changed
        schema:
          type: integer
          format: int32
          default: 1888
        required: true
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                loadStatus:
                  type: string
                  description: 'Required; The new status for a score update; one of: `PendingApproval` → Score updates in the pending state will not be applied, `Approved` → Approves the score update for application during off-peak hours, `Disapproved` → Explicitly indicates the score update should not be applied (e.g., because the load statistics indicate an issue with a source file), `Canceled` → Cancel the score update process (does not stop anything that is currently in process, behaves the same as Disapproved'
                  default: Approved
      responses:
        '204':
          description: '204'
          content:
            application/json:
              examples:
                Result:
                  value: ''
        '400':
          description: '400'
          content:
            application/json:
              examples:
                Result:
                  value: "{\n    \"errors\": [\n        {\n            \"code\": \"Error code\",\n            \"text\": \"Error description\"\n        }\n    ]\n}"
              schema:
                type: object
                properties:
                  errors:
                    type: array
                    items:
                      type: object
                      properties:
                        code:
                          type: string
                          example: Error code
                        text:
                          type: string
                          example: Error description
        '404':
          description: '404'
          content:
            application/json:
              examples:
                Result:
                  value: "{\n  \"errors\": [\n    {\n      \"code\": \"NOT_FOUND\",\n      \"text\": \"The specified resource cannot be found.\"\n    }\n  ]\n}"
              schema:
                type: object
                properties:
                  errors:
                    type: array
                    items:
                      type: object
                      properties:
                        code:
                          type: string
                          example: NOT_FOUND
                        text:
                          type: string
                          example: The specified resource cannot be found.
      deprecated: false
      tags:
      - ScoreUpdates
components:
  securitySchemes:
    sec0:
      type: http
      scheme: basic
x-readme-fauxas: true
x-provenance:
  method: searched
  source: https://docs.everyaction.com/reference
  harvested: '2026-10-14'
  tool: harvest-readme-openapi.py
  note: Assembled verbatim from the OpenAPI definition ReadMe embeds in each operation page of the provider's developer portal; paths and components merged by API title, nothing authored.
  assembled_from:
  - https://docs.everyaction.com/reference/activistcodes-activistcodeid.md
  - https://docs.everyaction.com/reference/activistcodes.md
  - https://docs.everyaction.com/reference/ballotrequesttypes-ballotrequesttypeid.md
  - https://docs.everyaction.com/reference/ballotrequesttypes.md
  - https://docs.everyaction.com/reference/ballotreturnstatuses-ballotreturnstatusid.md
  - https://docs.everyaction.com/reference/ballotreturnstatuses.md
  - https://docs.everyaction.com/reference/ballottypes-ballottypeid.md
  - https://docs.everyaction.com/reference/ballottypes.md
  - https://docs.everyaction.com/reference/bargainingunits-bargainingunitid.md
  - https://docs.everyaction.com/reference/bargainingunits.md
  - https://docs.everyaction.com/reference/bulkimportjobs-jobid.md
  - https://docs.everyaction.com/reference/bulkimportjobs-resources.md
  - https://docs.everyaction.com/reference/bulkimportjobs.md
  - https://docs.everyaction.com/reference/bulkimportmappingtypes-mappingtypename-fieldname-values.md
  - https://docs.everyaction.com/reference/bulkimportmappingtypes-mappingtypename.md
  - https://docs.everyaction.com/reference/bulkimportmappingtypes.md
  - https://docs.everyaction.com/reference/canvassfilereqeusts-canvassfilerequestid.md
  - https://docs.everyaction.com/reference/canvassfilerequests.md
  - https://docs.everyaction.com/reference/canvassresponses-contacttypes.md
  - https://docs.everyaction.com/reference/canvassresponses-inputtypes.md
  - https://docs.everyaction.com/reference/canvassresponses-resultcodes.md
  - https://docs.everyaction.com/reference/changedentityexportjobs-changetypes-resourcetype.md
  - https://docs.everyaction.com/reference/changedentityexportjobs-exportjobid.md
  - https://docs.everyaction.com/reference/changedentityexportjobs-fields-resourcetype.md
  - https://docs.everyaction.com/reference/changedentityexportjobs-resources.md
  - https://docs.everyaction.com/reference/changedentityexportjobs.md
  - https://docs.everyaction.com/reference/codes-batch.md
  - https://docs.everyaction.com/reference/codes-codeid.md
  - https://docs.everyaction.com/reference/codes-supportedentities.md
  - https://docs.everyaction.com/reference/codesextendedsourcecodes.md
  - https://docs.everyaction.com/reference/codetypes.md
  - https://docs.everyaction.com/reference/commitments-commitmentid.md
  - https://docs.everyaction.com/reference/commitments-recurringpayments.md
  - https://docs.everyaction.com/reference/commitments.md
  - https://docs.everyaction.com/reference/contributions-alternateidtype-alternateid.md
  - https://docs.everyaction.com/reference/contributions-attribution-types.md
  - https://docs.everyaction.com/reference/contributions-contributionid-adjustments.md
  - https://docs.everyaction.com/reference/contributions-contributionid-attributions-vanid.md
  - https://docs.everyaction.com/reference/contributions-contributionid.md
  - https://docs.everyaction.com/reference/contributions-payments.md
  - https://docs.everyaction.com/reference/contributionsrecentcontributions.md
  - https://docs.everyaction.com/reference/create-surveyquestion.md
  - https://docs.everyaction.com/reference/customfields-customfieldid.md
  - https://docs.everyaction.com/reference/customfields.md
  - https://docs.everyaction.com/reference/delete-codes-codeid.md
  - https://docs.everyaction.com/reference/delete-codes.md
  - https://docs.everyaction.com/reference/delete-contributions-contributionid-attributions-vanid.md
  - https://docs.everyaction.com/reference/delete-events-eventid.md
  - https://docs.everyaction.com/reference/delete-people-vanid-myactivistflags.md
  - https://docs.everyaction.com/reference/departments-departmentid.md
  - https://docs.everyaction.com/reference/designations-designationid.md
  - https://docs.everyaction.com/reference/disbursements-disbursementid.md
  - https://docs.everyaction.com/reference/disbursementsrecentdisbursements.md
  - https://docs.everyaction.com/reference/districtfields-districtfieldid.md
  - https://docs.everyaction.com/reference/districtfields.md
  - https://docs.everyaction.com/reference/earlyvotefields.md
  - https://docs.everyaction.com/reference/earlyvotefieldsearlyvotefieldid.md
  - https://docs.everyaction.com/reference/echoes.md
  - https://docs.everyaction.com/reference/email-message-emailid.md
  - https://docs.everyaction.com/reference/email-messages.md
  - https://docs.everyaction.com/reference/employers-employerid-bargainingunits-bargainingunitid-jobclassesjobclassid.md
  - https://docs.everyaction.com/reference/employers-employerid-bargainingunits-bargainingunitid.md
  - https://docs.everyaction.com/reference/employers-employerid-deparments.md
  - https://docs.everyaction.com/reference/employers-employerid-shifttypes-shifttypeid.md
  - https://docs.everyaction.com/reference/employers-employerid-worksites.md
  - https://docs.everyaction.com/reference/employers-employerid.md
  - https://docs.everyaction.com/reference/employersemployeridbargainingunitsbargainingunitiddelete.md
  - https://docs.everyaction.com/reference/employersemployeridbargainingunitsbargainingunitidjobclassesjobclassiddelete.md
  - https://docs.everyaction.com/reference/employersemployeridshifttypesshifttypeiddelete.md
  - https://docs.everyaction.com/reference/events-eventid-shifts.md
  - https://docs.everyaction.com/reference/events-eventid.md
  - https://docs.everyaction.com/reference/events-types-eventtypeid.md
  - https://docs.everyaction.com/reference/events-types.md
  - https://docs.everyaction.com/reference/exportjobs.md
  - https://docs.everyaction.com/reference/exportjobsexportjobid.md
  - https://docs.everyaction.com/reference/exportjobtypes.md
  - https://docs.everyaction.com/reference/fileloadingjobs.md
  - https://docs.everyaction.com/reference/fileloadingjobsjobid.md
  - https://docs.everyaction.com/reference/fileloadingjobsjobidstats.md
  - https://docs.everyaction.com/reference/financialbatches-1.md
  - https://docs.everyaction.com/reference/financialbatches.md
  - https://docs.everyaction.com/reference/financialbatchesfinancialbatchid.md
  - https://docs.everyaction.com/reference/find-by-phone.md
  - https://docs.everyaction.com/reference/folders-1.md
  - https://docs.everyaction.com/reference/foldersfolderid.md
  - https://docs.everyaction.com/reference/foldersfolderidmapregions.md
  - https://docs.everyaction.com/reference/foldersfolderidmapregionsmapregionid.md
  - https://docs.everyaction.com/reference/foldersfolderidmapregionsmapregionidrefresh.md
  - https://docs.everyaction.com/reference/foldersfolderidmapregionsrefresh.md
  - https://docs.everyaction.com/reference/get-campaign-by-id.md
  - https://docs.everyaction.com/reference/get-campaigns.md
  - https://docs.everyaction.com/reference/get-codes.md
  - https://docs.everyaction.com/reference/get-departments.md
  - https://docs.everyaction.com/reference/get-designations.md
  - https://docs.everyaction.com/reference/get-employers.md
  - https://docs.everyaction.com/reference/get-events.md
  - https://docs.everyaction.com/reference/get-people-personid-type-personid.md
  - https://docs.everyaction.com/reference/get-people-vanid.md
  - https://docs.everyaction.com/reference/get-people.md
  - https://docs.everyaction.com/reference/introspection.md
  - https://docs.everyaction.com/reference/jobclasses-1.md
  - https://docs.everyaction.com/reference/jobclasses.md
  - https://docs.everyaction.com/reference/jobclassesjobclassid.md
  - https://docs.everyaction.com/reference/locations-1.md
  - https://docs.everyaction.com/reference/locations-2.md
  - https://docs.everyaction.com/reference/locationsfindorcreate.md
  - https://docs.everyaction.com/reference/locationslocationid-1.md
  - https://docs.everyaction.com/reference/locationslocationid.md
  - https://docs.everyaction.com/reference/memberstatuses-1.md
  - https://docs.everyaction.com/reference/memberstatuses.md
  - https://docs.everyaction.com/reference/memberstatusesmemberstatusid.md
  - https://docs.everyaction.com/reference/minivanexports.md
  - https://docs.everyaction.com/reference/minivanexportsminivanexportid.md
  - https://docs.everyaction.com/reference/notescategories.md
  - https://docs.everyaction.com/reference/notescategoriesnotecategoryid.md
  - https://docs.everyaction.com/reference/notescategorytypes.md
  - https://docs.everyaction.com/reference/onlineactionsforms.md
  - https://docs.everyaction.com/reference/onlineactionsformsformtrackingid.md
  - https://docs.everyaction.com/reference/patch-codes-codeid.md
  - https://docs.everyaction.com/reference/patch-employers-employerid.md
  - https://docs.everyaction.com/reference/patch-events-eventid.md
  - https://docs.everyaction.com/reference/people-find.md
  - https://docs.everyaction.com/reference/people-findorcreate.md
  - https://docs.everyaction.com/reference/people-persoid-type-personid.md
  - https://docs.everyaction.com/reference/people-personidtype-personid-canvassresponses.md
  - https://docs.everyaction.com/reference/people-personidtype-personid-codes-codeid.md
  - https://docs.everyaction.com/reference/people-personidtype-personid-codes.md
  - https://docs.everyaction.com/reference/people-personidtype-personid-disclosurefieldvalues.md
  - https://docs.everyaction.com/reference/people-personidtype-personid-notes.md
  - https://docs.everyaction.com/reference/people-vanid-activistcodes.md
  - https://docs.everyaction.com/reference/people-vanid-canvassresponses.md
  - https://docs.everyaction.com/reference/people-vanid-codes-codeid.md
  - https://docs.everyaction.com/reference/people-vanid-codes.md
  - https://docs.everyaction.com/reference/people-vanid-delete.md
  - https://docs.everyaction.com/reference/people-vanid-disclosurefieldvalues.md
  - https://docs.everyaction.com/reference/people-vanid-membership.md
  - https://docs.everyaction.com/reference/people-vanid-mergeinto.md
  - https://docs.everyaction.com/reference/people-vanid-myactivistflags.md
  - https://docs.everyaction.com/reference/people-vanid-names.md
  - https://docs.everyaction.com/reference/people-vanid-notes-noteid.md
  - https://docs.everyaction.com/reference/people-vanid-notes.md
  - https://docs.everyaction.com/reference/people-vanid-relationships.md
  - https://docs.everyaction.com/reference/people-vanid.md
  - https://docs.everyaction.com/reference/peoplepersonidcanvassresponsesreferenceid.md
  - https://docs.everyaction.com/reference/peoplevanidcanvassresponsescanvassresponseid-copy.md
  - https://docs.everyaction.com/reference/peoplevanidcanvassresponsescanvassresponseid.md
  - https://docs.everyaction.com/reference/peoplevanidcanvassresponsesreferenceid.md
  - https://docs.everyaction.com/reference/post-bargainingunits.md
  - https://docs.everyaction.com/reference/post-codes.md
  - https://docs.everyaction.com/reference/post-contributions.md
  - https://docs.everyaction.com/reference/post-disbursements.md
  - https://docs.everyaction.com/reference/post-employers.md
  - https://docs.everyaction.com/reference/post-events.md
  - https://docs.everyaction.com/reference/post-people-vanid-notes.md
  - https://docs.everyaction.com/reference/printedlists.md
  - https://docs.everyaction.com/reference/printedlistsprintedlistnumber.md
  - https://docs.everyaction.com/reference/pronouns.md
  - https://docs.everyaction.com/reference/put-codes-codeid.md
  - https://docs.everyaction.com/reference/put-codes.md
  - https://docs.everyaction.com/reference/put-events-eventid.md
  - https://docs.everyaction.com/reference/relationships-1.md
  - https://docs.everyaction.com/reference/reportedethnicities.md
  - https://docs.everyaction.com/reference/reportedgenders.md
  - https://docs.everyaction.com/reference/reportedlanguagepreferences.md
  - https://docs.everyaction.com/reference/reportedraces.md
  - https://docs.everyaction.com/reference/reportedsexualorientations.md
  - https://docs.everyaction.com/reference/savedlists.md
  - https://docs.everyaction.com/reference/savedlistssavedlistid.md
  - https://docs.everyaction.com/reference/scheduletypes-1.md
  - https://docs.everyaction.com/reference/scheduletypes.md
  - https://docs.everyaction.com/reference/scheduletypesscheduletypeid.md
  - https://docs.everyaction.com/reference/scores-1.md
  - https://docs.everyaction.com/reference/scoresscoreid.md
  - https://docs.everyaction.com/reference/scoresscoreidcommitteeaccess.md
  - https://docs.everyaction.com/reference/scoreupdates.md
  - https://docs.everyaction.com/reference/scoreupdatesscoreupdateid-1.md
  - https://docs.everyaction.com/reference/scoreupdatesscoreupdateid.md
  - https://docs.everyaction.com/reference/shifttypes-1.md
  - https://docs.everyaction.com/reference/shifttypes.md
  - https://docs.everyaction.com/reference/shifttypesshifttypeid.md
  - https://docs.everyaction.com/reference/signups-1.md
  - https://docs.everyaction.com/reference/signups-2.md
  - https://docs.everyaction.com/reference/signupseventsignupid-1.md
  - https://docs.everyaction.com/reference/signupseventsignupid-2.md
  - https://docs.everyaction.com/reference/signupseventsignupid.md
  - https://docs.everyaction.com/reference/signupsstatuses.md
  - https://docs.everyaction.com/reference/smssync.md
  - https://docs.everyaction.com/reference/stories-1.md
  - https://docs.everyaction.com/reference/storiesstoryid.md
  - https://docs.everyaction.com/reference/supportergroups-1.md
  - https://docs.everyaction.com/reference/supportergroups.md
  - https://docs.everyaction.com/reference/supportergroupssupportergroupid-1.md
  - https://docs.everyaction.com/reference/supportergroupssupportergroupid.md
  - https://docs.everyaction.com/reference/supportergroupssupportergroupidpeoplevanid-1.md
  - https://docs.everyaction.com/reference/supportergroupssupportergroupidpeoplevanid.md
  - https://docs.everyaction.com/reference/surveyquestions.md
  - https://docs.everyaction.com/reference/surveyquestionssurveyquestionid-1.md
  - https://docs.everyaction.com/reference/surveyquestionssurveyquestionid.md
  - https://docs.everyaction.com/reference/targetexportjobs.md
  - https://docs.everyaction.com/reference/targetexportjobsexportjobid.md
  - https://docs.everyaction.com/reference/targets-1.md
  - https://docs.everyaction.com/reference/targetstargetid.md
  - https://docs.everyaction.com/reference/usersuseriddistrictfieldvalues-1.md
  - https://docs.everyaction.com/reference/usersuseriddistrictfieldvalues-2.md
  - https://docs.everyaction.com/reference/usersuseriddistrictfieldvalues.md
  - https://docs.everyaction.com/reference/voterregistrationbatches-1.md
  - https://docs.everyaction.com/reference/voterregistrationbatches.md
  - https://docs.everyaction.com/reference/voterregistrationbatchesbatchid.md
  - https://docs.everyaction.com/reference/voterregistrationbatchesbatchidpeople.md
  - https://docs.everyaction.com/reference/voterregistrationbatchesprogramtypes.md
  - https://docs.everyaction.com/reference/voterregistrationbatchesregistrationforms.md
  - https://docs.everyaction.com/reference/voterregistrationbatchesstatesstatesupportedfields.md
  - https://docs.everyaction.com/reference/worksites-1.md
  - https://docs.everyaction.com/reference/worksitesworksiteid.md
  - https://docs.everyaction.com/reference/worksitesworksiteiddelete.md
  - https://docs.everyaction.com/reference/worksitesworksiteidput.md
  - https://docs.everyaction.com/reference/worksitesworksiteidworkareas.md
  - https://docs.everyaction.com/reference/worksitesworksiteidworkareasput.md
  - https://docs.everyaction.com/reference/worksitesworksiteidworkareasworkareaiddelete.md
  merge:
    pages: 219
    deduped: 218
    conflicts_kept_first: 0