# Pull API: UserType

<p class="callout info"><span data-colorid="h5go72n8lk">API access is a paid feature and must be granted by OPSCOM. Email your Account Executive to negotiate access. </span></p>

The OPSCOM Controller provides a simple JSON based API to integrate with. Clients use this API to obtain a list of the current profile user types in their system.

Make sure you set the HTTP Content-Type header to be application/json.

## <span data-colorid="vqvj19pk0c">Making API Requests</span>

### Raw Request:

<div class="sectionMacroRow" id="bkmrk-post-%2Fapi%2Foc_toma%2Fv1"><div class="columnMacro conf-macro output-block" data-hasbody="true" data-macro-id="d82683ac-7548-4419-a8f9-4dd2f5a2e52e" data-macro-name="column"><div class="code panel pdl conf-macro output-block" data-hasbody="true" data-macro-id="e0f00b72-fb34-406b-8191-44548c0c6a03" data-macro-name="code"><div class="codeContent panelContent pdl"><div><div class="syntaxhighlighter sh-midnight nogutter  text" id="bkmrk-post-%2Fapi%2Foc_toma%2Fv1-1"><table border="0" cellpadding="0" cellspacing="0"><tbody><tr><td class="code"><div class="container" title="Hint: double-click to select code"><div class="line number1 index0 alt2">`POST /api/OC_TOMA/v1/profiles/types/list HTTP/1.1`</div><div class="line number2 index1 alt1">`Host: controller.operationscommander.io`</div><div class="line number3 index2 alt2">`Accept: application/json`</div><div class="line number4 index3 alt1">`Content-Type: application/json`</div><div class="line number5 index4 alt2">`Cache-Control: no-cache`</div><div class="line number6 index5 alt1"> </div><div class="line number7 index6 alt2">`{`</div><div class="line number8 index7 alt1">`    ``"apiToken": "YOUR-API-TOKEN",`</div><div class="line number9 index8 alt2">`}`</div></div></td></tr></tbody></table>

</div></div></div></div></div><div class="columnMacro conf-macro output-block" data-hasbody="true" data-macro-id="96733877-01a7-4c30-9e62-30b67dd186b6" data-macro-name="column">  
</div></div>### JavaScript Request:

<div class="sectionMacroRow" id="bkmrk-var%C2%A0request-%3D%C2%A0new%C2%A0xm"><div class="columnMacro conf-macro output-block" data-hasbody="true" data-macro-id="96733877-01a7-4c30-9e62-30b67dd186b6" data-macro-name="column"><div class="code panel pdl conf-macro output-block" data-hasbody="true" data-macro-id="27c0aef3-a976-47d7-8822-ce06e320ad25" data-macro-name="code"><div class="codeContent panelContent pdl"><div><div class="syntaxhighlighter sh-midnight nogutter  js"><table border="0" cellpadding="0" cellspacing="0"><tbody><tr><td class="code"><div class="container" title="Hint: double-click to select code"><div class="line number1 index0 alt2">`var` `request = ``new` `XMLHttpRequest();`</div><div class="line number2 index1 alt1"> </div><div class="line number3 index2 alt2">`request.open(``'POST'``, ``'<a href="https://controller.operationscommander.io/api/OC_TOMA/v1/profiles/types/list'">https://controller.operationscommander.io/api/OC_TOMA/v1/profiles/types/list'</a>``);`</div><div class="line number4 index3 alt1"> </div><div class="line number5 index4 alt2">`request.setRequestHeader(``'Content-Type'``, ``'application/json'``);`</div><div class="line number6 index5 alt1">`request.setRequestHeader(``'Accept'``, ``'application/json'``);`</div><div class="line number7 index6 alt2"> </div><div class="line number8 index7 alt1">`request.onreadystatechange = ``function` `() {`</div><div class="line number9 index8 alt2">`  ``if` `(``this``.readyState === 4) {`</div><div class="line number10 index9 alt1">`    ``console.log(``'Status:'``, ``this``.status);`</div><div class="line number11 index10 alt2">`    ``console.log(``'Headers:'``, ``this``.getAllResponseHeaders());`</div><div class="line number12 index11 alt1">`    ``console.log(``'Body:'``, ``this``.responseText);`</div><div class="line number13 index12 alt2">`  ``}`</div><div class="line number14 index13 alt1">`};`</div><div class="line number15 index14 alt2"> </div><div class="line number16 index15 alt1"> </div><div class="line number17 index16 alt2">`var` `body = {`</div><div class="line number18 index17 alt1">`    ``"apiToken"``: ``"YOUR-API-TOKEN"`</div><div class="line number19 index18 alt2">`}`</div><div class="line number20 index19 alt1">`request.send(JSON.stringify(body));`</div></div></td></tr></tbody></table>

</div></div></div></div></div></div>## <span data-colorid="kh2a8nukoa">Request Object Attributes</span>

<div class="table-wrap" id="bkmrk-attribute-type-limit"><table class="wrapped confluenceTable tablesorter tablesorter-default" role="grid"><colgroup><col></col><col></col><col></col><col></col><col></col></colgroup><thead><tr class="tablesorter-headerRow" role="row"><th aria-disabled="false" aria-label="Attribute: No sort applied, activate to apply an ascending sort" aria-sort="none" class="confluenceTh tablesorter-header sortableHeader tablesorter-headerUnSorted" data-column="0" role="columnheader" scope="col" tabindex="0">Attribute</th><th aria-disabled="false" aria-label="Type: No sort applied, activate to apply an ascending sort" aria-sort="none" class="confluenceTh tablesorter-header sortableHeader tablesorter-headerUnSorted" data-column="1" role="columnheader" scope="col" tabindex="0">Type</th><th aria-disabled="false" aria-label="Limits: No sort applied, activate to apply an ascending sort" aria-sort="none" class="confluenceTh tablesorter-header sortableHeader tablesorter-headerUnSorted" data-column="2" role="columnheader" scope="col" tabindex="0">Limits</th><th aria-disabled="false" aria-label="Possible Names: No sort applied, activate to apply an ascending sort" aria-sort="none" class="confluenceTh tablesorter-header sortableHeader tablesorter-headerUnSorted" data-column="3" role="columnheader" scope="col" tabindex="0">Possible Names</th><th aria-disabled="false" aria-label="Description: No sort applied, activate to apply an ascending sort" aria-sort="none" class="confluenceTh tablesorter-header sortableHeader tablesorter-headerUnSorted" colspan="1" data-column="4" role="columnheader" scope="col" tabindex="0">Description</th></tr></thead><tbody aria-live="polite" aria-relevant="all"><tr role="row"><td class="confluenceTd" colspan="1">apiToken</td><td class="confluenceTd" colspan="1">String</td><td class="confluenceTd" colspan="1">50-character alphanumeric including dashes.

</td><td class="confluenceTd" colspan="1">apiToken</td><td class="confluenceTd" colspan="1">**(Required)** Your supplied API Token.</td></tr></tbody></table>

</div>## Successful Response

The response will be a json object.

Content-Type: application/json

<div class="code panel pdl conf-macro output-block" data-hasbody="true" data-macro-id="db38aafe-8712-40c9-8a94-4303ba5151c0" data-macro-name="code" id="bkmrk-%7B-%C2%A0%C2%A0%C2%A0%C2%A0%22status%22%3A%C2%A0%22suc"><div class="codeContent panelContent pdl"><div><div class="syntaxhighlighter sh-midnight nogutter  js" id="bkmrk-%7B-%C2%A0%C2%A0%C2%A0%C2%A0%22status%22%3A%C2%A0%22suc-1"><table border="0" cellpadding="0" cellspacing="0"><tbody><tr><td class="code"><div class="container" title="Hint: double-click to select code"><div class="line number1 index0 alt2">`{`</div><div class="line number2 index1 alt1">`    ``"status"``: ``"success"``,`</div><div class="line number3 index2 alt2">`    ``"user_types"``: [`</div><div class="line number4 index3 alt1">`        ``{`</div><div class="line number5 index4 alt2">`            ``"id"``: ``"1"``,`</div><div class="line number6 index5 alt1">`            ``"type_name"``: ``"Full Time Student"``,`</div><div class="line number7 index6 alt2">`            ``"ext_info"``: ``"Student"`</div><div class="line number8 index7 alt1">`        ``},`</div><div class="line number9 index8 alt2">`        ``{`</div><div class="line number10 index9 alt1">`            ``"id"``: ``"6"``,`</div><div class="line number11 index10 alt2">`            ``"type_name"``: ``"Demo"``,`</div><div class="line number12 index11 alt1">`            ``"ext_info"``: ``"Public"`</div><div class="line number13 index12 alt2">`        ``},`</div><div class="line number14 index13 alt1">`        ``{`</div><div class="line number15 index14 alt2">`            ``"id"``: ``"7"``,`</div><div class="line number16 index15 alt1">`            ``"type_name"``: ``"Full Time Staff"``,`</div><div class="line number17 index16 alt2">`            ``"ext_info"``: ``"Staff"`</div><div class="line number18 index17 alt1">`        ``},`</div><div class="line number19 index18 alt2">`        ``{`</div><div class="line number20 index19 alt1">`            ``"id"``: ``"8"``,`</div><div class="line number21 index20 alt2">`            ``"type_name"``: ``"Part Time Staff"``,`</div><div class="line number22 index21 alt1">`            ``"ext_info"``: ``"Staff"`</div><div class="line number23 index22 alt2">`        ``},`</div><div class="line number24 index23 alt1">`        ``{`</div><div class="line number25 index24 alt2">`            ``"id"``: ``"9"``,`</div><div class="line number26 index25 alt1">`            ``"type_name"``: ``"Part Time Student"``,`</div><div class="line number27 index26 alt2">`            ``"ext_info"``: ``"Student"`</div><div class="line number28 index27 alt1">`        ``},`</div><div class="line number29 index28 alt2">`        ``{`</div><div class="line number30 index29 alt1">`            ``"id"``: ``"10"``,`</div><div class="line number31 index30 alt2">`            ``"type_name"``: ``"Exchange Student"``,`</div><div class="line number32 index31 alt1">`            ``"ext_info"``: ``"Student"`</div><div class="line number33 index32 alt2">`        ``},`</div><div class="line number34 index33 alt1">`        ``{`</div><div class="line number35 index34 alt2">`            ``"id"``: ``"11"``,`</div><div class="line number36 index35 alt1">`            ``"type_name"``: ``"Athletics Member"``,`</div><div class="line number37 index36 alt2">`            ``"ext_info"``: ``"Athletics"`</div><div class="line number38 index37 alt1">`        ``},`</div><div class="line number39 index38 alt2">`        ``{`</div><div class="line number40 index39 alt1">`            ``"id"``: ``"12"``,`</div><div class="line number41 index40 alt2">`            ``"type_name"``: ``"Complimentary"``,`</div><div class="line number42 index41 alt1">`            ``"ext_info"``: ``"Public"`</div><div class="line number43 index42 alt2">`        ``},`</div><div class="line number44 index43 alt1">`        ``{`</div><div class="line number45 index44 alt2">`            ``"id"``: ``"13"``,`</div><div class="line number46 index45 alt1">`            ``"type_name"``: ``"Daily Reserved"``,`</div><div class="line number47 index46 alt2">`            ``"ext_info"``: ``"Public"`</div><div class="line number48 index47 alt1">`        ``}`</div><div class="line number49 index48 alt2">`    ``]`</div><div class="line number50 index49 alt1">`}`</div></div></td></tr></tbody></table>

</div></div></div></div><div class="sectionMacroRow" id="bkmrk-"><div class="columnMacro conf-macro output-block" data-hasbody="true" data-macro-id="96733877-01a7-4c30-9e62-30b67dd186b6" data-macro-name="column"><div class="code panel pdl conf-macro output-block" data-hasbody="true" data-macro-id="27c0aef3-a976-47d7-8822-ce06e320ad25" data-macro-name="code"><div class="codeContent panelContent pdl"><div><div class="syntaxhighlighter sh-midnight nogutter  js" id="bkmrk--1"></div></div></div></div></div></div>