# NationBuilder Lists API

**Canonical:** https://apis.io/apis/nationbuilder/nationbuilder-lists-api/  
**Provider:** NationBuilder — https://apis.io/providers/nationbuilder/  
**Base URL:** https://{nation-slug}.nationbuilder.com/api/v2  
**Documentation:** https://support.nationbuilder.com/en/collections/10408291-api

NationBuilder Lists API is one of 41 APIs that [NationBuilder](https://apis.io/providers/nationbuilder/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include List. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, and a getting-started guide.

Lists are collections of signups. Often created from filters they are useful for grouping signups together by common attributes. They can be used to perform batch updates on signups or as a list of recipients for a mailing blast. Read more on what you can do with lists [here](https://support.nationbuilder.com/en/articles/2305947-create-a-list).

## Machine-readable artifacts (5)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/nationbuilder/refs/heads/main/openapi/nationbuilder-lists-api-openapi.yml
- **InteractiveDocs** — https://nationbuilder.com/api/v2/reference
- **Documentation** — https://support.nationbuilder.com/en/collections/10408291-api
- **APIReference** — https://support.nationbuilder.com/en/articles/10857983-interactive-api-documentation-endpoint-explorer
- **GettingStarted** — https://support.nationbuilder.com/en/articles/9869274-nationbuilder-api-quickstart-guide

## Other NationBuilder APIs (12)

- [NationBuilder Async Processes API](https://apis.io/apis/nationbuilder/nationbuilder-async-processes-api/)
- [NationBuilder Automation Enrollments API](https://apis.io/apis/nationbuilder/nationbuilder-automation-enrollments-api/)
- [NationBuilder Automations API](https://apis.io/apis/nationbuilder/nationbuilder-automations-api/)
- [NationBuilder Ballots API](https://apis.io/apis/nationbuilder/nationbuilder-ballots-api/)
- [NationBuilder Broadcasters API](https://apis.io/apis/nationbuilder/nationbuilder-broadcasters-api/)
- [NationBuilder Contacts API](https://apis.io/apis/nationbuilder/nationbuilder-contacts-api/)
- [NationBuilder Custom Fields API](https://apis.io/apis/nationbuilder/nationbuilder-custom-fields-api/)
- [NationBuilder Donation Tracking Codes API](https://apis.io/apis/nationbuilder/nationbuilder-donation-tracking-codes-api/)
- [NationBuilder Donations API](https://apis.io/apis/nationbuilder/nationbuilder-donations-api/)
- [NationBuilder Elections API](https://apis.io/apis/nationbuilder/nationbuilder-elections-api/)
- [NationBuilder Event Rsvps API](https://apis.io/apis/nationbuilder/nationbuilder-event-rsvps-api/)
- [NationBuilder Event Ticket Levels API](https://apis.io/apis/nationbuilder/nationbuilder-event-ticket-levels-api/)

## Tags

List

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/nationbuilder/nationbuilder-lists-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/nationbuilder/.