API and downloads

Every table on this site can be downloaded as CSV or JSON, and the same data is available from a read-only API. No key or sign-up is needed.

Quick start

curl "https://unindex.org/api/v1/votes?body=unsc&country=RUS&position=abstain&from=2020&format=csv"

• Base path: /api/v1/. Index: /api/v1. OpenAPI description: /api/v1/openapi.json.
• Formats: add format=csv for a spreadsheet-ready file (UTF-8, comma-separated, one header row). The default is JSON: { "meta": {…}, "data": […] }. The meta block carries the licence, a citation, the counts and a next link when there is another page.
• Paging: endpoints marked “paged” take limit and offset.
• Errors: JSON { "error": { "status": 400, "message": "…" } } with the matching HTTP status.
• Fair use: about 10 requests per second per address (short bursts allowed), with a 5-minute cache. For the full history, download the source files directly (links below) instead of paging through the API.
• CSV safety: text cells that begin with =, +, - or @ are prefixed with an apostrophe so spreadsheets do not run them as formulas.
• CORS is open (Access-Control-Allow-Origin: *) so pages can call the API from a browser.

Licence and how to cite

Vote, veto and resolution data: © United Nations, non-commercial use with attribution (UN Digital Library terms). Ideal points: Bailey, Strezhnev & Voeten, CC0. Group membership: CIA World Factbook (public domain) and Wikidata (CC0). Computed fields (agreement, clusters, topics, calendar items): UNIndex, same non-commercial attribution terms as the source data.

You must attribute the sources, and the vote and veto data may be used for non-commercial purposes only. If you need to use the UN data commercially, ask the United Nations Dag Hammarskjöld Library for permission; this site cannot grant it.

Suggested citation

UNIndex (2026). United Nations voting data explorer. https://unindex.org. Underlying data: United Nations Dag Hammarskjöld Library, Security Council Voting Data (v7, Oct 2026) and General Assembly Voting Data (v6, Oct 2026); UN Peace & Security Data Hub, Vetoes since 1946. Accessed 2026-10-31.

BibTeX

@misc{unindex,
  title  = {UNIndex: United Nations voting data explorer},
  author = {{UNIndex}},
  year   = {2026},
  url    = {https://unindex.org},
  note   = {Data: UN Dag Hammarskj{\"o}ld Library, Security Council and General Assembly Voting Data; UN Peace \& Security Data Hub. Accessed 2026-10-31}
}

When you use a specific figure

Say which view or endpoint, the parameters and the access date, for example: “Agreement between France and the United Kingdom in the Security Council, 1946–2026 (UNIndex, /api/v1/agreement?c=FRA,GBR, accessed 2026-10-31)”. Computed values (agreement, clusters, topics, calendar items) are UNIndex's own and their definitions are in the methodology; please cite that page when you rely on them. Ideal points are the authors' work: also cite Bailey, Strezhnev & Voeten (2017), Journal of Conflict Resolution 61(2): 430–456.

Source files

For bulk use, the original datasets are published by their owners:

• Security Council Voting Data (UN Dag Hammarskjöld Library)
• General Assembly Voting Data (UN Dag Hammarskjöld Library)
• Security Council Data – Vetoes Since 1946 (UN Peace & Security Data Hub)
• UN General Assembly Voting Data and Ideal Points (Voeten et al., Harvard Dataverse, CC0)

Endpoints