CINXE.COM
Country/State List : Events API : vTools Events
<!DOCTYPE html> <html lang="en"> <head><script src='https://s3-us-west-2.amazonaws.com/ieeeshutpages/gdpr/settings.js'></script><link rel='stylesheet' type='text/css' href='https://cdnjs.cloudflare.com/ajax/libs/cookieconsent2/3.0.3/cookieconsent.min.css' /><script src='https://cdnjs.cloudflare.com/ajax/libs/cookieconsent2/3.0.3/cookieconsent.min.js'></script><script>window.addEventListener('load', function(){ window.cookieconsent.initialise(json)});</script> <!-- v ieee cookie banner v --> <script src="https://cmp.osano.com/AzyzptTmRlqVd2LRf/eeabc00e-3d69-467a-b823-c8166c73d2b0/osano.js"></script> <link rel="stylesheet" href="https://cookie-consent.ieee.org/ieee-cookie-banner.css" type="text/css"/> <!-- ^ ieee cookie banner ^ --> <meta http-equiv="X-UA-Compatible" content="IE=edge"> <meta name="csrf-param" content="authenticity_token" /> <meta name="csrf-token" content="wSn7WcsA0oQGmvZuvcUmKj0IohF1j1ZOv158QZ0OowoWBJMyFDMA3tSC/3HAFpVF6QhIiDmHcfnn6GScBwg74g==" /> <meta charset="utf-8"/> <meta name="author" content="IEEE.vTools" /> <meta name="description" content="IEEE vTools, providing tools to the volunteers and staff who support our members." /> <meta name="viewport" content="width=device-width, initial-scale=1.0" /> <title>Country/State List : Events API : vTools Events</title> <link rel="shortcut icon" type="image/png" href="/assets/vtools_ui_img/vtools/favicon-0463513673a2b9c9cde118c4ad2f33ff77c24c63dc714cbfdcbe5c592ce4bf20.ico" /> <!-- jQuery Files --> <script src="/assets/jquery/vtools_jquery-3a475a9d51006b3897cffc389240925809930e261e3a59215542a249167aaef0.js"></script> <link rel="stylesheet" media="screen" href="/assets/raleway/raleway-872068a515e2d610037a73e91b2f2203f54a5b4c2d626f23efb7bb5122109486.css" /> <link rel="stylesheet" media="screen" href="/assets/vtools/color_themes/dark_red-dcfe135c5fac7ed4c5aab06417d1333c203689ef39f04eaaa9fe0c214f5ca902.css" title="dark_red" /> <link rel="stylesheet" media="screen" href="/assets/vtools-ecf2b9df6727d9205be4ea5700edad6dbd2ad954e1363df7ac966d5777e5888a.css" /> <!-- Royal Preloader --> <script src="/assets/raleway/preloader-fbb1a4a60322f016caf997fd2d8782fc51e334a71d9e5fd002ae9f6f0b9b0a4e.js"></script> <script type="text/javascript"> vTools = {}; vTools.AuthenticatedWhenPageLoaded = false; </script> <script src="/assets/vtools_ui-e8d47e97c384483f3e76bdc5e9c74cc0f43c9523b67c26fdbd3a755a5822fba4.js"></script> <link rel="stylesheet" media="screen" href="/assets/api_documentation-f5cda1cd67dc9ed9b15e17048096c1e6c78787535e25e8047fe43995e053c697.css" /> <!-- Google tag (gtag.js) --> <script async src="https://www.googletagmanager.com/gtag/js?id=G-FJ4RJXQJW2"></script> <script> window.dataLayer = window.dataLayer || []; function gtag(){dataLayer.push(arguments);} gtag('js', new Date()); gtag('config', 'G-FJ4RJXQJW2'); </script> <script type="text/javascript"> (function() { var op = XMLHttpRequest.prototype.open; XMLHttpRequest.prototype.open = function() { var resp = op.apply(this, arguments); var url = arguments && arguments[1] ? "" + arguments[1] : ""; url = url.toLowerCase(); if (url.includes("ieee.org") || url.includes("localhost") || url.includes("127.0.0.1") || !url.startsWith("http")) { this.setRequestHeader('X-CSRF-Token', $('meta[name=csrf-token]').attr('content')); } return resp; }; }()); </script> </head> <body class=" scrollreveal royal_preloader"> <!-- Preloader and Settings --> <div id="royal_preloader"></div> <div id="bg-boxed"> <div class="boxed"> <!-- <style> #javascript_notice { border: 2px solid orange; background-color: white; border: 2px solid orange; color: #8b2222; } </style> <noscript><div id="javascript_notice"> It appears that you have JavaScript disabled. JavaScript is <b>highly</b> recommended for vTools applications, and is required for some functionality. </div></noscript> --> <header> <!-- Begin Top Bar --> <div class="top-bar"> <div class="container"> <div class="row"> <div class="col-xs-8 col-sm-8 hidden-xs hidden-sm"> <span class="glyphicon glyphicon-home"></span> <a class="basic" href="http://www.ieee.org/" style="margin-left:3px;">IEEE.org</a> <span class="hidden-sm"> | <a class="basic" href="http://ieeexplore.ieee.org">IEEE <em>Xplore</em> Digital Library</a> | <a class="basic" href="http://standards.ieee.org/">IEEE Standards</a> | <a class="basic" href="http://spectrum.ieee.org/">IEEE Spectrum</a> | <a class="basic" href="http://www.ieee.org/sitemap.html">More Sites</a> </span> </div> <div class="col-xs-6 col-sm-6 visible-xs visible-sm"> <a href="http://ieee.org" target="_blank"> <img alt="Visit IEEE.org" style="margin-top:7px;" src="/assets/vtools_ui_img/ieee/ieee-logo-small-47b86b7f8d2e1873f3f8e5104d1c883d44f61e202b0f2dfc8af69840bcfc74f4.jpg" /> </a> </div> <!-- Address and Phone <div class="col-sm-7 hidden-xs"> <span class="ion-android-system-home home-icon"></span>Bright Passage, Fond du Lac, 63138 USA<span class="ion-ios7-telephone phone-icon"></span>1702983921 </div>--> <!-- Social Buttons <div class="col-sm-5 text-right"> <ul class="topbar-list list-inline"> <li> <a class="btn btn-social-icon btn-rw btn-primary btn-xs"> <i class="fa fa-twitter"></i> </a> <a class="btn btn-social-icon btn-rw btn-primary btn-xs"> <i class="fa fa-instagram"></i> </a> <a class="btn btn-social-icon btn-rw btn-primary btn-xs"> <i class="fa fa-facebook"></i> </a> </li><li><a data-toggle="modal" data-target="#login">Login</a></li><li><a href="pages-forms-register-login.html">Register</a></li> </ul> </div>--> <div class="col-xs-6 col-sm-6 col-md-4 col-lg-4 text-right"> <ul class="topbar-list list-inline" style="border: 0 !important;"> <!--<li> <a class="btn btn-social-icon btn-rw btn-primary btn-xs"> <i class="fa fa-twitter"></i> </a> <a class="btn btn-social-icon btn-rw btn-primary btn-xs"> <i class="fa fa-instagram"></i> </a> <a class="btn btn-social-icon btn-rw btn-primary btn-xs"> <i class="fa fa-facebook"></i> </a> </li>--> <!--<li><a data-toggle="modal" data-target="#login">Login</a></li><li><a href="pages-forms-register-login.html">Register</a></li>--> <li id="_vtools_signin_status" style="font-size:1.3em; border: 0 !important;"> <a href="/tego_/authentication/sign_in?_landing=/api/doc/countries"><!-- vToolsUI #100 <span class="fa fa-key fa-lg ieee_primary_blue" style="margin-right:8px; vertical-align:middle;"></span>-->Sign In</a> </li> </ul> </div> </div><!--/row --> </div><!--/container header --> </div><!--/top bar --> <!-- End Top Bar --> <!-- Begin Identity and Navigation --> <div class="navbar-wrapper"> <div class="navbar navbar-main" id="fixed-navbar"> <div class="container"> <div class="row"> <div class="col-sm-12 column-header"> <div class="pull-right hidden-xs hidden-sm"> <a href="http://ieee.org" target="_blank"> <img alt="Visit IEEE.org" style="margin-top:7px;" src="/assets/vtools_ui_img/ieee/ieee-logo-small-47b86b7f8d2e1873f3f8e5104d1c883d44f61e202b0f2dfc8af69840bcfc74f4.jpg" /> </a> </div> <div style="white-space: nowrap;"> <a href="http://sites.ieee.org/vtools/" class="navbar-brand" style="padding-top: 15px !important;" target="_blank"> <span style="font-size: 40px; text-transform: none; font-weight: normal;"> <span style="color:black;" class="hidden-xs hidden-sm header_title">IEEE</span> <span class="ieee_primary_blue header_title">vTools</span> </span> </a> <a href="/"> <span class="content-box ieee_dark_lime_bg header_title" style="color:#FFFFFF; display: inline-block; margin:15px 0 0 8px; padding:2px 5px 2px 5px; font-weight:bold;"> EVENTS </span> </a> </div><!-- /navbar header --> </div> </div> <nav id="_vtools_app_nav" class="navbar navbar-default"> <div class="container-fluid"> <ul class="nav navbar-nav navbar-right visible-lg" style="float:right; margin-top: 10px; margin-right:0;"> <li class="dropdown dropdown-main" style="font-size:0.8em; white-space:normal; width:220px; text-align:right;"> </li> </ul><!-- /navbar right --> <!-- Brand and toggle get grouped for better mobile display --> <div class="navbar-header"> <button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target="#_vtools_app_nav_collapse" aria-expanded="false"> <span class="sr-only">Toggle navigation</span> <span class="icon-bar"></span> <span class="icon-bar"></span> <span class="icon-bar"></span> </button> <a class="navbar-brand visible-xs visible-sm" href="#">QuickNav</a> </div> <!-- Collect the nav links, forms, and other content for toggling --> <div class="collapse navbar-collapse" id="_vtools_app_nav_collapse"> <ul class="nav navbar-nav"> <li class="dropdown dropdown-main" style=""> <a href="http://sites.ieee.org/vtools/" target="_blank" class="dropdown-toggle" data-hover="dropdown" data-toggle="dropdown">vTools<span class="fa fa-angle-down dropdown-arrow"></span></a> <ul class="dropdown-menu dropdown-subhover dropdown-animation animated fadeIn"><!-- Control Animations by changing "fadeIn" to another property from animate.css, check animations page in features / ALSO dropdown-animation class controls the duration, ajust if need --> <li class=""><a href="http://sites.ieee.org/vtools" target="_blank" class="mn-menu-link">vTools Home</a></li> <li class=""><a href="http://sites.ieee.org/vtools/blog" target="_blank" class="mn-menu-link">vTools Blog</a></li> <li class="theme-border-bottom-heavy"> <a href="http://sites.ieee.org/vtools/training" target="_blank" class="mn-menu-link">vTools Tutorials</a> </li> <li><a href="https://engage.vtools.ieee.org" target="_blank" class="mn-menu-link">Engage</a></li> <li><a href="https://enotice.vtools.ieee.org" target="_blank" class="mn-menu-link">eNotice</a></li> <li><a href="https://events.vtools.ieee.org" target="_blank" class="mn-menu-link">Events</a></li> <li><a href="https://nominations.vtools.ieee.org" target="_blank" class="mn-menu-link">Nominations</a></li> <li><a href="https://officers.vtools.ieee.org" target="_blank" class="mn-menu-link">Officer Reporting</a></li> <li><a href="https://sbr.vtools.ieee.org" target="_blank" class="mn-menu-link">Student Branch Reporting</a></li> <li><a href="https://surveys.vtools.ieee.org" target="_blank" class="mn-menu-link">Surveys</a></li> <li><a href="https://voting.vtools.ieee.org" target="_blank" class="mn-menu-link">Voting</a></li> <li><a href="https://webinabox.vtools.ieee.org" target="_blank" class="mn-menu-link">WebInABox</a></li> <li><a href="https://xtreme.vtools.ieee.org" target="_blank" class="mn-menu-link">Xtreme</a></li> </ul> </li> <li><a href="/events/search"><span>Search</span></a></li><li><a href="/my_events"><span>My Events</span></a></li><li><a href="/tego_/events/administration"><span>Manage Events</span></a></li><li><a href="/api/doc"><span class="panel-primary vtools-main-nav-item color-main">API</span></a></li><li><a href="/about"><span>About</span></a></li><li><a href="/contact"><span>Contact</span></a></li> </ul> </div><!-- /.navbar-collapse --> </div><!-- /.container-fluid --> </nav> </div><!-- /container header --> </div><!-- /navbar --> </div><!-- /navbar wrapper --> <!-- End Navigation --> <!-- --> <div class="header _header_breadbrumb_bar ieee_dark_red_fade1_bg" style="width:100%; height:20px;"> </div> <div class="wedge20_topright_ieee_dark_red_fade1" style="float:right;"></div> </header><!-- /header --> <!-- End Header --> <!--<section class=""> <div class="">--> <section class="content-40mg main-content"> <div class="container main-content-body"> <div id="_vtools_session_expired_message" style="display:none;" class="alert alert-warning alert-warning-rw" role="alert"> It appears that your session has timed out. Please <a href="/tego_/authentication/sign_in?_landing=/api/doc/countries">click here to sign in</a> again.<br />NOTE that if there is any unsaved work on this page, it will be lost. </div> <!--<div class="alert alert-warning alert-warning-rw" role="alert">Due to previously scheduled system maintenance on Saturday 10 August, vTools applications may be unavailable from 4am - 2pm Eastern time.</div>--> <!-- Begin Sidebar --> <aside class="col-lg-2 col-md-2 col-sm-3" style="padding-left:0; padding-right:0;"> <nav role="navigation"> <div class="content-box content-box-bordered no-margin" style="padding:10px;"> <span class="ion-flask fa-5x ieee_dark_red"></span><!-- bordered-icon-sm --> <p class="no-margin" style="padding-top:10px; padding-bottom:10px; font-size:.9em;"><!-- text-left --> Welcome to<br />the Events API. <!-- <br /> api/doc/documentation --> </p> </div> <ul class="sidebar-nav list-group no-margin" id="sidebar-nav"> <li class="list-group-item no-padding "> <a title="API Home" class="tooltip-active" data-toggle="tooltip" data-placement="right" href="/api/doc">API Home</a> </li> <li class="list-group-item "> <a title="Produce a list of categories and subcategories" class="tooltip-active" data-toggle="tooltip" data-placement="right" href="/api/doc/categories">Category/Subcategory List</a> </li> <li class="list-group-item active"> <a title="Produce a list of countries and states" class="tooltip-active" data-toggle="tooltip" data-placement="right" href="/api/doc/countries">Country/State List</a> </li> <li class="list-group-item "> <a title="Produce a list of events" class="tooltip-active" data-toggle="tooltip" data-placement="right" href="/api/doc/events">Events List</a> </li> <li class="list-group-item "> <a title="View Events List examples" class="tooltip-active" data-toggle="tooltip" data-placement="right" href="/api/doc/events_examples">Events List Examples</a> </li> <li class="list-group-item "> <a title="View legacy feeds (deprecated)" class="tooltip-active" data-toggle="tooltip" data-placement="right" href="/main/feeds">Legacy Feeds</a> </li> </ul> </nav> </aside> <!-- End Sidebar --> <section class="col-lg-10 col-md-01 col-sm-9" style="padding-right:0;"> <h2 class="ieee_dark_red"> <!--<span class="ion-social-rss fa-lg ieee_dark_red" style="padding-top:5px; padding-right:10px;"></span>--> Country/State List </h2> <p>The Country/State List API call can be used to produce a list of countries and states that are supported within Events.</p> <div class="panel panel-default"> <div class="panel-heading"> <h3 class="panel-title">Parameters</h3> </div> <div class="panel-body"> None. <!-- <table class="table table-bordered"> <thead> <tr> <th class="name">Name</th> <th class="required">Required?</th> <th class="value">Value</th> <th class="description">Description</th> </tr> </thead> <tbody> <tr class=""> <td class="name"> <a title="Information on 'span' is available on the API Home page" class="tooltip-active" data-toggle="tooltip" data-placement="right" href="/api/doc">span</a> </td> <td>Optional</td> <td><a title="Information on 'span' is available on the API Home page" class="tooltip-active" data-toggle="tooltip" data-placement="right" href="/api/doc">See docs home page</a></td> <td>The 'span' parameter works against the event 'start-time'</td> </tr> </tbody> </table> --> </div> </div> <div class="panel panel-default"> <div class="panel-heading"> <h3 class="panel-title">Example</h3> </div> <div class="panel-body"> <a title="Country/State List API call" class="tooltip-active" data-toggle="tooltip" data-placement="top" target="_blank" href="/RST/events/api/public/v4/countries/list">/RST/events/api/public/v4/countries/list</a> <p style="margin-top:15px;"> Notes: <ul class="list-arrow-2"> <li>Each country includes a list of its 'states'.</li> </ul> </p> </div> <div class="panel-footer"><pre style="code">/RST/events/api/public/v4/countries/list { "data": [ { "type": "countries", "id": "1", "attributes": { "id": 1, "name": "Afghanistan", "abbreviation": "AF", "states": [ { "id": 1, "name": "Badakhshan", "abbreviation": "BAD", "country_id": 1 }, { "id": 2, "name": "Badghis", "abbreviation": "BAH", "country_id": 1 }, { "id": 3, "name": "Baghlan", "abbreviation": "BAG", "country_id": 1 }, ... ] } } ] } </pre> </div> </div> </section> <br style="clear:both;" /> </div> </section> <!-- Begin Footer --> <footer class="footer-light"> <div class="container"> <div class="row"> <div class="col-sm-12" style="text-align:center;"><a href="https://app.ieee.org/?utm_source=dhtml_footer&utm_medium=hp&utm_campaign=ieee-app2020%20" target="_blank" style="margin-left: auto;margin-right: auto;display: block;width: 728px;padding: 8px;"><img src="https://www.ieee.org//content/dam/ieee-org/ieee/web/org/the-ieee-app-footer-tap-connect-network-share-ad-728x90.jpg" class="img-responsive" alt="IEEE App" title="IEEE App"></a></div> <div class="col-sm-12" style="text-align:left;"> <a href="#" style="float:right; margin-left:20px; margin-right:-20px;" class="scroll-top"><div class="footer-scrolltop-holder"><span class="ion-ios7-arrow-up footer-scrolltop"></span></div></a> <a class="basic" href="/">Home</a> | <a class="basic" href="https://site.ieee.org/vtools/feature-requests-and-bug-reports/">Contact & Support</a> | <a class="basic" href="http://www.ieee.org/accessibility_statement.html">Accessibility</a> | <a class="basic" href="http://www.ieee.org/p9-26.html">Nondiscrimination Policy</a> | <a class="basic" href="https://secure.ethicspoint.com/domain/media/en/gui/20410/index.html">IEEE Ethics Reporting</a> | <a class="basic" href="https://www.ieee.org/security-privacy.html">Privacy & Opting Out of Cookies</a> | <a class="basic" href="http://www.ieee.org/about/feedback_ieee_site.html">Feedback</a> <br /> version 6.18.6 <br /> © Copyright 2013-2024 IEEE – All rights reserved. Use of this Web site signifies your agreement to the <a class="basic" href="http://www.ieee.org/site_terms_conditions.html">IEEE Terms and Conditions</a>.<br /> A not-for-profit organization, IEEE is the world's largest technical professional organization dedicated to advancing technology for the benefit of humanity.<br /> </div> </div><!-- /row --> <br /><br /><br /> </div><!-- /container --> </footer><!-- /footer --> <!-- End Footer --> </div><!-- /boxed --> </div><!-- /bg boxed--> <script src="/assets/raleway/raleway-ab1019808585dce6e6a61409e394fd6bcaa5fdcd0056eee92283a4f2fedb8d11.js"></script> </body> </html>