Banner: Web API: Get All Boards

Web API: Get All Boards

The 'Get All Boards' Web API enables developers to query and retrieve information on Workforce Development Boards or Youth Committees.

About this data

This Web API is used on www.CareerOneStop.org to find Workforce Development Boards. This API includes a request method that returns all Workforce Development Boards and Youth Committee records in a single API call. You can see the Workforce Development Board Finder here. Find out how a Workforce Development Board can help you by clicking here for more information on this tool and the associated data.

CareerOneStop Geocoding is provided through a license agreement with Microsoft. Your use of the data is subject to the Microsoft Bing Maps Terms of Service.

https://www.microsoft.com/en-us/maps/product

You may use the Geocodes locally in your applications. But, Geocodes cannot be stored, copied or shared. Please refer to the Microsoft Bing Terms of Use. 

Resource URL

https://api.careeronestop.org/v1/BoardsCouncilsFinder/{userId}

Try this Web API

Example Code

using System;

using System.Net.Http;

using System.Net.Http.Headers;

using System.Threading.Tasks;

namespace CareerOneStopAPISample

{

    class Program

    {

        static void Main(string[] args)

        {

            CreateRequest().Wait();

        }

        private static async Task CreateRequest()

        {

    

            var uri = new UriBuilder(Uri.UriSchemeHttps, "api.careeronestop.org")

            {

                Path = "/v1/BoardsCouncilsFinder/{userId}"

            };

            

            using (var http = new HttpClient())

            {

                http.DefaultRequestHeaders.Accept.Clear();

                http.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", "Your API Token");

                http.DefaultRequestHeaders.Accept.Add(new MediaTypeWithQualityHeaderValue("application/json"));

                var response = await http.GetAsync(uri.Uri).ConfigureAwait(false);

                if (response.IsSuccessStatusCode)

                {

                    var result = await response.Content.ReadAsStringAsync().ConfigureAwait(false);

                }

            }

        }

    }

}
import java.io.IOException;

import java.net.URI;

import java.net.URISyntaxException;

import org.apache.http.HttpEntity;

import org.apache.http.client.methods.CloseableHttpResponse;

import org.apache.http.client.methods.HttpGet;

import org.apache.http.client.utils.URIBuilder;

import org.apache.http.impl.client.CloseableHttpClient;

import org.apache.http.impl.client.HttpClients;

import org.apache.http.util.EntityUtils;

public class CareerOneStopAPISample {

    public static void main(String[] args) throws IOException, URISyntaxException {

    URI uri = new URIBuilder()

        .setScheme("https")

        .setHost("api.careeronestop.org")

        .setPath("/v1/BoardsCouncilsFinder/{userId}")

        .build();

    CloseableHttpResponse response = null;

    HttpGet httpGet = null;

    try {

        CloseableHttpClient httpClient = HttpClients.createDefault();

        httpGet = new HttpGet(uri);

        httpGet.setHeader("Content-Type","application/json");

        httpGet.setHeader("Authorization", "Bearer Your API Token");

        response = httpClient.execute(httpGet);

        HttpEntity entity = response.getEntity();

        System.out.println(EntityUtils.toString(entity));

    } finally {

        if(httpGet != null) httpGet.releaseConnection();

        if(response != null) response.close();

    }

   }

}

Request Parameters

Refer to the following table for a list of the required and optional request parameters. All parameter names and values are case sensitive. Important: You must provide all required parameters. Submitting an empty request does not return all possible results; an empty request returns an error.

Parameter Name Value Required? Description
API Token
String
Yes
The unique API Token provided during the CareerOneStop Web API registration process
userId
String
Yes The unique UserID provided during the CareerOneStop Web API registration process

Response Structure

{

  "BOARDS": [

    {

      "ID": "AL",

      "BOARD": "Alabama Workforce Investment Board",

      "LEVEL": "STATE",

      "TYPE": "WDB",

      "ADDR1": "PO Box 304103",

      "ADDR2": "",

      "CITY": "Montgomery",

      "STATE": "AL",

      "ZIP": "36130",

      "GEOCODE": {

        "LAT": "32.3666",

        "LON": "-86.30"

      },

      "COUNTIES": "",

      "CITIES": "",

      "TOWNS": "",

      "COMPANY": "Alabama Workforce Investment Board",

      "URL": "",

      "VALID": "3",

      "DIST": -1,

      "CONTACTS": [

        {

          "GID": "9",

          "GNAME": "WDB - State Executive Directors",

          "CCOMPANY": "Alabama Workforce Investment Board",

          "CNAME": "Steve Walkley",

          "CTITLE": "Division Chief, Workforce Development Division",

          "CEMAIL": "steve.walkley@commerce.alabama.gov",

          "CPHONE": "334-242-5300",

          "CFAX": "334-242-5855",

          "CADDR1": "PO Box 304103",

          "CADDR2": "",

          "CCITY": "Montgomery",

          "CSTATE": "AL",

          "CZIP": "36130",

          "CURL": ""

        },

        {

          "GID": "16",

          "GNAME": "WDB - State Chairs",

          "CCOMPANY": "Manufacture Alabama",

          "CNAME": "George Clark",

          "CTITLE": "President",

          "CEMAIL": "george@manufacturealabama.org",

          "CPHONE": "334-386-3000",

          "CFAX": "334-386-3001",

          "CADDR1": "401 Adams Avenue",

          "CADDR2": "Suite 710",

          "CCITY": "Montgomery",

          "CSTATE": "AL",

          "CZIP": "36104",

          "CURL": ""

        },

        {

        "GID": "113",

        "GNAME": "Youth Councils - State",

        "CCOMPANY": "Alabama Workforce Investment Area Youth Council",

        "CNAME": "Dr. Steve Turkoski",

        "CTITLE": "Project Manager",

        "CNAME": "Dr. Steve Turkoski",

        "CEMAIL": "sturkoski@dothan.com",

        "CPHONE": "334-792-5138",

        "CFAX": "",

        "CADDR1": "ADECA, Suite 390, P.O. Box 5690",

        "CADDR2": "",

        "CCITY": "Montgomery",

        "CSTATE": "AL",

        "CZIP": "36103-5690",

        "CURL": ""

        }

      ]

    }

  }
//Remaining instances of Boards have been snipped, leaving just a sample
<WorkforceBoardsCouncils

xmlns:i="http://www.w3.org/2001/XMLSchema-instance"

xmlns="http://schemas.datacontract.org/2004/07/XPAND.CareerOneStop.WebApi.ViewModels">

<BOARDS>

<WorkforceBoardCouncil>

<ADDR1>PO Box 304103</ADDR1>

<ADDR2/>

<BOARD>Alabama Workforce Investment Board</BOARD>

<CITIES/>

<CITY>Montgomery</CITY>

<COMPANY>Alabama Workforce Investment Board</COMPANY>

<CONTACTS>

<BoardContact>

<CADDR1>PO Box 304103</CADDR1>

<CADDR2/>

<CCITY>Montgomery</CCITY>

<CCOMPANY>Alabama Workforce Investment Board</CCOMPANY>

<CEMAIL>steve.walkley@commerce.alabama.gov</CEMAIL>

<CFAX>334-242-5855</CFAX>

<CNAME>Steve Walkley</CNAME>

<CPHONE>334-242-5300</CPHONE>

<CSTATE>AL</CSTATE>

<CTITLE>Division Chief, Workforce Development Division</CTITLE>

</CURL>

<CZIP>36130</CZIP>

<GID>9</GID>

<GNAME>WDB - State Executive Directors</GNAME>

</BoardContact>

<BoardContact>

<CADDR1>401 Adams Avenue</CADDR1>

<CADDR2>Suite 710</CADDR2>

<CCITY>Montgomery</CCITY>

<CCOMPANY>Manufacture Alabama</CCOMPANY>

<CEMAIL>george@manufacturealabama.org</CEMAIL>

<CFAX>334-386-300</CFAX>

<CNAME>George Clark</CNAME>

<CPHONE>334-386-3000</CPHONE>

<CSTATE>AL</CSTATE>

<CTITLE>President</CTITLE>

<CURL/>

<CZIP>36104</CZIP>

<GID>16</GID>

<GNAME>WDB - State Chairs</GNAME>

</BoardContact>

<BoardContact>

<CADDR1>ADECA, Suite 390, P.O. Box 5690</CADDR1>

<CADDR2/>

<CCITY>Montgomery</CCITY>

<CCOMPANY>Alabama Workforce Investment Area Youth Council</CCOMPANY>

<CEMAIL>sturkoski@dothan.com</CEMAIL>

<CFAX/>

<CNAME>Dr. Steve Turkoski</CNAME>

<CPHONE>334-792-5138</CPHONE>

<CSTATE>AL</CSTATE>

<CTITLE>Project Manager</CTITLE>

<CURL/>

<CZIP>36103-5690</CZIP>

<GID>113</GID>

<GNAME>Youth Councils - State</GNAME>

</BoardContact>

</CONTACTS>

</COUNTIES>

<DIST>-1</DIST>

</GEOCODE>

<LAT>32.3666</LAT>

<LON>-86.30</LON>

</GEOCODE>

<ID>39</ID>

<LEVEL>LOCAL</LEVEL>

<STATE>AZ</STATE>

<TOWNS/>

<TYPE>WDB</TYPE>

<URL>https://www.santacruzonestop.org/about/meet-the-board/</URL>

<VALID>1</VALID>

<ZIP>85621</ZIP>

</WorkforceBoardCouncil>
//Remaining instances of Boards have been snipped, leaving just a sample

Response Parameters

Name
Description
Type
Parent
ID
Unique ID for this board
String
Empty Cell
BOARD
Workforce Development Board Name/Department
String
Empty Cell
LEVEL
Level, STATE or LOCAL
String
Empty Cell
TYPE
Type, WDB (Workforce Development Board) or YC (Youth Council)
String
Empty Cell
ADDR1
Address 1
String
Empty Cell
ADDR2
Address 2
String
Empty Cell
CITY
City
String
Empty Cell
STATE
State Abbreviation
String
Empty Cell
ZIP
Zip
String
Empty Cell
GEOCODE
Location of the main office
Object
Empty Cell
LAT
Latitude
Number
GEOCODE
LON
Longitude
Number
GEOCODE
COUNTIES
Counties served by the board
String
Empty Cell
CITIES
Cities served by the board
String
Empty Cell
TOWNS
Towns served by the board
String
Empty Cell
COMPANY
related company name, if applicable
String
Empty Cell
URL
Website Url
String
Empty Cell
VALID
Valid, a flag for location accuracy and display of map and directions
1 for both map and directions
2 for map only
3 for no display of map and directions
String
Empty Cell
DIST
Distance from a searched location, with -1 as uncalculated
Number
Empty Cell
CONTACTS
Contacts
Object
Empty Cell
GID
Group ID
State WDB, 9 and 16
Local WDB, 10 and 1
State YC, 113
Local YC, 112
String
CONTACTS
GNAME
Group Name
String
CONTACTS
CCOMPANY
Contact Company
String
CONTACTS
CNAME
Contact Name
String
CONTACTS
CTITLE
Contact Title
String
CONTACTS
CEMAIL
Contact Email
String
CONTACTS
CPHONE
Contact Phone
String
CONTACTS
CFAX
Contact Fax
String
CONTACTS
CADDR1
Contact Address 1
String
CONTACTS
CADDR2
Contact Address 2
String
CONTACTS
CCITY
Contact City
String
CONTACTS
CSTATE
Contact State
String
CONTACTS
CZIP
Contact Zip Code
String
CONTACTS
CURL
Contact Website Url
String
CONTACTS
INFO
Information about this search and the results
Object
Empty Cell
COUNT
Count
String
INFO
STATE
State
String
INFO
STATENAME
State Name
String
INFO
MESSAGE
Message, if applicable
String
INFO
SEARCHINFO
Information about this search
Object
INFO
LOCATION
Location
String
SEARCHINFO
RADIUS
Radius
String
SEARCHINFO
ID
ID when searched by id
String
SEARCHINFO
RESULTTYPE
State, City, or ZIP results based on input
String
SEARCHINFO
TYPEID
Type ID, 0 for WDB, 1 for YC
String
SEARCHINFO
TYPEDESC
Type Description
String
SEARCHINFO
LEVELID
Level ID, 0 for state and local, 1 for state, 2 for local
String
SEARCHINFO
LEVELDESC
Level Description
String
SEARCHINFO
TEXT
Type Text
String
SEARCHINFO
LWDBCOUNT
Number of Local WDBs in a State
String
SEARCHINFO
SYCREF
State YC reference, if applicable
String
SEARCHINFO
LYCREF
Local YC reference, if applicable
String
SEARCHINFO
FILTERS
Count of each type of board in these results
Object
INFO
Item
Item
String
FILTERS
Count
Count
String
FILTERS
Value
Value
String
FILTERS

Errors

Error/Status Code Description
 200
OK / Success. The request went through successfully and there is a response body.
 400
Bad Request (Request was invalid or missing parameters)
 401    
Unauthorized. This error occurs specifically when authentication is required and has failed or has not yet been provided correctly. (ex: Invalid API Token)
 404
This error will be shown in two scenarios 1) Not found - (An error occurred) and 2) Not found - (No data available)
 500
Internal Server Error. This error will occur when there is something critically wrong in the API call.