NationBuilder Elections API

Elections are available on nations with voter features enabled. See more information about election functionality [here](https://support.nationbuilder.com/en/articles/2362732-set-up-your-election)

Documentation Provider Profile APIs.io OpenAPI GitHub

NationBuilder Elections API is one of 41 APIs that NationBuilder publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Elections. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, and a getting-started guide.

This API exposes 5 operations across 2 paths, and defines 22 schemas. It is described by OpenAPI 3.1.2, at version 2.0.

Requests are made against a single base URL, https://{subdomain}.nationbuilder.com.

5 operations 2 paths 22 schemas 1 DELETE2 GET1 PATCH1 POST

Metadata

The identity and technical contract details declared by the specification.

Specification

OpenAPI 3.1.2

API Version

2.0

Base URL

https://{nation-slug}.nationbuilder.com/api/v2

Authentication

HTTP Bearer

Resource Areas

Authentication & Security 1

NationBuilder Elections API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (JWT) (BearerAuth). By default, every request must be authenticated.

BearerAuth — Authentication using a bearer token (JWT) issued via OAuth.

Paths & Operations 5

Across 2 paths, the API surfaces 5 operations — 1 DELETE, 2 GET, 1 PATCH, 1 POST. Each is listed below with its method, path, parameters, and response codes.

Elections 5

Elections are available on nations with voter features enabled. See more information about election functionality [here](https://support.nationbuilder.com/en/articles/2362732-set-…

POST

/api/v2/elections

Create a election

createElection 2 params body → 201400401422429

GET

/api/v2/elections

List all elections in a nation

listElections 4 params → 200401429

GET

/api/v2/elections/{id}

Show election with provided ID

showElection 3 params → 200401404429

PATCH

/api/v2/elections/{id}

Update an existing election

updateElection 3 params body → 200400401404422429

DELETE

/api/v2/elections/{id}

Delete election with provided ID

deleteElection 3 params → 200401404429

Schemas 22

The contract defines 22 schemas that model the data the API accepts and returns. The most detailed are election_read_write_attributes (7 properties), validation_error (6 properties), pagination_links (5 properties), index_document (4 properties). Each schema is shown below with its type and property counts.

error_response

object

The error body returned for 4xx and 5xx responses, with a machine-readable code and a human-readable message. Some errors include additional detail members alo…

2 properties 2 required

show_document

object

The JSON:API top-level document shape for responses returning a single resource under the data member.

3 properties 1 required

election_index_response

A paginated JSON:API response containing a list of elections.

election_update_request

The request body for updating an existing election.

resource_identifier

object

A JSON:API resource identifier object, the type/id pair that uniquely identifies a single resource.

2 properties 2 required

election_create_request

The request body for creating a new election.

election_show_response

A JSON:API response containing a single election.

pagination_links

object

JSON:API pagination links for the pages of a collection. A key whose page is unavailable, or that the server's pagination strategy does not provide, is omitted…

5 properties

election_read_write_attributes

object

The attributes of a election that can be both read and written.

7 properties

index_document

object

The JSON:API top-level document shape for paginated collection responses, with resource objects under data and pagination links.

4 properties 1 required

validation_error

object

A single JSON:API error object describing a validation failure, locating the invalid field via source.pointer and carrying the model-level attribute, message,…

6 properties

election_field_values

string

Readable election attribute names selectable with sparse fieldsets (fields[elections]).

delete_document

object

The successful destroy response, an empty JSON:API meta-only document returned with status 200 (rather than JSON:API's commonly used 204 No Content).

1 property 1 required

election_response_data

The JSON:API resource object representing a election.

rate_limited_response

object

The body returned by the rate limiter when an access token exceeds its request quota.

1 property 1 required

validation_error_document

object

The JSON:API errors document returned with status 422 when model validations fail on create or update. Unlike this API's flat 4xx error bodies, validation fail…

1 property 1 required

update_request_document

object

The JSON:API top-level document shape for update requests, whose data member identifies the resource by type and id and carries the changed attributes.

1 property 1 required

create_request_document

object

The JSON:API top-level document shape for create requests, whose data member carries the new resource's type and attributes.

1 property 1 required

election_read_only_attributes

object

The read-only attributes of a election.

3 properties

resource

A generic JSON:API resource object. Resources sideloaded in a document's included member use this shape; their attributes are those of the resource type named…

included

array

Sideloaded resources requested via the include query parameter. Each entry is a full resource object whose shape is documented under its own resource type.

election_sideload_values

string

Relationship names that can be sideloaded with the include query parameter on election endpoints.

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

Other APIs NationBuilder publishes across the network.

NationBuilder Async Processes API

AE Profile APIs.io

NationBuilder Automation Enrollments API

AE Profile APIs.io

NationBuilder Automations API

AE Profile APIs.io

NationBuilder Ballots API

AE Profile APIs.io

NationBuilder Broadcasters API

AE Profile APIs.io

NationBuilder Contacts API

AE Profile APIs.io

NationBuilder Custom Fields API

AE Profile APIs.io

NationBuilder Donation Tracking Codes API

AE Profile APIs.io

NationBuilder Donations API

AE Profile APIs.io

NationBuilder Event Rsvps API

AE Profile APIs.io

NationBuilder Event Ticket Levels API

AE Profile APIs.io

NationBuilder Events API

AE Profile APIs.io

#Elections

← Back to N APIs

Discovery

Learnings

Guidance

Toolbox

Alignment

API Evangelist LLC

NationBuilder Elections API

Metadata

Authentication & Security 1

Paths & Operations 5

Schemas 22

Specification

Source

API Details

Provider

Explore more

Discovery

Learnings

Guidance

Toolbox

Alignment

API Evangelist LLC

NationBuilder Elections API

Metadata

Authentication & Security 1

Paths & Operations 5

Schemas 22

Specification

Source

More from NationBuilder 12

API Details

Provider

Explore more