Bonterra (fka EveryAction) Locations API
The Locations API from Bonterra (fka EveryAction) — 3 operation(s) for locations.
The Locations API from Bonterra (fka EveryAction) — 3 operation(s) for locations.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/bonterra-fka-everyaction:bonterra-fka-everyaction-locations-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: everyaction-8 Locations API
version: '1.0'
servers:
- url: https://api.securevan.com/v4
security:
- sec0: []
tags:
- name: Locations
paths:
/locations:
get:
summary: /locations
description: Use this endpoint to find Locations available in the current context using a number of filter options.
operationId: locations-1
parameters:
- name: name
in: query
description: Filters to Locations with names that contain the given input
schema:
type: string
default: HQ
responses:
'200':
description: '200'
content:
application/json:
examples:
Result:
value: "{\n\"items\":[\n {\n \"locationId\":301\n \"name\":\"HQ\"\n \"displayName\":\"HQ, 660 K St NE Washington, DC 20002 \"\n \"address\":{...}\n \"id\":301\n \"notes\":NULL\n \"codes\":NULL\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:
- Locations
post:
summary: /locations
description: 'Use this endpoint to create a new Location.
Typically it’s more appropriate to find or create a Location because you may not know whether a very similar Location already exists (e.g., was created in the VAN UI).
If successful, the endpoint responds with HTTP Status Code `201 Created`. It also sets the **Location** header to the location of the Location.'
operationId: locations-2
requestBody:
content:
application/json:
schema:
type: object
properties:
name:
type: string
default: Campaign HQ
address:
type: object
properties:
addressLine1:
type: string
default: 48 Grove St
city:
type: string
default: Somerville
stateOrProvince:
type: string
default: MA
zipOrPostalCode:
type: string
default: '02144'
responses:
'201':
description: '201'
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
deprecated: false
tags:
- Locations
/locations/findOrCreate:
post:
summary: /locations/findOrCreate
description: 'Similar to the POST /people/findOrCreate endpoint, this endpoint searches for the given Location. If a Location is found, the existing Location is returned. If a Location is not found, a new Location is created.
This endpoint is useful when synchronizing from a system that does not uniquely identify locations.
This endpoint parses the address provided, and uses the following criteria to find existing locations in US contexts:
* If a `name` is provided and a ZIP5 can be determined (either provided or discovered based on `city` and `stateOrProvince`), and no Street Name can be parsed, a match will be attempted based on `name` and ZIP5
* Then, if a `name` is provided and a ZIP5 cannot be determined and no Street Name can be parsed, a match will be attempted based on `name`, `city`, and `stateOrProvince`
* Then, if a Street Name can be parsed and a ZIP5 can be determined (either provided or discovered based on `city` and `stateOrProvince`), a match will be attempted based on Street Number, Street Name, Apartment Number, and ZIP5
Non-US contexts match on exact name and parsed address.
If successful, the endpoint responds with HTTP Status Code `201 Created` (even if it matched and updated an existing Location). It also sets the **Location** header to the location of the Location.'
operationId: locationsfindorcreate
requestBody:
content:
application/json:
schema:
type: object
properties:
name:
type: string
default: Campaign HQ
address:
type: object
properties:
addressLine1:
type: string
default: 48 Grove St
city:
type: string
default: Somerville
stateOrProvince:
type: string
default: MA
zipOrPostalCode:
type: string
default: '02144'
responses:
'201':
description: '201'
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
deprecated: false
tags:
- Locations
/locations/{locationId}:
get:
summary: /locations/{locationId}
description: 'Retrieve a specific Location
*Description*
Use this endpoint to retrieve the details of a specific Location.'
operationId: locationslocationid
parameters:
- name: locationId
in: path
description: Required; Unique identifier of a Location to be retrieved
schema:
type: integer
format: int32
default: 301
required: true
responses:
'200':
description: '200'
content:
application/json:
examples:
Result:
value: "{\n \"locationId\":301\n \"name\":\"HQ\"\n \"displayName\":\"HQ, 660 K St NE Washington, DC 20002 \"\n \"address\":{\n \"addressLine1\":\"660 K St NE\"\n \"addressLine2\":NULL\n \"addressLine3\":NULL\n \"unitNo\":NULL\n \"city\":\"Washington\"\n \"stateOrProvince\":\"DC\"\n \"zipOrPostalCode\":\"20002\"\n \"geoLocation\":NULL\n \"countryCode\":\"US\"\n \"preview\":\"660 K St NE Washington, DC 20002 \"\n \"type\":NULL\n \"isPreferred\":NULL\n \"streetAddress\":NULL\n \"displayMode\":\"Standardized\"\n },\n \"id\":301\n \"notes\":NULL\n \"codes\":NULL\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:
- Locations
delete:
summary: /locations/{locationId}
description: Use this endpoint to delete an existing Location. Use with caution as this this action is irreversible. Events associated with the given Location will continue to function though the Signups associated with the now deleted Location will display “Invalid Location” in the VAN UI.
operationId: locationslocationid-1
parameters:
- name: locationId
in: path
description: Required; Unique identifier for an editable Location
schema:
type: integer
format: int32
required: true
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:
- Locations
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