Path journeys are the relationship between signups and paths. Further information available [here](https://support.nationbuilder.com/en/articles/3055899-create-paths#create-a-path).
NationBuilder Path Journeys API is one of 41 APIs that NationBuilder publishes on the APIs.io network, described by a machine-readable OpenAPI specification.
Tagged areas include Path Journeys. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, and a getting-started guide.
This API exposes
8 operations
across 6 paths,
and defines 21 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.
8 operations6 paths21 schemas2 GET5 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
1
Authentication & Security 1
NationBuilder Path Journeys 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 8
Across 6 paths, the API surfaces 8 operations — 2 GET, 5 PATCH, 1 POST. Each is listed below with its method, path, parameters, and response codes.
Path Journeys 8
Path journeys are the relationship between signups and paths. Further information available [here](https://support.nationbuilder.com/en/articles/3055899-create-pathscreate-a-path).
POST
/api/v2/path_journeys
Create a path journey
createPathJourney2 paramsbody→ 201400401422429
GET
/api/v2/path_journeys
List all path journeys in a nation
listPathJourneys4 params→ 200401429
GET
/api/v2/path_journeys/{id}
Show path journey with provided ID
showPathJourney3 params→ 200401404429
PATCH
/api/v2/path_journeys/{id}
Update an existing path journey
updatePathJourney3 paramsbody→ 200400401404422429
PATCH
/api/v2/path_journeys/{id}/abandon
Abandon path journey with provided ID
abandonPathJourney4 params→ 200400401404429
PATCH
/api/v2/path_journeys/{id}/complete
Complete path journey with provided ID
completePathJourney4 params→ 200400401404429
PATCH
/api/v2/path_journeys/{id}/reactivate
Reactivate path journey with provided ID
reactivatePathJourney3 params→ 200400401404429
PATCH
/api/v2/path_journeys/{id}/void
Void path journey with provided ID
voidPathJourney3 params→ 200400401404429
Schemas 21
The contract defines 21 schemas that model the data the API accepts and returns. The most detailed are path_journey_read_write_attributes (9 properties), validation_error (6 properties), path_journey_read_only_attributes (6 properties), pagination_links (5 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 properties2 required
show_document
object
The JSON:API top-level document shape for responses returning a single resource under the data member.
3 properties1 required
path_journey_field_values
string
Readable pathjourney attribute names selectable with sparse fieldsets (fields[pathjourneys]).
path_journey_create_request
The request body for creating a new path journey.
path_journey_read_only_attributes
object
The read-only attributes of a pathjourney.
6 properties
resource_identifier
object
A JSON:API resource identifier object, the type/id pair that uniquely identifies a single resource.
2 properties2 required
path_journey_sideload_values
string
Relationship names that can be sideloaded with the include query parameter on pathjourney endpoints.
path_journey_read_write_attributes
object
The attributes of a pathjourney that can be both read and written.
9 properties
path_journey_index_response
A paginated JSON:API response containing a list of path journeys.
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
path_journey_update_request
The request body for updating an existing path journey.
index_document
object
The JSON:API top-level document shape for paginated collection responses, with resource objects under data and pagination links.
4 properties1 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
path_journey_show_response
A JSON:API response containing a single path journey.
path_journey_response_data
The JSON:API resource object representing a path journey.
rate_limited_response
object
The body returned by the rate limiter when an access token exceeds its request quota.
1 property1 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 property1 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 property1 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 property1 required
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.
Specification
The full machine-readable OpenAPI contract behind this narrative.
