CINXE.COM

<!DOCTYPE html><html lang="en"><head><script type="text/javascript" src="https://web-static.archive.org/_static/js/bundle-playback.js?v=7YQSqjSh" charset="utf-8"></script> <script type="text/javascript" src="https://web-static.archive.org/_static/js/wombat.js?v=txqj7nKC" charset="utf-8"></script> <script>window.RufflePlayer=window.RufflePlayer||{};window.RufflePlayer.config={"autoplay":"on","unmuteOverlay":"hidden"};</script> <script type="text/javascript" src="https://web-static.archive.org/_static/js/ruffle/ruffle.js"></script> <script type="text/javascript"> __wm.init("https://web.archive.org/web"); __wm.wombat("https://dev.bitly.com/api-reference/","20221001011007","https://web.archive.org/","web","https://web-static.archive.org/_static/", "1664586607"); </script> <link rel="stylesheet" type="text/css" href="https://web-static.archive.org/_static/css/banner-styles.css?v=p7PEIJWi" /> <link rel="stylesheet" type="text/css" href="https://web-static.archive.org/_static/css/iconochive.css?v=3PDvdIFv" />  <meta charset="utf-8"/><meta name="viewport" content="width=device-width"/><link rel="shortcut icon" href="https://web.archive.org/web/20221001011007im_/https://dl6fh5ptkejqa.cloudfront.net/0482a3c938673192a591f2845b9eb275.png" type="image/x-icon"/><title>Bitly API Reference</title><meta name="next-head-count" content="4"/><link rel="preload" href="/web/20221001011007/https://dev.bitly.com/_next/static/css/864e502d90faa99e.css" as="style"/><link rel="stylesheet" href="/web/20221001011007cs_/https://dev.bitly.com/_next/static/css/864e502d90faa99e.css" data-n-g=""/><link rel="preload" href="/web/20221001011007/https://dev.bitly.com/_next/static/css/823c388dd38944bc.css" as="style"/><link rel="stylesheet" href="/web/20221001011007cs_/https://dev.bitly.com/_next/static/css/823c388dd38944bc.css" data-n-p=""/><noscript data-n-css=""></noscript><script defer="" nomodule="" src="/web/20221001011007js_/https://dev.bitly.com/_next/static/chunks/polyfills-c67a75d1b6f99dc8.js"></script><script src="/web/20221001011007js_/https://dev.bitly.com/_next/static/chunks/webpack-9b312e20a4e32339.js" defer=""></script><script src="/web/20221001011007js_/https://dev.bitly.com/_next/static/chunks/framework-f5960d7d0dbb4e82.js" defer=""></script><script src="/web/20221001011007js_/https://dev.bitly.com/_next/static/chunks/main-46efc285e0f364ba.js" defer=""></script><script src="/web/20221001011007js_/https://dev.bitly.com/_next/static/chunks/pages/_app-7a045c60b3a601c7.js" defer=""></script><script src="/web/20221001011007js_/https://dev.bitly.com/_next/static/chunks/317-1fc7d99ee6c1cb15.js" defer=""></script><script src="/web/20221001011007js_/https://dev.bitly.com/_next/static/chunks/678-be054443c6232966.js" defer=""></script><script src="/web/20221001011007js_/https://dev.bitly.com/_next/static/chunks/pages/%5BapiReference%5D-ee06b109173061f1.js" defer=""></script><script src="/web/20221001011007js_/https://dev.bitly.com/_next/static/ff49a9a3c00bbaf4db70b9b5063ce1f4256d27f0/_buildManifest.js" defer=""></script><script src="/web/20221001011007js_/https://dev.bitly.com/_next/static/ff49a9a3c00bbaf4db70b9b5063ce1f4256d27f0/_ssgManifest.js" defer=""></script></head><body><div id="__next"><div class="Layout_layout__WuuTt"><div class="Layout_header__HIFcZ"><header class="Header_header__jiqMu"><div class="Header_headerContent__6viXb"><div class="Header_headerIcon__fYgGU"><svg xmlns="http://www.w3.org/2000/svg" viewbox="-1376 546.6 90 45" xml:space="preserve"><title>Bitly</title><path d="M-1329.1 577c-4.5 0-7-2.7-7-6 0-1.3.1-11.4.1-11.4-1.5 0-2.2-.8-2.2-1.7 0-1 .8-1.9 2-1.9v-4.7c0-1.6 1.2-2.9 2.8-2.9 1.6 0 2.8 1.3 2.8 2.9 0 1.2-.1 2.8-.1 4.7h2.9c1.5 0 2.2.8 2.2 1.9 0 1.1-.8 1.8-1.9 1.8h-3.2c-.1 3.2-.2 7.1-.2 10.1 0 1.1.8 2.4 2.6 2.4 4.3 0 5.5-4.3 5.5-12.4 0-1.1.9-1.9 1.9-1.9 1.1 0 1.9.8 1.9 1.9.1 10.7-2.5 17.2-10.1 17.2"></path><path d="M-1310.9 560.5s1.8-1.2 2.9-1.2c1.1 0 .9.2.9 1.3 0 11.6-2.1 16.5-9.6 16.5-3.3 0-6.3-2.4-6.3-5.4 0-1.2.2-3.5.2-4.6 0-11.2-.2-13.5-.2-16.8 0-1.6 1.3-3 2.9-3 1.6 0 2.8 1.3 2.8 2.9 0 3.3-.4 8-.5 20.4 0 1 .5 1.8 1.8 1.8 4.3-.2 4.9-5.1 5.1-11.9"></path><path d="M-1297.3 575s-1.6 2.1-5.6 2c-5.3-.1-7.7-4.3-8-8.6-.2-3.3-.1-5.1-.1-7.3 0-1.6 1.1-2.9 2.6-2.9 1.6 0 2.5 1.3 2.5 2.9 0 2.1-.1 3.5-.2 5.9 0 2.8.9 5.3 3.2 5.2 2.2 0 4.7-.9 4.7-5.7v-5.4c0-1.6 1.1-2.9 2.7-2.9s2.7 1.3 2.7 2.9c0 2.1-.2 3.8-.2 7.1 0 0-.1 6.6.1 8.1.7-.2 1.8-1 2.9-2.7.7-1 2-1.3 2.7-.8 1.1.6 1.1 1.9.6 2.8-1.1 2.3-2.4 3.8-5.9 5 0 4-.3 9.8-7.6 10.9-6.3.9-9.1-2.7-9.1-5.8 0-4.9 4.9-6.3 11.9-8.1l.1-2.6zm.6 6.4c-3.6.8-8 1.9-8 4.1 0 2.1 2.2 2.4 4 2.1 3.7-.8 4.1-3 4-6.2zM-1347.6 571.6c0-1.3-.2-12.2-.2-12.2 0-1.6 1-2.9 2.6-2.9s2.6 1.4 2.6 2.9c-.2 5.1-.3 8.4-.3 10.2 0 1 .6 2.6 2.2 2.6 3.8 0 4.6-3.5 4.6-12.1 0-1.1 1.1-1.9 2.2-1.9s1.9.8 1.9 1.9c0 13-2.3 16.9-9.6 16.9-2.8 0-6-1.9-6-5.4"></path><path d="M-1345.8 557.5c-1.1 0-1.1.2-1.8 1.3 0 4.8-1.2 10.7-6.6 12.9 3.8-8-.1-15.3-6.4-15.3-3 0-4.9 1.1-6.1 2.1 0-2.3.1-6.4.1-6.4 0-2.9-1-5.1-4.5-5.2-2 0-3.5.9-4.5 3-.3.8-.2 1.6.5 2 .6.3 1.5.1 1.9-.5.3-.4.5-.5.7-.4.4 0 .4.7.5 1.2 0 .3.3 5.1.2 17.7 0 3.5 2.7 7.5 9.3 7.5 13 0 18.6-4.8 18.6-17.7-.3-1.2-.9-2.2-1.9-2.2zm-16.9 14.9c-2.5 0-4.2-.7-4.3-2.9v-2.2c.2-3.1 2.4-5.4 4.6-5.8 2.7-.5 4.5.7 4.5 4.2-.1 2.4-.8 6.6-4.8 6.7zM-1345.1 548.4c1.6 0 2.9 1.3 2.9 2.9s-1.3 2.9-2.9 2.9c-1.6 0-2.9-1.3-2.9-2.9s1.3-2.9 2.9-2.9"></path></svg>Developer</div><div class="Header_desktopHeaderLinks__afkP5"><nav><a class="Header_link__GeEkF" href="/web/20221001011007/https://dev.bitly.com/">Documentation</a><a class="Header_link__GeEkF Header_activeLink__QO_Eu" href="/web/20221001011007/https://dev.bitly.com/api-reference/">API Reference</a></nav><div class="Header_ctaWrapper__rejBO"><a class="Button_button__45M_W" href="https://web.archive.org/web/20221001011007/https://bitly.com/pages/pricing" target="_blank" rel="noopener noreferrer">Start Now</a></div></div><div class="Header_mobileHamburger__i_8mq"><div class="Header_menuIcon__5w7RR"><svg height="32" style="enable-background:new 0 0 32 32" width="32" xml:space="preserve" xmlns="http://www.w3.org/2000/svg"><title>Navigation</title><path d="M4 10h24a2 2 0 0 0 0-4H4a2 2 0 0 0 0 4zm24 4H4a2 2 0 0 0 0 4h24a2 2 0 0 0 0-4zm0 8H4a2 2 0 0 0 0 4h24a2 2 0 0 0 0-4z"></path></svg></div></div></div></header></div><div class="Layout_body__KWn_X"><nav class="Layout_navigation__1M5jp Layout_navigationHide__DviHj"><div class="Header_mobileHeaderLinks__EmNZ6"><nav><a class="Header_link__GeEkF" href="/web/20221001011007/https://dev.bitly.com/">Documentation</a><a class="Header_link__GeEkF Header_activeLink__QO_Eu" href="/web/20221001011007/https://dev.bitly.com/api-reference/">API Reference</a></nav><div class="Header_ctaWrapper__rejBO"><a class="Button_button__45M_W" href="https://web.archive.org/web/20221001011007/https://bitly.com/pages/pricing" target="_blank" rel="noopener noreferrer">Start Now</a></div></div><div><div class="Collapsible_collapsible__Rx1_w"><div class="Collapsible_toggle__K8a50"><div>Bitlinks</div><div class="Collapsible_chevron__hYprk"><svg viewbox="0 0 8 14" xmlns="http://www.w3.org/2000/svg"><path d="M6.463 7 .987 1.66a.61.61 0 0 1 0-.878.648.648 0 0 1 .9 0L7.813 6.56a.61.61 0 0 1 0 .878l-5.926 5.78a.648.648 0 0 1-.9 0 .61.61 0 0 1 0-.879L6.463 7Z"></path></svg></div></div></div><div class="Collapsible_collapsible__Rx1_w"><div class="Collapsible_toggle__K8a50"><div>BSDs</div><div class="Collapsible_chevron__hYprk"><svg viewbox="0 0 8 14" xmlns="http://www.w3.org/2000/svg"><path d="M6.463 7 .987 1.66a.61.61 0 0 1 0-.878.648.648 0 0 1 .9 0L7.813 6.56a.61.61 0 0 1 0 .878l-5.926 5.78a.648.648 0 0 1-.9 0 .61.61 0 0 1 0-.879L6.463 7Z"></path></svg></div></div></div><div class="Collapsible_collapsible__Rx1_w"><div class="Collapsible_toggle__K8a50"><div>Campaigns</div><div class="Collapsible_chevron__hYprk"><svg viewbox="0 0 8 14" xmlns="http://www.w3.org/2000/svg"><path d="M6.463 7 .987 1.66a.61.61 0 0 1 0-.878.648.648 0 0 1 .9 0L7.813 6.56a.61.61 0 0 1 0 .878l-5.926 5.78a.648.648 0 0 1-.9 0 .61.61 0 0 1 0-.879L6.463 7Z"></path></svg></div></div></div><div class="Collapsible_collapsible__Rx1_w"><div class="Collapsible_toggle__K8a50"><div>Custom Bitlinks</div><div class="Collapsible_chevron__hYprk"><svg viewbox="0 0 8 14" xmlns="http://www.w3.org/2000/svg"><path d="M6.463 7 .987 1.66a.61.61 0 0 1 0-.878.648.648 0 0 1 .9 0L7.813 6.56a.61.61 0 0 1 0 .878l-5.926 5.78a.648.648 0 0 1-.9 0 .61.61 0 0 1 0-.879L6.463 7Z"></path></svg></div></div></div><div class="Collapsible_collapsible__Rx1_w"><div class="Collapsible_toggle__K8a50"><div>Groups</div><div class="Collapsible_chevron__hYprk"><svg viewbox="0 0 8 14" xmlns="http://www.w3.org/2000/svg"><path d="M6.463 7 .987 1.66a.61.61 0 0 1 0-.878.648.648 0 0 1 .9 0L7.813 6.56a.61.61 0 0 1 0 .878l-5.926 5.78a.648.648 0 0 1-.9 0 .61.61 0 0 1 0-.879L6.463 7Z"></path></svg></div></div></div><div class="Collapsible_collapsible__Rx1_w"><div class="Collapsible_toggle__K8a50"><div>Organizations</div><div class="Collapsible_chevron__hYprk"><svg viewbox="0 0 8 14" xmlns="http://www.w3.org/2000/svg"><path d="M6.463 7 .987 1.66a.61.61 0 0 1 0-.878.648.648 0 0 1 .9 0L7.813 6.56a.61.61 0 0 1 0 .878l-5.926 5.78a.648.648 0 0 1-.9 0 .61.61 0 0 1 0-.879L6.463 7Z"></path></svg></div></div></div><div class="Collapsible_collapsible__Rx1_w"><div class="Collapsible_toggle__K8a50"><div>User</div><div class="Collapsible_chevron__hYprk"><svg viewbox="0 0 8 14" xmlns="http://www.w3.org/2000/svg"><path d="M6.463 7 .987 1.66a.61.61 0 0 1 0-.878.648.648 0 0 1 .9 0L7.813 6.56a.61.61 0 0 1 0 .878l-5.926 5.78a.648.648 0 0 1-.9 0 .61.61 0 0 1 0-.879L6.463 7Z"></path></svg></div></div></div><div class="Collapsible_collapsible__Rx1_w"><div class="Collapsible_toggle__K8a50"><div>Webhooks</div><div class="Collapsible_chevron__hYprk"><svg viewbox="0 0 8 14" xmlns="http://www.w3.org/2000/svg"><path d="M6.463 7 .987 1.66a.61.61 0 0 1 0-.878.648.648 0 0 1 .9 0L7.813 6.56a.61.61 0 0 1 0 .878l-5.926 5.78a.648.648 0 0 1-.9 0 .61.61 0 0 1 0-.879L6.463 7Z"></path></svg></div></div></div></div></nav><main class="Layout_content__Dwd3J" style="scroll-behavior:smooth"><div><div class="ApiReference_title__aBj6t">Bitly API (4.0.0)</div><div class="ApiReference_subtitle__p_qv_">OpenAPI Specification: <a class="Button_button__45M_W" href="https://web.archive.org/web/20221001011007/https://dev.bitly.com/v4/v4.json" target="_blank" rel="noopener noreferrer">Download</a></div><div class="ApiReference_tagInfo__YVbgw"><h2 class="ApiReference_tagName__IJx2p">Bitlinks</h2><p class="ApiReference_tagDescription__8c1GM">Bitlinks are shortened links. They could begin with the bit.ly domain or your own custom branded short domain (BSD). </p></div><div class="MethodDetail_methodContainer__3EF7h" id="createBitlink"><div class="MethodDetail_method__fyEiw"><div><h3 class="MethodHeader_h3__seOfC">Shorten a Link</h3><h4 class="MethodHeader_description__3_p_p"><div class="MethodHeader_iconStyle__x5Ow4"><svg viewbox="0 0 18 6" xmlns="http://www.w3.org/2000/svg" class="IconRest_restIcon__3pju8 post"><title>Post</title><path d="M1.072 5.885V3.898c.026.006.069.011.129.017a3.88 3.88 0 0 0 .364.016h.125c.27 0 .533-.037.786-.11.253-.075.478-.193.677-.355.198-.162.357-.368.477-.618s.18-.551.18-.903c0-.401-.07-.727-.208-.977a1.592 1.592 0 0 0-.536-.585 1.971 1.971 0 0 0-.739-.28 4.854 4.854 0 0 0-.817-.07C1.249.033.987.045.724.07.46.095.219.13 0 .173v5.712h1.072Zm.461-2.934h-.098a2.344 2.344 0 0 1-.27-.017.818.818 0 0 1-.093-.016V1.047c.057-.011.133-.02.227-.03.093-.007.193-.012.297-.012.135 0 .268.014.399.042.13.027.246.077.348.148a.796.796 0 0 1 .246.284.954.954 0 0 1 .094.45c0 .214-.032.387-.098.519a.782.782 0 0 1-.262.309c-.11.074-.233.125-.371.152a2.141 2.141 0 0 1-.419.042ZM6.47 6c.694 0 1.212-.265 1.553-.795.342-.53.513-1.265.513-2.205 0-.44-.038-.843-.114-1.212a2.872 2.872 0 0 0-.36-.947 1.78 1.78 0 0 0-.637-.618C7.163.074 6.844 0 6.469 0c-.35 0-.653.069-.911.206a1.78 1.78 0 0 0-.645.59c-.172.255-.3.57-.384.943A5.804 5.804 0 0 0 4.404 3c0 .44.037.843.11 1.212.073.368.191.684.356.947.164.264.378.47.641.618.263.149.583.223.958.223Zm0-1.005c-.203 0-.366-.053-.489-.157a.989.989 0 0 1-.281-.425 2.57 2.57 0 0 1-.133-.63A8.129 8.129 0 0 1 5.53 3c0-.66.065-1.157.195-1.492.13-.335.378-.503.743-.503.209 0 .376.054.501.161a1 1 0 0 1 .286.433c.065.181.106.393.125.635.018.241.027.497.027.766 0 .34-.014.636-.043.886-.029.25-.08.457-.152.622a.826.826 0 0 1-.29.367.803.803 0 0 1-.454.12ZM10.991 6c.297 0 .574-.037.83-.111.255-.074.476-.187.664-.338.188-.151.334-.338.438-.56.104-.223.157-.483.157-.78 0-.307-.067-.563-.2-.766a1.814 1.814 0 0 0-.493-.507 3.3 3.3 0 0 0-.641-.342 11.165 11.165 0 0 1-.642-.28 2.185 2.185 0 0 1-.493-.313.562.562 0 0 1-.199-.445c0-.176.072-.316.215-.42.144-.105.34-.157.59-.157a2.757 2.757 0 0 1 .767.107.14.14 0 0 0 .047.008v.915h.86V.338a2.45 2.45 0 0 0-.735-.247C11.85.03 11.536 0 11.218 0c-.282 0-.537.041-.767.124-.23.082-.426.197-.59.346A1.557 1.557 0 0 0 9.476 1a1.66 1.66 0 0 0-.137.68c0 .324.067.588.2.792.133.203.297.372.493.506.195.135.409.246.641.334.232.088.446.176.642.264.195.088.36.19.492.305.133.115.2.266.2.453 0 .209-.081.375-.243.499-.161.123-.388.185-.68.185-.162 0-.314-.018-.458-.053a2.256 2.256 0 0 1-.395-.136l-.047-.017v-.816h-.86V5.53c.067.039.156.085.266.14.11.055.236.107.379.157.143.05.3.09.47.124.169.033.353.049.55.049Zm6.29-.115v-.907h-.885V1.022h.744v.997H18V.115h-4.287V2.02h.86v-.997h.752v3.956h-.892v.907h2.847Z"></path></svg></div> /v4/shorten</h4><p class="MethodHeader_description__3_p_p">Converts a long url to a Bitlink. You may see errors returned from this endpoint - "BRANDED_LINK_MONTHLY_LIMIT_EXCEEDED" occurs if you have shortened more links than your account is configured for for the month, and "DNS_CONFIGURATION_ERROR" occurs if you are attempting to shorten links against a custom domain which doesn't have DNS properly configured.</p></div><div><h4 class="ParameterList_h4__nH9G8 ParameterList_dividing__wRGRx">Request Body Schema</h4><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">long_url</span><span class="Parameter_type__djM_s">string</span><span class="Parameter_required__pcK_H">Required</span></div></div><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">domain</span><span class="Parameter_type__djM_s">string</span></div><div class="Parameter_default__HHgG0 Parameter_spacer__JKXbH">Default: <span class="Parameter_label__DUY7G">"bit.ly"</span></div></div><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">group_guid</span><span class="Parameter_type__djM_s">string</span></div></div></div></div><div class="MethodDetail_examples__8nXeM"><div><label class="CodeSyntaxSelector_header__6P_Jc CodeSyntaxSelector_headerDark__hI3A0"><span>Request</span><div class="Select_wrapper__58utF Select_dark__KPIws"><select class="Select_select__qXz_Z Select_dark__KPIws" aria-label="Select" autocomplete="off"><option value="cURL" selected="">cURL</option><option value="Node">Node</option><option value="Browser">Browser</option><option value="Go">Go</option><option value="Python">Python</option></select><svg viewbox="0 0 8 14" xmlns="http://www.w3.org/2000/svg"><path d="M6.463 7 .987 1.66a.61.61 0 0 1 0-.878.648.648 0 0 1 .9 0L7.813 6.56a.61.61 0 0 1 0 .878l-5.926 5.78a.648.648 0 0 1-.9 0 .61.61 0 0 1 0-.879L6.463 7Z"></path></svg></div></label><div class="CodeSyntaxSelector_body__hBJ7j CodeSyntaxSelector_bodyDark__cizVw" tabindex="0"><div class="CodeBlock_codeBlock__KlURa"><pre tabindex="0" style="color:#ffffff;font-family:ProximaNova, monospace;line-height:1.2;font-size:1rem"><code class="language-bash" style="white-space:pre"><span class="token token" style="color:#ee6123">curl</span><span> </span><span class="token token punctuation">\</span><span> </span><span>-H </span><span class="token token" style="color:#acda95">'Authorization: Bearer {TOKEN}'</span><span> </span><span class="token token punctuation">\</span><span> </span><span>-H </span><span class="token token" style="color:#acda95">'Content-Type: application/json'</span><span> </span><span class="token token punctuation">\</span><span> </span><span>-X POST </span><span class="token token punctuation">\</span><span> </span><span>-d </span><span class="token token" style="color:#acda95">'{ </span><span class="token token" style="color:#acda95"> "long_url": "https://dev.bitly.com", </span><span class="token token" style="color:#acda95"> "domain": "bit.ly", </span><span class="token token" style="color:#acda95"> "group_guid": "Ba1bc23dE4F" </span><span class="token token" style="color:#acda95">}'</span><span> </span><span class="token token punctuation">\</span><span> </span>https://api-ssl.bitly.com/v4/shorten</code></pre></div></div></div><div><label class="CodeSyntaxSelector_header__6P_Jc"><span>Response</span><div class="Select_wrapper__58utF"><select class="Select_select__qXz_Z" aria-label="Select" autocomplete="off"><option value="200" selected="">200 SUCCESS</option><option value="201">201 CREATED</option><option value="400">400 BAD_REQUEST</option><option value="403">403 FORBIDDEN</option><option value="417">417 EXPECTATION_FAILED</option><option value="422">422 UNPROCESSABLE_ENTITY</option><option value="429">429 TOO_MANY_REQUESTS</option><option value="500">500 INTERNAL_ERROR</option><option value="503">503 TEMPORARILY_UNAVAILABLE</option></select><svg viewbox="0 0 8 14" xmlns="http://www.w3.org/2000/svg"><path d="M6.463 7 .987 1.66a.61.61 0 0 1 0-.878.648.648 0 0 1 .9 0L7.813 6.56a.61.61 0 0 1 0 .878l-5.926 5.78a.648.648 0 0 1-.9 0 .61.61 0 0 1 0-.879L6.463 7Z"></path></svg></div></label><div class="CodeSyntaxSelector_body__hBJ7j" tabindex="0"><div class="CodeBlock_codeBlock__KlURa"><pre tabindex="0" style="color:#36383b;font-family:ProximaNova, monospace;line-height:1.2;font-size:1rem"><code class="language-json" style="white-space:pre"><span class="token token punctuation">{</span><span> </span><span> </span><span class="token token property">"references"</span><span class="token token operator">:</span><span> </span><span class="token token punctuation">{</span><span> </span><span class="token token" style="color:#51763e">"any"</span><span> </span><span class="token token punctuation">}</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"link"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"id"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"long_url"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"archived"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"boolean"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"created_at"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"custom_bitlinks"</span><span class="token token operator">:</span><span> </span><span class="token token punctuation">[</span><span> </span><span> </span><span class="token token" style="color:#51763e">"string"</span><span> </span><span> </span><span class="token token punctuation">]</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"tags"</span><span class="token token operator">:</span><span> </span><span class="token token punctuation">[</span><span> </span><span> </span><span class="token token" style="color:#51763e">"string"</span><span> </span><span> </span><span class="token token punctuation">]</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"deeplinks"</span><span class="token token operator">:</span><span> </span><span class="token token punctuation">[</span><span> </span><span> </span><span class="token token punctuation">{</span><span> </span><span> </span><span class="token token property">"guid"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"bitlink"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"app_uri_path"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"install_url"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"app_guid"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"os"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"install_type"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"created"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"modified"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"brand_guid"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span> </span><span> </span><span class="token token punctuation">}</span><span> </span><span> </span><span class="token token punctuation">]</span><span> </span><span></span><span class="token token punctuation">}</span></code></pre></div></div></div></div></div><div class="MethodDetail_methodContainer__3EF7h" id="createFullBitlink"><div class="MethodDetail_method__fyEiw"><div><h3 class="MethodHeader_h3__seOfC">Create a Bitlink</h3><h4 class="MethodHeader_description__3_p_p"><div class="MethodHeader_iconStyle__x5Ow4"><svg viewbox="0 0 18 6" xmlns="http://www.w3.org/2000/svg" class="IconRest_restIcon__3pju8 post"><title>Post</title><path d="M1.072 5.885V3.898c.026.006.069.011.129.017a3.88 3.88 0 0 0 .364.016h.125c.27 0 .533-.037.786-.11.253-.075.478-.193.677-.355.198-.162.357-.368.477-.618s.18-.551.18-.903c0-.401-.07-.727-.208-.977a1.592 1.592 0 0 0-.536-.585 1.971 1.971 0 0 0-.739-.28 4.854 4.854 0 0 0-.817-.07C1.249.033.987.045.724.07.46.095.219.13 0 .173v5.712h1.072Zm.461-2.934h-.098a2.344 2.344 0 0 1-.27-.017.818.818 0 0 1-.093-.016V1.047c.057-.011.133-.02.227-.03.093-.007.193-.012.297-.012.135 0 .268.014.399.042.13.027.246.077.348.148a.796.796 0 0 1 .246.284.954.954 0 0 1 .094.45c0 .214-.032.387-.098.519a.782.782 0 0 1-.262.309c-.11.074-.233.125-.371.152a2.141 2.141 0 0 1-.419.042ZM6.47 6c.694 0 1.212-.265 1.553-.795.342-.53.513-1.265.513-2.205 0-.44-.038-.843-.114-1.212a2.872 2.872 0 0 0-.36-.947 1.78 1.78 0 0 0-.637-.618C7.163.074 6.844 0 6.469 0c-.35 0-.653.069-.911.206a1.78 1.78 0 0 0-.645.59c-.172.255-.3.57-.384.943A5.804 5.804 0 0 0 4.404 3c0 .44.037.843.11 1.212.073.368.191.684.356.947.164.264.378.47.641.618.263.149.583.223.958.223Zm0-1.005c-.203 0-.366-.053-.489-.157a.989.989 0 0 1-.281-.425 2.57 2.57 0 0 1-.133-.63A8.129 8.129 0 0 1 5.53 3c0-.66.065-1.157.195-1.492.13-.335.378-.503.743-.503.209 0 .376.054.501.161a1 1 0 0 1 .286.433c.065.181.106.393.125.635.018.241.027.497.027.766 0 .34-.014.636-.043.886-.029.25-.08.457-.152.622a.826.826 0 0 1-.29.367.803.803 0 0 1-.454.12ZM10.991 6c.297 0 .574-.037.83-.111.255-.074.476-.187.664-.338.188-.151.334-.338.438-.56.104-.223.157-.483.157-.78 0-.307-.067-.563-.2-.766a1.814 1.814 0 0 0-.493-.507 3.3 3.3 0 0 0-.641-.342 11.165 11.165 0 0 1-.642-.28 2.185 2.185 0 0 1-.493-.313.562.562 0 0 1-.199-.445c0-.176.072-.316.215-.42.144-.105.34-.157.59-.157a2.757 2.757 0 0 1 .767.107.14.14 0 0 0 .047.008v.915h.86V.338a2.45 2.45 0 0 0-.735-.247C11.85.03 11.536 0 11.218 0c-.282 0-.537.041-.767.124-.23.082-.426.197-.59.346A1.557 1.557 0 0 0 9.476 1a1.66 1.66 0 0 0-.137.68c0 .324.067.588.2.792.133.203.297.372.493.506.195.135.409.246.641.334.232.088.446.176.642.264.195.088.36.19.492.305.133.115.2.266.2.453 0 .209-.081.375-.243.499-.161.123-.388.185-.68.185-.162 0-.314-.018-.458-.053a2.256 2.256 0 0 1-.395-.136l-.047-.017v-.816h-.86V5.53c.067.039.156.085.266.14.11.055.236.107.379.157.143.05.3.09.47.124.169.033.353.049.55.049Zm6.29-.115v-.907h-.885V1.022h.744v.997H18V.115h-4.287V2.02h.86v-.997h.752v3.956h-.892v.907h2.847Z"></path></svg></div> /v4/bitlinks</h4><p class="MethodHeader_description__3_p_p">Converts a long url to a Bitlink and sets additional parameters. You may see errors returned from this endpoint - "BRANDED_LINK_MONTHLY_LIMIT_EXCEEDED" occurs if you have shortened more links than your account is configured for for the month, and "DNS_CONFIGURATION_ERROR" occurs if you are attempting to shorten links against a custom domain which doesn't have DNS properly configured.</p></div><div><h4 class="ParameterList_h4__nH9G8 ParameterList_dividing__wRGRx">Request Body Schema</h4><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">long_url</span><span class="Parameter_type__djM_s">string</span><span class="Parameter_required__pcK_H">Required</span></div></div><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">domain</span><span class="Parameter_type__djM_s">string</span></div><div class="Parameter_default__HHgG0 Parameter_spacer__JKXbH">Default: <span class="Parameter_label__DUY7G">"bit.ly"</span></div></div><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">group_guid</span><span class="Parameter_type__djM_s">string</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">Always include a specific group and custom domain in your shorten calls.</div></div><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">title</span><span class="Parameter_type__djM_s">string</span></div></div><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">tags</span><span class="Parameter_type__djM_s">array of string</span></div></div><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">deeplinks</span><span class="Parameter_type__djM_s">array of object</span></div><div class="Parameter_nestedList__KmKgd"><div class="Parameter_nested__X3i_l"><div class="Parameter_parameter__J0LgW Parameter_compact__V5419"><div><span class="Parameter_name___UYgz">app_id</span><span class="Parameter_type__djM_s">string</span></div></div></div><div class="Parameter_nested__X3i_l"><div class="Parameter_parameter__J0LgW Parameter_compact__V5419"><div><span class="Parameter_name___UYgz">app_uri_path</span><span class="Parameter_type__djM_s">string</span></div></div></div><div class="Parameter_nested__X3i_l"><div class="Parameter_parameter__J0LgW Parameter_compact__V5419"><div><span class="Parameter_name___UYgz">install_url</span><span class="Parameter_type__djM_s">string</span></div></div></div><div class="Parameter_nested__X3i_l"><div class="Parameter_parameter__J0LgW Parameter_compact__V5419"><div><span class="Parameter_name___UYgz">install_type</span><span class="Parameter_type__djM_s">string</span></div></div></div></div></div></div></div><div class="MethodDetail_examples__8nXeM"><div><label class="CodeSyntaxSelector_header__6P_Jc CodeSyntaxSelector_headerDark__hI3A0"><span>Request</span><div class="Select_wrapper__58utF Select_dark__KPIws"><select class="Select_select__qXz_Z Select_dark__KPIws" aria-label="Select" autocomplete="off"><option value="cURL" selected="">cURL</option><option value="Node">Node</option><option value="Browser">Browser</option><option value="Go">Go</option><option value="Python">Python</option></select><svg viewbox="0 0 8 14" xmlns="http://www.w3.org/2000/svg"><path d="M6.463 7 .987 1.66a.61.61 0 0 1 0-.878.648.648 0 0 1 .9 0L7.813 6.56a.61.61 0 0 1 0 .878l-5.926 5.78a.648.648 0 0 1-.9 0 .61.61 0 0 1 0-.879L6.463 7Z"></path></svg></div></label><div class="CodeSyntaxSelector_body__hBJ7j CodeSyntaxSelector_bodyDark__cizVw" tabindex="0"><div class="CodeBlock_codeBlock__KlURa"><pre tabindex="0" style="color:#ffffff;font-family:ProximaNova, monospace;line-height:1.2;font-size:1rem"><code class="language-bash" style="white-space:pre"><span class="token token" style="color:#ee6123">curl</span><span> </span><span class="token token punctuation">\</span><span> </span><span>-H </span><span class="token token" style="color:#acda95">'Authorization: Bearer {TOKEN}'</span><span> </span><span class="token token punctuation">\</span><span> </span><span>-H </span><span class="token token" style="color:#acda95">'Content-Type: application/json'</span><span> </span><span class="token token punctuation">\</span><span> </span><span>-X POST </span><span class="token token punctuation">\</span><span> </span><span>-d </span><span class="token token" style="color:#acda95">'{ </span><span class="token token" style="color:#acda95"> "long_url": "https://dev.bitly.com", </span><span class="token token" style="color:#acda95"> "domain": "bit.ly", </span><span class="token token" style="color:#acda95"> "group_guid": "Ba1bc23dE4F", </span><span class="token token" style="color:#acda95"> "title": "Bitly API Documentation", </span><span class="token token" style="color:#acda95"> "tags": [ </span><span class="token token" style="color:#acda95"> "bitly", </span><span class="token token" style="color:#acda95"> "api" </span><span class="token token" style="color:#acda95"> ], </span><span class="token token" style="color:#acda95"> "deeplinks": [ </span><span class="token token" style="color:#acda95"> { </span><span class="token token" style="color:#acda95"> "app_id": "com.bitly.app", </span><span class="token token" style="color:#acda95"> "app_uri_path": "/store?id=123456", </span><span class="token token" style="color:#acda95"> "install_url": "https://play.google.com/store/apps/details?id=com.bitly.app&hl=en_US", </span><span class="token token" style="color:#acda95"> "install_type": "promote_install" </span><span class="token token" style="color:#acda95"> } </span><span class="token token" style="color:#acda95"> ] </span><span class="token token" style="color:#acda95">}'</span><span> </span><span class="token token punctuation">\</span><span> </span>https://api-ssl.bitly.com/v4/bitlinks</code></pre></div></div></div><div><label class="CodeSyntaxSelector_header__6P_Jc"><span>Response</span><div class="Select_wrapper__58utF"><select class="Select_select__qXz_Z" aria-label="Select" autocomplete="off"><option value="200" selected="">200 SUCCESS</option><option value="400">400 BAD_REQUEST</option><option value="402">402 UPGRADE_REQUIRED</option><option value="403">403 FORBIDDEN</option><option value="404">404 NOT_FOUND</option><option value="417">417 EXPECTATION_FAILED</option><option value="422">422 UNPROCESSABLE_ENTITY</option><option value="429">429 TOO_MANY_REQUESTS</option><option value="500">500 INTERNAL_ERROR</option><option value="503">503 TEMPORARILY_UNAVAILABLE</option></select><svg viewbox="0 0 8 14" xmlns="http://www.w3.org/2000/svg"><path d="M6.463 7 .987 1.66a.61.61 0 0 1 0-.878.648.648 0 0 1 .9 0L7.813 6.56a.61.61 0 0 1 0 .878l-5.926 5.78a.648.648 0 0 1-.9 0 .61.61 0 0 1 0-.879L6.463 7Z"></path></svg></div></label><div class="CodeSyntaxSelector_body__hBJ7j" tabindex="0"><div class="CodeBlock_codeBlock__KlURa"><pre tabindex="0" style="color:#36383b;font-family:ProximaNova, monospace;line-height:1.2;font-size:1rem"><code class="language-json" style="white-space:pre"><span class="token token punctuation">{</span><span> </span><span> </span><span class="token token property">"references"</span><span class="token token operator">:</span><span> </span><span class="token token punctuation">{</span><span> </span><span class="token token" style="color:#51763e">"any"</span><span> </span><span class="token token punctuation">}</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"link"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"id"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"long_url"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"title"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"archived"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"boolean"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"created_at"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"created_by"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"client_id"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"custom_bitlinks"</span><span class="token token operator">:</span><span> </span><span class="token token punctuation">[</span><span> </span><span> </span><span class="token token" style="color:#51763e">"string"</span><span> </span><span> </span><span class="token token punctuation">]</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"tags"</span><span class="token token operator">:</span><span> </span><span class="token token punctuation">[</span><span> </span><span> </span><span class="token token" style="color:#51763e">"string"</span><span> </span><span> </span><span class="token token punctuation">]</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"launchpad_ids"</span><span class="token token operator">:</span><span> </span><span class="token token punctuation">[</span><span> </span><span> </span><span class="token token" style="color:#51763e">"string"</span><span> </span><span> </span><span class="token token punctuation">]</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"deeplinks"</span><span class="token token operator">:</span><span> </span><span class="token token punctuation">[</span><span> </span><span> </span><span class="token token punctuation">{</span><span> </span><span> </span><span class="token token property">"guid"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"bitlink"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"app_uri_path"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"install_url"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"app_guid"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"os"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"install_type"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"created"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"modified"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"brand_guid"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span> </span><span> </span><span class="token token punctuation">}</span><span> </span><span> </span><span class="token token punctuation">]</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"is_deleted"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"boolean"</span><span> </span><span></span><span class="token token punctuation">}</span></code></pre></div></div></div></div></div><div class="MethodDetail_methodContainer__3EF7h" id="deleteBitlink"><div class="MethodDetail_method__fyEiw"><div><h3 class="MethodHeader_h3__seOfC">Delete a Bitlink</h3><h4 class="MethodHeader_description__3_p_p"><div class="MethodHeader_iconStyle__x5Ow4"><svg viewbox="0 0 28 6" xmlns="http://www.w3.org/2000/svg" class="IconRest_restIcon__3pju8 delete"><title>Delete</title><path d="M1.439 6c.54 0 .984-.087 1.33-.262.345-.175.616-.405.811-.69.196-.287.331-.612.406-.979.075-.366.113-.74.113-1.123 0-.422-.038-.811-.113-1.17a2.419 2.419 0 0 0-.398-.931 1.918 1.918 0 0 0-.775-.62C2.486.075 2.073 0 1.575 0c-.128 0-.274.003-.438.008C.974.014.816.021.663.03A11.118 11.118 0 0 0 0 .083v5.834c.07.01.169.02.297.029L.7 5.97c.14.008.276.015.41.02.134.006.244.009.33.009Zm.128-1.015c-.027 0-.061-.002-.104-.004a35.064 35.064 0 0 0-.133-.009l-.067-.004-.066-.004a.56.56 0 0 1-.096-.013V1.05c.048-.006.12-.013.217-.021.096-.009.196-.013.297-.013.306 0 .547.061.724.183.176.122.31.278.398.466.088.189.144.397.168.624a6.241 6.241 0 0 1-.004 1.39 2.07 2.07 0 0 1-.177.658c-.09.194-.229.35-.413.47-.185.12-.433.179-.744.179Zm7.145.923V4.893H6.084V3.47H8.47V2.455H6.084V1.098h2.588V.083h-3.69v5.825h3.73Zm4.854 0V3.537h-.997v1.356H10.97V.083h-1.1v5.825h3.696Zm4.79 0V4.893h-2.628V3.47h2.387V2.455h-2.387V1.098h2.588V.083h-3.69v5.825h3.73Zm4.404 0v-.915h-.908V1h.763v1.007h.884V.083h-4.404v1.923h.884V.999h.772v3.994h-.916v.915h2.925Zm5.24 0V4.893h-2.628V3.47h2.387V2.455h-2.387V1.098h2.588V.083H24.27v5.825H28Z"></path></svg></div> /v4/bitlinks/{bitlink}</h4><p class="MethodHeader_description__3_p_p">Delete an unedited hash Bitlink.</p></div><div><h4 class="ParameterList_h4__nH9G8 ParameterList_dividing__wRGRx">Path Parameters</h4><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">bitlink</span><span class="Parameter_type__djM_s">string</span><span class="Parameter_required__pcK_H">Required</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">A Bitlink made of the domain and hash</div></div></div></div><div class="MethodDetail_examples__8nXeM"><div><label class="CodeSyntaxSelector_header__6P_Jc CodeSyntaxSelector_headerDark__hI3A0"><span>Request</span><div class="Select_wrapper__58utF Select_dark__KPIws"><select class="Select_select__qXz_Z Select_dark__KPIws" aria-label="Select" autocomplete="off"><option value="cURL" selected="">cURL</option><option value="Node">Node</option><option value="Browser">Browser</option><option value="Go">Go</option><option value="Python">Python</option></select><svg viewbox="0 0 8 14" xmlns="http://www.w3.org/2000/svg"><path d="M6.463 7 .987 1.66a.61.61 0 0 1 0-.878.648.648 0 0 1 .9 0L7.813 6.56a.61.61 0 0 1 0 .878l-5.926 5.78a.648.648 0 0 1-.9 0 .61.61 0 0 1 0-.879L6.463 7Z"></path></svg></div></label><div class="CodeSyntaxSelector_body__hBJ7j CodeSyntaxSelector_bodyDark__cizVw" tabindex="0"><div class="CodeBlock_codeBlock__KlURa"><pre tabindex="0" style="color:#ffffff;font-family:ProximaNova, monospace;line-height:1.2;font-size:1rem"><code class="language-bash" style="white-space:pre"><span class="token token" style="color:#ee6123">curl</span><span> </span><span class="token token punctuation">\</span><span> </span><span>-H </span><span class="token token" style="color:#acda95">'Authorization: Bearer {TOKEN}'</span><span> </span><span class="token token punctuation">\</span><span> </span><span>-X DELETE </span><span class="token token punctuation">\</span><span> </span>https://api-ssl.bitly.com/v4/bitlinks/bit.ly/12a4b6c</code></pre></div></div></div><div><label class="CodeSyntaxSelector_header__6P_Jc"><span>Response</span><div class="Select_wrapper__58utF"><select class="Select_select__qXz_Z" aria-label="Select" autocomplete="off"><option value="200" selected="">200 SUCCESS</option><option value="400">400 BAD_REQUEST</option><option value="403">403 FORBIDDEN</option><option value="404">404 NOT_FOUND</option><option value="500">500 INTERNAL_ERROR</option><option value="503">503 TEMPORARILY_UNAVAILABLE</option></select><svg viewbox="0 0 8 14" xmlns="http://www.w3.org/2000/svg"><path d="M6.463 7 .987 1.66a.61.61 0 0 1 0-.878.648.648 0 0 1 .9 0L7.813 6.56a.61.61 0 0 1 0 .878l-5.926 5.78a.648.648 0 0 1-.9 0 .61.61 0 0 1 0-.879L6.463 7Z"></path></svg></div></label><div class="CodeSyntaxSelector_body__hBJ7j" tabindex="0"><div class="CodeBlock_codeBlock__KlURa"><pre tabindex="0" style="color:#36383b;font-family:ProximaNova, monospace;line-height:1.2;font-size:1rem"><code class="language-json" style="white-space:pre"><span class="token token punctuation">{</span><span> </span><span> </span><span class="token token property">"links_deleted"</span><span class="token token operator">:</span><span> </span><span class="token token punctuation">[</span><span> </span><span> </span><span class="token token punctuation">{</span><span> </span><span> </span><span class="token token property">"id"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span> </span><span> </span><span class="token token punctuation">}</span><span> </span><span> </span><span class="token token punctuation">]</span><span> </span><span></span><span class="token token punctuation">}</span></code></pre></div></div></div></div></div><div class="MethodDetail_methodContainer__3EF7h" id="updateBitlink"><div class="MethodDetail_method__fyEiw"><div><h3 class="MethodHeader_h3__seOfC">Update a Bitlink</h3><h4 class="MethodHeader_description__3_p_p"><div class="MethodHeader_iconStyle__x5Ow4"><svg viewbox="0 0 23 6" xmlns="http://www.w3.org/2000/svg" class="IconRest_restIcon__3pju8 patch"><title>Patch</title><path d="M1.095 5.885V3.898c.027.006.07.011.132.017a4.052 4.052 0 0 0 .372.016h.128c.277 0 .545-.037.803-.11.259-.075.49-.193.692-.355.202-.162.365-.368.487-.618.123-.25.184-.551.184-.903 0-.401-.07-.727-.212-.977a1.606 1.606 0 0 0-.547-.585 2.041 2.041 0 0 0-.756-.28 5.067 5.067 0 0 0-.835-.07c-.267 0-.534.012-.804.037C.47.095.224.13 0 .173v5.712h1.095Zm.472-2.934h-.1a2.448 2.448 0 0 1-.276-.017.853.853 0 0 1-.096-.016V1.047c.059-.011.136-.02.232-.03.096-.007.197-.012.304-.012.138 0 .274.014.408.042a.964.964 0 0 1 .355.148.801.801 0 0 1 .252.284.937.937 0 0 1 .096.45c0 .214-.033.387-.1.519a.787.787 0 0 1-.268.309 1.038 1.038 0 0 1-.38.152 2.235 2.235 0 0 1-.427.042Zm3.79 2.934.383-1.278h1.67l.4 1.278h1.152L7.163.115H6.068L4.26 5.885h1.095ZM7.194 3.7h-1.2l.56-1.929h.072l.568 1.929Zm5.668 2.184v-.907h-.903V1.022h.76v.997h.879V.115H9.218V2.02h.879v-.997h.767v3.956h-.91v.907h2.91Zm3.91.115c.276 0 .547-.036.81-.107.265-.072.482-.17.652-.297V3.948h-.88v.997c-.164.033-.335.05-.51.05-.246 0-.464-.049-.656-.145a1.383 1.383 0 0 1-.488-.408 1.881 1.881 0 0 1-.304-.63A2.973 2.973 0 0 1 15.293 3c0-.34.038-.636.112-.886.075-.25.179-.457.312-.622.133-.165.29-.287.468-.367.178-.08.371-.12.58-.12.175 0 .346.014.511.042v.94h.88V.271a2.727 2.727 0 0 0-.548-.19A3.419 3.419 0 0 0 16.796 0c-.303 0-.613.05-.927.152-.314.102-.6.27-.855.503a2.611 2.611 0 0 0-.628.923c-.163.382-.244.856-.244 1.422 0 .544.072 1.007.216 1.389.144.382.336.692.576.931.24.24.518.412.835.52.317.106.652.16 1.003.16Zm3.325-.115V3.47h1.807v2.415H23V.115h-1.095v2.35h-1.807V.114h-1.095v5.77h1.095Z"></path></svg></div> /v4/bitlinks/{bitlink}</h4><p class="MethodHeader_description__3_p_p">Updates fields in the specified link.</p></div><div><h4 class="ParameterList_h4__nH9G8 ParameterList_dividing__wRGRx">Path Parameters</h4><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">bitlink</span><span class="Parameter_type__djM_s">string</span><span class="Parameter_required__pcK_H">Required</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">A Bitlink made of the domain and hash</div></div></div><div><h4 class="ParameterList_h4__nH9G8 ParameterList_dividing__wRGRx">Request Body Schema</h4><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">references</span><span class="Parameter_type__djM_s">object</span></div></div><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">link</span><span class="Parameter_type__djM_s">string</span></div></div><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">id</span><span class="Parameter_type__djM_s">string</span></div></div><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">long_url</span><span class="Parameter_type__djM_s">string</span></div></div><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">title</span><span class="Parameter_type__djM_s">string</span></div></div><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">archived</span><span class="Parameter_type__djM_s">boolean</span></div></div><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">created_at</span><span class="Parameter_type__djM_s">string</span></div></div><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">created_by</span><span class="Parameter_type__djM_s">string</span></div></div><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">client_id</span><span class="Parameter_type__djM_s">string</span></div></div><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">custom_bitlinks</span><span class="Parameter_type__djM_s">array of string</span></div></div><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">tags</span><span class="Parameter_type__djM_s">array of string</span></div></div><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">launchpad_ids</span><span class="Parameter_type__djM_s">array of string</span></div></div><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">deeplinks</span><span class="Parameter_type__djM_s">array of object</span></div><div class="Parameter_nestedList__KmKgd"><div class="Parameter_nested__X3i_l"><div class="Parameter_parameter__J0LgW Parameter_compact__V5419"><div><span class="Parameter_name___UYgz">guid</span><span class="Parameter_type__djM_s">string</span></div></div></div><div class="Parameter_nested__X3i_l"><div class="Parameter_parameter__J0LgW Parameter_compact__V5419"><div><span class="Parameter_name___UYgz">bitlink</span><span class="Parameter_type__djM_s">string</span></div></div></div><div class="Parameter_nested__X3i_l"><div class="Parameter_parameter__J0LgW Parameter_compact__V5419"><div><span class="Parameter_name___UYgz">app_uri_path</span><span class="Parameter_type__djM_s">string</span></div></div></div><div class="Parameter_nested__X3i_l"><div class="Parameter_parameter__J0LgW Parameter_compact__V5419"><div><span class="Parameter_name___UYgz">install_url</span><span class="Parameter_type__djM_s">string</span></div></div></div><div class="Parameter_nested__X3i_l"><div class="Parameter_parameter__J0LgW Parameter_compact__V5419"><div><span class="Parameter_name___UYgz">app_guid</span><span class="Parameter_type__djM_s">string</span></div></div></div><div class="Parameter_nested__X3i_l"><div class="Parameter_parameter__J0LgW Parameter_compact__V5419"><div><span class="Parameter_name___UYgz">os</span><span class="Parameter_type__djM_s">string</span></div></div></div><div class="Parameter_nested__X3i_l"><div class="Parameter_parameter__J0LgW Parameter_compact__V5419"><div><span class="Parameter_name___UYgz">install_type</span><span class="Parameter_type__djM_s">string</span></div></div></div><div class="Parameter_nested__X3i_l"><div class="Parameter_parameter__J0LgW Parameter_compact__V5419"><div><span class="Parameter_name___UYgz">created</span><span class="Parameter_type__djM_s">string</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">ISO timestamp</div></div></div><div class="Parameter_nested__X3i_l"><div class="Parameter_parameter__J0LgW Parameter_compact__V5419"><div><span class="Parameter_name___UYgz">modified</span><span class="Parameter_type__djM_s">string</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">ISO timestamp</div></div></div><div class="Parameter_nested__X3i_l"><div class="Parameter_parameter__J0LgW Parameter_compact__V5419"><div><span class="Parameter_name___UYgz">brand_guid</span><span class="Parameter_type__djM_s">string</span></div></div></div></div></div><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">is_deleted</span><span class="Parameter_type__djM_s">boolean</span></div></div></div></div><div class="MethodDetail_examples__8nXeM"><div><label class="CodeSyntaxSelector_header__6P_Jc CodeSyntaxSelector_headerDark__hI3A0"><span>Request</span><div class="Select_wrapper__58utF Select_dark__KPIws"><select class="Select_select__qXz_Z Select_dark__KPIws" aria-label="Select" autocomplete="off"><option value="cURL" selected="">cURL</option><option value="Node">Node</option><option value="Browser">Browser</option><option value="Go">Go</option><option value="Python">Python</option></select><svg viewbox="0 0 8 14" xmlns="http://www.w3.org/2000/svg"><path d="M6.463 7 .987 1.66a.61.61 0 0 1 0-.878.648.648 0 0 1 .9 0L7.813 6.56a.61.61 0 0 1 0 .878l-5.926 5.78a.648.648 0 0 1-.9 0 .61.61 0 0 1 0-.879L6.463 7Z"></path></svg></div></label><div class="CodeSyntaxSelector_body__hBJ7j CodeSyntaxSelector_bodyDark__cizVw" tabindex="0"><div class="CodeBlock_codeBlock__KlURa"><pre tabindex="0" style="color:#ffffff;font-family:ProximaNova, monospace;line-height:1.2;font-size:1rem"><code class="language-bash" style="white-space:pre"><span class="token token" style="color:#ee6123">curl</span><span> </span><span class="token token punctuation">\</span><span> </span><span>-H </span><span class="token token" style="color:#acda95">'Authorization: Bearer {TOKEN}'</span><span> </span><span class="token token punctuation">\</span><span> </span><span>-H </span><span class="token token" style="color:#acda95">'Content-Type: application/json'</span><span> </span><span class="token token punctuation">\</span><span> </span><span>-X PATCH </span><span class="token token punctuation">\</span><span> </span><span>-d </span><span class="token token" style="color:#acda95">'{ </span><span class="token token" style="color:#acda95"> "link": "https://bit.ly/documentation", </span><span class="token token" style="color:#acda95"> "id": "bit.ly/documentation", </span><span class="token token" style="color:#acda95"> "long_url": "https://dev.bitly.com", </span><span class="token token" style="color:#acda95"> "title": "Bitly API Documentation", </span><span class="token token" style="color:#acda95"> "archived": false, </span><span class="token token" style="color:#acda95"> "created_at": "2006-03-12T16:29:46+0000", </span><span class="token token" style="color:#acda95"> "created_by": "chauncey", </span><span class="token token" style="color:#acda95"> "client_id": "1234a56b789cd0e123456fg7h8901j123km45n6p", </span><span class="token token" style="color:#acda95"> "custom_bitlinks": [ </span><span class="token token" style="color:#acda95"> "https://chauncey.ly/documentation" </span><span class="token token" style="color:#acda95"> ], </span><span class="token token" style="color:#acda95"> "tags": [ </span><span class="token token" style="color:#acda95"> "bitly", </span><span class="token token" style="color:#acda95"> "api" </span><span class="token token" style="color:#acda95"> ], </span><span class="token token" style="color:#acda95"> "deeplinks": [ </span><span class="token token" style="color:#acda95"> { </span><span class="token token" style="color:#acda95"> "guid": "Ra1bcD2eF3h", </span><span class="token token" style="color:#acda95"> "bitlink": "bit.ly/documentation", </span><span class="token token" style="color:#acda95"> "app_uri_path": "/store?id=123456", </span><span class="token token" style="color:#acda95"> "install_url": "https://play.google.com/store/apps/details?id=com.bitly.app&hl=en_US", </span><span class="token token" style="color:#acda95"> "app_guid": "Ab1cdE2fG3h", </span><span class="token token" style="color:#acda95"> "os": "android", </span><span class="token token" style="color:#acda95"> "install_type": "promote_install", </span><span class="token token" style="color:#acda95"> "brand_guid": "Ba1bc23dE4F" </span><span class="token token" style="color:#acda95"> } </span><span class="token token" style="color:#acda95"> ] </span><span class="token token" style="color:#acda95">}'</span><span> </span><span class="token token punctuation">\</span><span> </span>https://api-ssl.bitly.com/v4/bitlinks/bit.ly/12a4b6c</code></pre></div></div></div><div><label class="CodeSyntaxSelector_header__6P_Jc"><span>Response</span><div class="Select_wrapper__58utF"><select class="Select_select__qXz_Z" aria-label="Select" autocomplete="off"><option value="200" selected="">200 SUCCESS</option><option value="400">400 BAD_REQUEST</option><option value="402">402 UPGRADE_REQUIRED</option><option value="403">403 FORBIDDEN</option><option value="404">404 NOT_FOUND</option><option value="410">410 GONE</option><option value="422">422 UNPROCESSABLE_ENTITY</option><option value="500">500 INTERNAL_ERROR</option><option value="503">503 TEMPORARILY_UNAVAILABLE</option></select><svg viewbox="0 0 8 14" xmlns="http://www.w3.org/2000/svg"><path d="M6.463 7 .987 1.66a.61.61 0 0 1 0-.878.648.648 0 0 1 .9 0L7.813 6.56a.61.61 0 0 1 0 .878l-5.926 5.78a.648.648 0 0 1-.9 0 .61.61 0 0 1 0-.879L6.463 7Z"></path></svg></div></label><div class="CodeSyntaxSelector_body__hBJ7j" tabindex="0"><div class="CodeBlock_codeBlock__KlURa"><pre tabindex="0" style="color:#36383b;font-family:ProximaNova, monospace;line-height:1.2;font-size:1rem"><code class="language-json" style="white-space:pre"><span class="token token punctuation">{</span><span> </span><span> </span><span class="token token property">"references"</span><span class="token token operator">:</span><span> </span><span class="token token punctuation">{</span><span> </span><span class="token token" style="color:#51763e">"any"</span><span> </span><span class="token token punctuation">}</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"link"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"id"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"long_url"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"title"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"archived"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"boolean"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"created_at"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"created_by"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"client_id"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"custom_bitlinks"</span><span class="token token operator">:</span><span> </span><span class="token token punctuation">[</span><span> </span><span> </span><span class="token token" style="color:#51763e">"string"</span><span> </span><span> </span><span class="token token punctuation">]</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"tags"</span><span class="token token operator">:</span><span> </span><span class="token token punctuation">[</span><span> </span><span> </span><span class="token token" style="color:#51763e">"string"</span><span> </span><span> </span><span class="token token punctuation">]</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"launchpad_ids"</span><span class="token token operator">:</span><span> </span><span class="token token punctuation">[</span><span> </span><span> </span><span class="token token" style="color:#51763e">"string"</span><span> </span><span> </span><span class="token token punctuation">]</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"deeplinks"</span><span class="token token operator">:</span><span> </span><span class="token token punctuation">[</span><span> </span><span> </span><span class="token token punctuation">{</span><span> </span><span> </span><span class="token token property">"guid"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"bitlink"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"app_uri_path"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"install_url"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"app_guid"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"os"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"install_type"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"created"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"modified"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"brand_guid"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span> </span><span> </span><span class="token token punctuation">}</span><span> </span><span> </span><span class="token token punctuation">]</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"is_deleted"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"boolean"</span><span> </span><span></span><span class="token token punctuation">}</span></code></pre></div></div></div></div></div><div class="MethodDetail_methodContainer__3EF7h" id="getBitlink"><div class="MethodDetail_method__fyEiw"><div><h3 class="MethodHeader_h3__seOfC">Retrieve a Bitlink</h3><h4 class="MethodHeader_description__3_p_p"><div class="MethodHeader_iconStyle__x5Ow4"><svg viewbox="0 0 14 6" xmlns="http://www.w3.org/2000/svg" class="IconRest_restIcon__3pju8 get"><title>Get</title><path d="M2.587 6c.307 0 .607-.044.9-.132.295-.088.533-.217.716-.387V2.876H2.271v.825h1.027v1.145a.772.772 0 0 1-.239.1 1.4 1.4 0 0 1-.383.049 1.338 1.338 0 0 1-1.083-.52c-.135-.17-.24-.379-.316-.626a2.879 2.879 0 0 1-.113-.84c0-.352.038-.655.113-.907.076-.253.182-.46.32-.623.137-.162.3-.281.488-.358a1.783 1.783 0 0 1 .97-.082l.13.032v.915h.889V.28a3.182 3.182 0 0 0-.59-.202A3.507 3.507 0 0 0 2.676 0c-.313 0-.628.055-.946.165a2.4 2.4 0 0 0-.861.523 2.707 2.707 0 0 0-.627.92C.081 1.98 0 2.433 0 2.966c0 .506.067.946.202 1.323.135.376.318.692.55.948a2.2 2.2 0 0 0 .82.572A2.7 2.7 0 0 0 2.587 6Zm6.24-.115V4.879H6.184V3.47h2.4V2.465h-2.4V1.121h2.602V.115h-3.71v5.77h3.75Zm4.43 0v-.907h-.914V1.022h.768v.997H14V.115H9.57V2.02h.89v-.997h.776v3.956h-.922v.907h2.942Z"></path></svg></div> /v4/bitlinks/{bitlink}</h4><p class="MethodHeader_description__3_p_p">Returns information for the specified link.</p></div><div><h4 class="ParameterList_h4__nH9G8 ParameterList_dividing__wRGRx">Path Parameters</h4><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">bitlink</span><span class="Parameter_type__djM_s">string</span><span class="Parameter_required__pcK_H">Required</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">A Bitlink made of the domain and hash</div></div></div></div><div class="MethodDetail_examples__8nXeM"><div><label class="CodeSyntaxSelector_header__6P_Jc CodeSyntaxSelector_headerDark__hI3A0"><span>Request</span><div class="Select_wrapper__58utF Select_dark__KPIws"><select class="Select_select__qXz_Z Select_dark__KPIws" aria-label="Select" autocomplete="off"><option value="cURL" selected="">cURL</option><option value="Node">Node</option><option value="Browser">Browser</option><option value="Go">Go</option><option value="Python">Python</option></select><svg viewbox="0 0 8 14" xmlns="http://www.w3.org/2000/svg"><path d="M6.463 7 .987 1.66a.61.61 0 0 1 0-.878.648.648 0 0 1 .9 0L7.813 6.56a.61.61 0 0 1 0 .878l-5.926 5.78a.648.648 0 0 1-.9 0 .61.61 0 0 1 0-.879L6.463 7Z"></path></svg></div></label><div class="CodeSyntaxSelector_body__hBJ7j CodeSyntaxSelector_bodyDark__cizVw" tabindex="0"><div class="CodeBlock_codeBlock__KlURa"><pre tabindex="0" style="color:#ffffff;font-family:ProximaNova, monospace;line-height:1.2;font-size:1rem"><code class="language-bash" style="white-space:pre"><span class="token token" style="color:#ee6123">curl</span><span> </span><span class="token token punctuation">\</span><span> </span><span>-H </span><span class="token token" style="color:#acda95">'Authorization: Bearer {TOKEN}'</span><span> </span><span class="token token punctuation">\</span><span> </span><span>-X GET </span><span class="token token punctuation">\</span><span> </span>https://api-ssl.bitly.com/v4/bitlinks/bit.ly/12a4b6c</code></pre></div></div></div><div><label class="CodeSyntaxSelector_header__6P_Jc"><span>Response</span><div class="Select_wrapper__58utF"><select class="Select_select__qXz_Z" aria-label="Select" autocomplete="off"><option value="200" selected="">200 SUCCESS</option><option value="403">403 FORBIDDEN</option><option value="404">404 NOT_FOUND</option><option value="410">410 GONE</option><option value="500">500 INTERNAL_ERROR</option><option value="503">503 TEMPORARILY_UNAVAILABLE</option></select><svg viewbox="0 0 8 14" xmlns="http://www.w3.org/2000/svg"><path d="M6.463 7 .987 1.66a.61.61 0 0 1 0-.878.648.648 0 0 1 .9 0L7.813 6.56a.61.61 0 0 1 0 .878l-5.926 5.78a.648.648 0 0 1-.9 0 .61.61 0 0 1 0-.879L6.463 7Z"></path></svg></div></label><div class="CodeSyntaxSelector_body__hBJ7j" tabindex="0"><div class="CodeBlock_codeBlock__KlURa"><pre tabindex="0" style="color:#36383b;font-family:ProximaNova, monospace;line-height:1.2;font-size:1rem"><code class="language-json" style="white-space:pre"><span class="token token punctuation">{</span><span> </span><span> </span><span class="token token property">"references"</span><span class="token token operator">:</span><span> </span><span class="token token punctuation">{</span><span> </span><span class="token token" style="color:#51763e">"any"</span><span> </span><span class="token token punctuation">}</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"link"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"id"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"long_url"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"title"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"archived"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"boolean"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"created_at"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"created_by"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"client_id"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"custom_bitlinks"</span><span class="token token operator">:</span><span> </span><span class="token token punctuation">[</span><span> </span><span> </span><span class="token token" style="color:#51763e">"string"</span><span> </span><span> </span><span class="token token punctuation">]</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"tags"</span><span class="token token operator">:</span><span> </span><span class="token token punctuation">[</span><span> </span><span> </span><span class="token token" style="color:#51763e">"string"</span><span> </span><span> </span><span class="token token punctuation">]</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"launchpad_ids"</span><span class="token token operator">:</span><span> </span><span class="token token punctuation">[</span><span> </span><span> </span><span class="token token" style="color:#51763e">"string"</span><span> </span><span> </span><span class="token token punctuation">]</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"deeplinks"</span><span class="token token operator">:</span><span> </span><span class="token token punctuation">[</span><span> </span><span> </span><span class="token token punctuation">{</span><span> </span><span> </span><span class="token token property">"guid"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"bitlink"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"app_uri_path"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"install_url"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"app_guid"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"os"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"install_type"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"created"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"modified"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"brand_guid"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span> </span><span> </span><span class="token token punctuation">}</span><span> </span><span> </span><span class="token token punctuation">]</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"is_deleted"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"boolean"</span><span> </span><span></span><span class="token token punctuation">}</span></code></pre></div></div></div></div></div><div class="MethodDetail_methodContainer__3EF7h" id="getBitlinkQRCode"><div class="MethodDetail_method__fyEiw"><div><h3 class="MethodHeader_h3__seOfC">Retrieve a QR Code</h3><h4 class="MethodHeader_description__3_p_p"><div class="MethodHeader_iconStyle__x5Ow4"><svg viewbox="0 0 14 6" xmlns="http://www.w3.org/2000/svg" class="IconRest_restIcon__3pju8 get"><title>Get</title><path d="M2.587 6c.307 0 .607-.044.9-.132.295-.088.533-.217.716-.387V2.876H2.271v.825h1.027v1.145a.772.772 0 0 1-.239.1 1.4 1.4 0 0 1-.383.049 1.338 1.338 0 0 1-1.083-.52c-.135-.17-.24-.379-.316-.626a2.879 2.879 0 0 1-.113-.84c0-.352.038-.655.113-.907.076-.253.182-.46.32-.623.137-.162.3-.281.488-.358a1.783 1.783 0 0 1 .97-.082l.13.032v.915h.889V.28a3.182 3.182 0 0 0-.59-.202A3.507 3.507 0 0 0 2.676 0c-.313 0-.628.055-.946.165a2.4 2.4 0 0 0-.861.523 2.707 2.707 0 0 0-.627.92C.081 1.98 0 2.433 0 2.966c0 .506.067.946.202 1.323.135.376.318.692.55.948a2.2 2.2 0 0 0 .82.572A2.7 2.7 0 0 0 2.587 6Zm6.24-.115V4.879H6.184V3.47h2.4V2.465h-2.4V1.121h2.602V.115h-3.71v5.77h3.75Zm4.43 0v-.907h-.914V1.022h.768v.997H14V.115H9.57V2.02h.89v-.997h.776v3.956h-.922v.907h2.942Z"></path></svg></div> /v4/bitlinks/{bitlink}/qr</h4><p class="MethodHeader_description__3_p_p">Generates a QR code for a Bitlink.</p></div><div><h4 class="ParameterList_h4__nH9G8 ParameterList_dividing__wRGRx">Path Parameters</h4><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">bitlink</span><span class="Parameter_type__djM_s">string</span><span class="Parameter_required__pcK_H">Required</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">A Bitlink made of the domain and hash</div></div></div><div><h4 class="ParameterList_h4__nH9G8 ParameterList_dividing__wRGRx">Query Parameters</h4><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">color</span><span class="Parameter_type__djM_s">string</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">A color denoted in hexadecimal format ei. "1133ff"</div></div><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">exclude_bitly_logo</span><span class="Parameter_type__djM_s">boolean</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">Removes the Bitly logo from the center of the generated QR image</div></div><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">image_format</span><span class="Parameter_type__djM_s">string</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">Determines the image format of the returned QR code</div><div class="Parameter_default__HHgG0 Parameter_spacer__JKXbH">Default: <span class="Parameter_label__DUY7G">"png"</span></div><div class="Parameter_enum__csO6P Parameter_spacer__JKXbH">Enum: <span class="Parameter_label__DUY7G">"png"</span><span class="Parameter_label__DUY7G">"svg"</span></div></div></div></div><div class="MethodDetail_examples__8nXeM"><div><label class="CodeSyntaxSelector_header__6P_Jc CodeSyntaxSelector_headerDark__hI3A0"><span>Request</span><div class="Select_wrapper__58utF Select_dark__KPIws"><select class="Select_select__qXz_Z Select_dark__KPIws" aria-label="Select" autocomplete="off"><option value="cURL" selected="">cURL</option><option value="Node">Node</option><option value="Browser">Browser</option><option value="Go">Go</option><option value="Python">Python</option></select><svg viewbox="0 0 8 14" xmlns="http://www.w3.org/2000/svg"><path d="M6.463 7 .987 1.66a.61.61 0 0 1 0-.878.648.648 0 0 1 .9 0L7.813 6.56a.61.61 0 0 1 0 .878l-5.926 5.78a.648.648 0 0 1-.9 0 .61.61 0 0 1 0-.879L6.463 7Z"></path></svg></div></label><div class="CodeSyntaxSelector_body__hBJ7j CodeSyntaxSelector_bodyDark__cizVw" tabindex="0"><div class="CodeBlock_codeBlock__KlURa"><pre tabindex="0" style="color:#ffffff;font-family:ProximaNova, monospace;line-height:1.2;font-size:1rem"><code class="language-bash" style="white-space:pre"><span class="token token" style="color:#ee6123">curl</span><span> </span><span class="token token punctuation">\</span><span> </span><span>-H </span><span class="token token" style="color:#acda95">'Authorization: Bearer {TOKEN}'</span><span> </span><span class="token token punctuation">\</span><span> </span><span>-X GET </span><span class="token token punctuation">\</span><span> </span><span>https://api-ssl.bitly.com/v4/bitlinks/bit.ly/12a4b6c/qr?color</span><span class="token token operator">=</span><span>1133ff</span><span class="token token operator">&</span><span class="token token assign-left variable">exclude_bitly_logo</span><span class="token token operator">=</span><span class="token token operator">&</span><span class="token token assign-left variable">image_format</span><span class="token token operator">=</span><span>svg</span></code></pre></div></div></div><div><label class="CodeSyntaxSelector_header__6P_Jc"><span>Response</span><div class="Select_wrapper__58utF"><select class="Select_select__qXz_Z" aria-label="Select" autocomplete="off"><option value="200" selected="">200 SUCCESS</option><option value="400">400 BAD_REQUEST</option><option value="402">402 UPGRADE_REQUIRED</option><option value="403">403 FORBIDDEN</option><option value="404">404 NOT_FOUND</option><option value="410">410 GONE</option><option value="500">500 INTERNAL_ERROR</option></select><svg viewbox="0 0 8 14" xmlns="http://www.w3.org/2000/svg"><path d="M6.463 7 .987 1.66a.61.61 0 0 1 0-.878.648.648 0 0 1 .9 0L7.813 6.56a.61.61 0 0 1 0 .878l-5.926 5.78a.648.648 0 0 1-.9 0 .61.61 0 0 1 0-.879L6.463 7Z"></path></svg></div></label><div class="CodeSyntaxSelector_body__hBJ7j" tabindex="0"><div class="CodeBlock_codeBlock__KlURa"><pre tabindex="0" style="color:#36383b;font-family:ProximaNova, monospace;line-height:1.2;font-size:1rem"><code class="language-json" style="white-space:pre"><span class="token token punctuation">{</span><span> </span><span> </span><span class="token token property">"id"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"link"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"group_guid"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"customization"</span><span class="token token operator">:</span><span> </span><span class="token token punctuation">{</span><span> </span><span> </span><span class="token token property">"color"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"exclude_bitly_logo"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"boolean"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"image_format"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"logo_image_guid"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span> </span><span> </span><span class="token token punctuation">}</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"qr_code"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"logo_image_url"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"has_stored"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"boolean"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"created"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"modified"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span> </span><span></span><span class="token token punctuation">}</span></code></pre></div></div></div></div></div><div class="MethodDetail_methodContainer__3EF7h" id="updateBitlinkQRCode"><div class="MethodDetail_method__fyEiw"><div><h3 class="MethodHeader_h3__seOfC">Update a QR Code</h3><h4 class="MethodHeader_description__3_p_p"><div class="MethodHeader_iconStyle__x5Ow4"><svg viewbox="0 0 23 6" xmlns="http://www.w3.org/2000/svg" class="IconRest_restIcon__3pju8 patch"><title>Patch</title><path d="M1.095 5.885V3.898c.027.006.07.011.132.017a4.052 4.052 0 0 0 .372.016h.128c.277 0 .545-.037.803-.11.259-.075.49-.193.692-.355.202-.162.365-.368.487-.618.123-.25.184-.551.184-.903 0-.401-.07-.727-.212-.977a1.606 1.606 0 0 0-.547-.585 2.041 2.041 0 0 0-.756-.28 5.067 5.067 0 0 0-.835-.07c-.267 0-.534.012-.804.037C.47.095.224.13 0 .173v5.712h1.095Zm.472-2.934h-.1a2.448 2.448 0 0 1-.276-.017.853.853 0 0 1-.096-.016V1.047c.059-.011.136-.02.232-.03.096-.007.197-.012.304-.012.138 0 .274.014.408.042a.964.964 0 0 1 .355.148.801.801 0 0 1 .252.284.937.937 0 0 1 .096.45c0 .214-.033.387-.1.519a.787.787 0 0 1-.268.309 1.038 1.038 0 0 1-.38.152 2.235 2.235 0 0 1-.427.042Zm3.79 2.934.383-1.278h1.67l.4 1.278h1.152L7.163.115H6.068L4.26 5.885h1.095ZM7.194 3.7h-1.2l.56-1.929h.072l.568 1.929Zm5.668 2.184v-.907h-.903V1.022h.76v.997h.879V.115H9.218V2.02h.879v-.997h.767v3.956h-.91v.907h2.91Zm3.91.115c.276 0 .547-.036.81-.107.265-.072.482-.17.652-.297V3.948h-.88v.997c-.164.033-.335.05-.51.05-.246 0-.464-.049-.656-.145a1.383 1.383 0 0 1-.488-.408 1.881 1.881 0 0 1-.304-.63A2.973 2.973 0 0 1 15.293 3c0-.34.038-.636.112-.886.075-.25.179-.457.312-.622.133-.165.29-.287.468-.367.178-.08.371-.12.58-.12.175 0 .346.014.511.042v.94h.88V.271a2.727 2.727 0 0 0-.548-.19A3.419 3.419 0 0 0 16.796 0c-.303 0-.613.05-.927.152-.314.102-.6.27-.855.503a2.611 2.611 0 0 0-.628.923c-.163.382-.244.856-.244 1.422 0 .544.072 1.007.216 1.389.144.382.336.692.576.931.24.24.518.412.835.52.317.106.652.16 1.003.16Zm3.325-.115V3.47h1.807v2.415H23V.115h-1.095v2.35h-1.807V.114h-1.095v5.77h1.095Z"></path></svg></div> /v4/bitlinks/{bitlink}/qr</h4><p class="MethodHeader_description__3_p_p">Updates an existing QR Code</p></div><div><h4 class="ParameterList_h4__nH9G8 ParameterList_dividing__wRGRx">Path Parameters</h4><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">bitlink</span><span class="Parameter_type__djM_s">string</span><span class="Parameter_required__pcK_H">Required</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">A Bitlink made of the domain and hash</div></div></div><div><h4 class="ParameterList_h4__nH9G8 ParameterList_dividing__wRGRx">Request Body Schema</h4><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">color</span><span class="Parameter_type__djM_s">string</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">A color denoted in hexadecimal format ei. "1133ff"</div></div><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">exclude_bitly_logo</span><span class="Parameter_type__djM_s">boolean</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">Removes the Bitly logo from the center of the generated QR image</div></div><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">image_format</span><span class="Parameter_type__djM_s">string</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">Determines the image format of the returned QR code</div><div class="Parameter_default__HHgG0 Parameter_spacer__JKXbH">Default: <span class="Parameter_label__DUY7G">"png"</span></div><div class="Parameter_enum__csO6P Parameter_spacer__JKXbH">Enum: <span class="Parameter_label__DUY7G">"png"</span><span class="Parameter_label__DUY7G">"svg"</span></div></div><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">logo_image_guid</span><span class="Parameter_type__djM_s">string</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">Logo must first be uploaded through Bitly's QR Code Modal located on the "All links" page. Once created, a call to "Retrieve a QR Code" with specified bitlink will return the auto-generated "logo_image_guid"</div></div></div></div><div class="MethodDetail_examples__8nXeM"><div><label class="CodeSyntaxSelector_header__6P_Jc CodeSyntaxSelector_headerDark__hI3A0"><span>Request</span><div class="Select_wrapper__58utF Select_dark__KPIws"><select class="Select_select__qXz_Z Select_dark__KPIws" aria-label="Select" autocomplete="off"><option value="cURL" selected="">cURL</option><option value="Node">Node</option><option value="Browser">Browser</option><option value="Go">Go</option><option value="Python">Python</option></select><svg viewbox="0 0 8 14" xmlns="http://www.w3.org/2000/svg"><path d="M6.463 7 .987 1.66a.61.61 0 0 1 0-.878.648.648 0 0 1 .9 0L7.813 6.56a.61.61 0 0 1 0 .878l-5.926 5.78a.648.648 0 0 1-.9 0 .61.61 0 0 1 0-.879L6.463 7Z"></path></svg></div></label><div class="CodeSyntaxSelector_body__hBJ7j CodeSyntaxSelector_bodyDark__cizVw" tabindex="0"><div class="CodeBlock_codeBlock__KlURa"><pre tabindex="0" style="color:#ffffff;font-family:ProximaNova, monospace;line-height:1.2;font-size:1rem"><code class="language-bash" style="white-space:pre"><span class="token token" style="color:#ee6123">curl</span><span> </span><span class="token token punctuation">\</span><span> </span><span>-H </span><span class="token token" style="color:#acda95">'Authorization: Bearer {TOKEN}'</span><span> </span><span class="token token punctuation">\</span><span> </span><span>-H </span><span class="token token" style="color:#acda95">'Content-Type: application/json'</span><span> </span><span class="token token punctuation">\</span><span> </span><span>-X PATCH </span><span class="token token punctuation">\</span><span> </span><span>-d </span><span class="token token" style="color:#acda95">'{ </span><span class="token token" style="color:#acda95"> "color": "1133ff", </span><span class="token token" style="color:#acda95"> "exclude_bitly_logo": true, </span><span class="token token" style="color:#acda95"> "image_format": "svg", </span><span class="token token" style="color:#acda95"> "logo_image_guid": "I123456789" </span><span class="token token" style="color:#acda95">}'</span><span> </span><span class="token token punctuation">\</span><span> </span>https://api-ssl.bitly.com/v4/bitlinks/bit.ly/12a4b6c/qr</code></pre></div></div></div><div><label class="CodeSyntaxSelector_header__6P_Jc"><span>Response</span><div class="Select_wrapper__58utF"><select class="Select_select__qXz_Z" aria-label="Select" autocomplete="off"><option value="200" selected="">200 SUCCESS</option><option value="400">400 BAD_REQUEST</option><option value="402">402 UPGRADE_REQUIRED</option><option value="403">403 FORBIDDEN</option><option value="404">404 NOT_FOUND</option><option value="410">410 GONE</option><option value="500">500 INTERNAL_ERROR</option></select><svg viewbox="0 0 8 14" xmlns="http://www.w3.org/2000/svg"><path d="M6.463 7 .987 1.66a.61.61 0 0 1 0-.878.648.648 0 0 1 .9 0L7.813 6.56a.61.61 0 0 1 0 .878l-5.926 5.78a.648.648 0 0 1-.9 0 .61.61 0 0 1 0-.879L6.463 7Z"></path></svg></div></label><div class="CodeSyntaxSelector_body__hBJ7j" tabindex="0"><div class="CodeBlock_codeBlock__KlURa"><pre tabindex="0" style="color:#36383b;font-family:ProximaNova, monospace;line-height:1.2;font-size:1rem"><code class="language-json" style="white-space:pre"><span class="token token punctuation">{</span><span> </span><span> </span><span class="token token property">"id"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"link"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"group_guid"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"customization"</span><span class="token token operator">:</span><span> </span><span class="token token punctuation">{</span><span> </span><span> </span><span class="token token property">"color"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"exclude_bitly_logo"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"boolean"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"image_format"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"logo_image_guid"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span> </span><span> </span><span class="token token punctuation">}</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"qr_code"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"logo_image_url"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"has_stored"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"boolean"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"created"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"modified"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span> </span><span></span><span class="token token punctuation">}</span></code></pre></div></div></div></div></div><div class="MethodDetail_methodContainer__3EF7h" id="createBitlinkQRCode"><div class="MethodDetail_method__fyEiw"><div><h3 class="MethodHeader_h3__seOfC">Create a QR Code</h3><h4 class="MethodHeader_description__3_p_p"><div class="MethodHeader_iconStyle__x5Ow4"><svg viewbox="0 0 18 6" xmlns="http://www.w3.org/2000/svg" class="IconRest_restIcon__3pju8 post"><title>Post</title><path d="M1.072 5.885V3.898c.026.006.069.011.129.017a3.88 3.88 0 0 0 .364.016h.125c.27 0 .533-.037.786-.11.253-.075.478-.193.677-.355.198-.162.357-.368.477-.618s.18-.551.18-.903c0-.401-.07-.727-.208-.977a1.592 1.592 0 0 0-.536-.585 1.971 1.971 0 0 0-.739-.28 4.854 4.854 0 0 0-.817-.07C1.249.033.987.045.724.07.46.095.219.13 0 .173v5.712h1.072Zm.461-2.934h-.098a2.344 2.344 0 0 1-.27-.017.818.818 0 0 1-.093-.016V1.047c.057-.011.133-.02.227-.03.093-.007.193-.012.297-.012.135 0 .268.014.399.042.13.027.246.077.348.148a.796.796 0 0 1 .246.284.954.954 0 0 1 .094.45c0 .214-.032.387-.098.519a.782.782 0 0 1-.262.309c-.11.074-.233.125-.371.152a2.141 2.141 0 0 1-.419.042ZM6.47 6c.694 0 1.212-.265 1.553-.795.342-.53.513-1.265.513-2.205 0-.44-.038-.843-.114-1.212a2.872 2.872 0 0 0-.36-.947 1.78 1.78 0 0 0-.637-.618C7.163.074 6.844 0 6.469 0c-.35 0-.653.069-.911.206a1.78 1.78 0 0 0-.645.59c-.172.255-.3.57-.384.943A5.804 5.804 0 0 0 4.404 3c0 .44.037.843.11 1.212.073.368.191.684.356.947.164.264.378.47.641.618.263.149.583.223.958.223Zm0-1.005c-.203 0-.366-.053-.489-.157a.989.989 0 0 1-.281-.425 2.57 2.57 0 0 1-.133-.63A8.129 8.129 0 0 1 5.53 3c0-.66.065-1.157.195-1.492.13-.335.378-.503.743-.503.209 0 .376.054.501.161a1 1 0 0 1 .286.433c.065.181.106.393.125.635.018.241.027.497.027.766 0 .34-.014.636-.043.886-.029.25-.08.457-.152.622a.826.826 0 0 1-.29.367.803.803 0 0 1-.454.12ZM10.991 6c.297 0 .574-.037.83-.111.255-.074.476-.187.664-.338.188-.151.334-.338.438-.56.104-.223.157-.483.157-.78 0-.307-.067-.563-.2-.766a1.814 1.814 0 0 0-.493-.507 3.3 3.3 0 0 0-.641-.342 11.165 11.165 0 0 1-.642-.28 2.185 2.185 0 0 1-.493-.313.562.562 0 0 1-.199-.445c0-.176.072-.316.215-.42.144-.105.34-.157.59-.157a2.757 2.757 0 0 1 .767.107.14.14 0 0 0 .047.008v.915h.86V.338a2.45 2.45 0 0 0-.735-.247C11.85.03 11.536 0 11.218 0c-.282 0-.537.041-.767.124-.23.082-.426.197-.59.346A1.557 1.557 0 0 0 9.476 1a1.66 1.66 0 0 0-.137.68c0 .324.067.588.2.792.133.203.297.372.493.506.195.135.409.246.641.334.232.088.446.176.642.264.195.088.36.19.492.305.133.115.2.266.2.453 0 .209-.081.375-.243.499-.161.123-.388.185-.68.185-.162 0-.314-.018-.458-.053a2.256 2.256 0 0 1-.395-.136l-.047-.017v-.816h-.86V5.53c.067.039.156.085.266.14.11.055.236.107.379.157.143.05.3.09.47.124.169.033.353.049.55.049Zm6.29-.115v-.907h-.885V1.022h.744v.997H18V.115h-4.287V2.02h.86v-.997h.752v3.956h-.892v.907h2.847Z"></path></svg></div> /v4/bitlinks/{bitlink}/qr</h4><p class="MethodHeader_description__3_p_p">Creates a QR code for existing Bitlink</p></div><div><h4 class="ParameterList_h4__nH9G8 ParameterList_dividing__wRGRx">Path Parameters</h4><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">bitlink</span><span class="Parameter_type__djM_s">string</span><span class="Parameter_required__pcK_H">Required</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">A Bitlink made of the domain and hash</div></div></div><div><h4 class="ParameterList_h4__nH9G8 ParameterList_dividing__wRGRx">Request Body Schema</h4><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">color</span><span class="Parameter_type__djM_s">string</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">A color denoted in hexadecimal format ei. "1133ff"</div></div><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">exclude_bitly_logo</span><span class="Parameter_type__djM_s">boolean</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">Removes the Bitly logo from the center of the generated QR image</div></div><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">image_format</span><span class="Parameter_type__djM_s">string</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">Determines the image format of the returned QR code</div><div class="Parameter_default__HHgG0 Parameter_spacer__JKXbH">Default: <span class="Parameter_label__DUY7G">"png"</span></div><div class="Parameter_enum__csO6P Parameter_spacer__JKXbH">Enum: <span class="Parameter_label__DUY7G">"png"</span><span class="Parameter_label__DUY7G">"svg"</span></div></div><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">logo_image_guid</span><span class="Parameter_type__djM_s">string</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">Logo must first be uploaded through Bitly's QR Code Modal located on the "All links" page. Once created, a call to "Retrieve a QR Code" with specified bitlink will return the auto-generated "logo_image_guid"</div></div></div></div><div class="MethodDetail_examples__8nXeM"><div><label class="CodeSyntaxSelector_header__6P_Jc CodeSyntaxSelector_headerDark__hI3A0"><span>Request</span><div class="Select_wrapper__58utF Select_dark__KPIws"><select class="Select_select__qXz_Z Select_dark__KPIws" aria-label="Select" autocomplete="off"><option value="cURL" selected="">cURL</option><option value="Node">Node</option><option value="Browser">Browser</option><option value="Go">Go</option><option value="Python">Python</option></select><svg viewbox="0 0 8 14" xmlns="http://www.w3.org/2000/svg"><path d="M6.463 7 .987 1.66a.61.61 0 0 1 0-.878.648.648 0 0 1 .9 0L7.813 6.56a.61.61 0 0 1 0 .878l-5.926 5.78a.648.648 0 0 1-.9 0 .61.61 0 0 1 0-.879L6.463 7Z"></path></svg></div></label><div class="CodeSyntaxSelector_body__hBJ7j CodeSyntaxSelector_bodyDark__cizVw" tabindex="0"><div class="CodeBlock_codeBlock__KlURa"><pre tabindex="0" style="color:#ffffff;font-family:ProximaNova, monospace;line-height:1.2;font-size:1rem"><code class="language-bash" style="white-space:pre"><span class="token token" style="color:#ee6123">curl</span><span> </span><span class="token token punctuation">\</span><span> </span><span>-H </span><span class="token token" style="color:#acda95">'Authorization: Bearer {TOKEN}'</span><span> </span><span class="token token punctuation">\</span><span> </span><span>-H </span><span class="token token" style="color:#acda95">'Content-Type: application/json'</span><span> </span><span class="token token punctuation">\</span><span> </span><span>-X POST </span><span class="token token punctuation">\</span><span> </span><span>-d </span><span class="token token" style="color:#acda95">'{ </span><span class="token token" style="color:#acda95"> "color": "1133ff", </span><span class="token token" style="color:#acda95"> "exclude_bitly_logo": true, </span><span class="token token" style="color:#acda95"> "image_format": "svg", </span><span class="token token" style="color:#acda95"> "logo_image_guid": "I123456789" </span><span class="token token" style="color:#acda95">}'</span><span> </span><span class="token token punctuation">\</span><span> </span>https://api-ssl.bitly.com/v4/bitlinks/bit.ly/12a4b6c/qr</code></pre></div></div></div><div><label class="CodeSyntaxSelector_header__6P_Jc"><span>Response</span><div class="Select_wrapper__58utF"><select class="Select_select__qXz_Z" aria-label="Select" autocomplete="off"><option value="201" selected="">201 CREATED</option><option value="400">400 BAD_REQUEST</option><option value="402">402 UPGRADE_REQUIRED</option><option value="403">403 FORBIDDEN</option><option value="404">404 NOT_FOUND</option><option value="410">410 GONE</option><option value="500">500 INTERNAL_ERROR</option></select><svg viewbox="0 0 8 14" xmlns="http://www.w3.org/2000/svg"><path d="M6.463 7 .987 1.66a.61.61 0 0 1 0-.878.648.648 0 0 1 .9 0L7.813 6.56a.61.61 0 0 1 0 .878l-5.926 5.78a.648.648 0 0 1-.9 0 .61.61 0 0 1 0-.879L6.463 7Z"></path></svg></div></label><div class="CodeSyntaxSelector_body__hBJ7j" tabindex="0"><div class="CodeBlock_codeBlock__KlURa"><pre tabindex="0" style="color:#36383b;font-family:ProximaNova, monospace;line-height:1.2;font-size:1rem"><code class="language-json" style="white-space:pre"><span class="token token punctuation">{</span><span> </span><span> </span><span class="token token property">"id"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"link"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"group_guid"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"customization"</span><span class="token token operator">:</span><span> </span><span class="token token punctuation">{</span><span> </span><span> </span><span class="token token property">"color"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"exclude_bitly_logo"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"boolean"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"image_format"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"logo_image_guid"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span> </span><span> </span><span class="token token punctuation">}</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"qr_code"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"logo_image_url"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"has_stored"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"boolean"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"created"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"modified"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span> </span><span></span><span class="token token punctuation">}</span></code></pre></div></div></div></div></div><div class="MethodDetail_methodContainer__3EF7h" id="expandBitlink"><div class="MethodDetail_method__fyEiw"><div><h3 class="MethodHeader_h3__seOfC">Expand a Bitlink</h3><h4 class="MethodHeader_description__3_p_p"><div class="MethodHeader_iconStyle__x5Ow4"><svg viewbox="0 0 18 6" xmlns="http://www.w3.org/2000/svg" class="IconRest_restIcon__3pju8 post"><title>Post</title><path d="M1.072 5.885V3.898c.026.006.069.011.129.017a3.88 3.88 0 0 0 .364.016h.125c.27 0 .533-.037.786-.11.253-.075.478-.193.677-.355.198-.162.357-.368.477-.618s.18-.551.18-.903c0-.401-.07-.727-.208-.977a1.592 1.592 0 0 0-.536-.585 1.971 1.971 0 0 0-.739-.28 4.854 4.854 0 0 0-.817-.07C1.249.033.987.045.724.07.46.095.219.13 0 .173v5.712h1.072Zm.461-2.934h-.098a2.344 2.344 0 0 1-.27-.017.818.818 0 0 1-.093-.016V1.047c.057-.011.133-.02.227-.03.093-.007.193-.012.297-.012.135 0 .268.014.399.042.13.027.246.077.348.148a.796.796 0 0 1 .246.284.954.954 0 0 1 .094.45c0 .214-.032.387-.098.519a.782.782 0 0 1-.262.309c-.11.074-.233.125-.371.152a2.141 2.141 0 0 1-.419.042ZM6.47 6c.694 0 1.212-.265 1.553-.795.342-.53.513-1.265.513-2.205 0-.44-.038-.843-.114-1.212a2.872 2.872 0 0 0-.36-.947 1.78 1.78 0 0 0-.637-.618C7.163.074 6.844 0 6.469 0c-.35 0-.653.069-.911.206a1.78 1.78 0 0 0-.645.59c-.172.255-.3.57-.384.943A5.804 5.804 0 0 0 4.404 3c0 .44.037.843.11 1.212.073.368.191.684.356.947.164.264.378.47.641.618.263.149.583.223.958.223Zm0-1.005c-.203 0-.366-.053-.489-.157a.989.989 0 0 1-.281-.425 2.57 2.57 0 0 1-.133-.63A8.129 8.129 0 0 1 5.53 3c0-.66.065-1.157.195-1.492.13-.335.378-.503.743-.503.209 0 .376.054.501.161a1 1 0 0 1 .286.433c.065.181.106.393.125.635.018.241.027.497.027.766 0 .34-.014.636-.043.886-.029.25-.08.457-.152.622a.826.826 0 0 1-.29.367.803.803 0 0 1-.454.12ZM10.991 6c.297 0 .574-.037.83-.111.255-.074.476-.187.664-.338.188-.151.334-.338.438-.56.104-.223.157-.483.157-.78 0-.307-.067-.563-.2-.766a1.814 1.814 0 0 0-.493-.507 3.3 3.3 0 0 0-.641-.342 11.165 11.165 0 0 1-.642-.28 2.185 2.185 0 0 1-.493-.313.562.562 0 0 1-.199-.445c0-.176.072-.316.215-.42.144-.105.34-.157.59-.157a2.757 2.757 0 0 1 .767.107.14.14 0 0 0 .047.008v.915h.86V.338a2.45 2.45 0 0 0-.735-.247C11.85.03 11.536 0 11.218 0c-.282 0-.537.041-.767.124-.23.082-.426.197-.59.346A1.557 1.557 0 0 0 9.476 1a1.66 1.66 0 0 0-.137.68c0 .324.067.588.2.792.133.203.297.372.493.506.195.135.409.246.641.334.232.088.446.176.642.264.195.088.36.19.492.305.133.115.2.266.2.453 0 .209-.081.375-.243.499-.161.123-.388.185-.68.185-.162 0-.314-.018-.458-.053a2.256 2.256 0 0 1-.395-.136l-.047-.017v-.816h-.86V5.53c.067.039.156.085.266.14.11.055.236.107.379.157.143.05.3.09.47.124.169.033.353.049.55.049Zm6.29-.115v-.907h-.885V1.022h.744v.997H18V.115h-4.287V2.02h.86v-.997h.752v3.956h-.892v.907h2.847Z"></path></svg></div> /v4/expand</h4><p class="MethodHeader_description__3_p_p">Returns the short link and long URL for the specified link.</p></div><div><h4 class="ParameterList_h4__nH9G8 ParameterList_dividing__wRGRx">Request Body Schema</h4><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">bitlink_id</span><span class="Parameter_type__djM_s">string</span></div></div></div></div><div class="MethodDetail_examples__8nXeM"><div><label class="CodeSyntaxSelector_header__6P_Jc CodeSyntaxSelector_headerDark__hI3A0"><span>Request</span><div class="Select_wrapper__58utF Select_dark__KPIws"><select class="Select_select__qXz_Z Select_dark__KPIws" aria-label="Select" autocomplete="off"><option value="cURL" selected="">cURL</option><option value="Node">Node</option><option value="Browser">Browser</option><option value="Go">Go</option><option value="Python">Python</option></select><svg viewbox="0 0 8 14" xmlns="http://www.w3.org/2000/svg"><path d="M6.463 7 .987 1.66a.61.61 0 0 1 0-.878.648.648 0 0 1 .9 0L7.813 6.56a.61.61 0 0 1 0 .878l-5.926 5.78a.648.648 0 0 1-.9 0 .61.61 0 0 1 0-.879L6.463 7Z"></path></svg></div></label><div class="CodeSyntaxSelector_body__hBJ7j CodeSyntaxSelector_bodyDark__cizVw" tabindex="0"><div class="CodeBlock_codeBlock__KlURa"><pre tabindex="0" style="color:#ffffff;font-family:ProximaNova, monospace;line-height:1.2;font-size:1rem"><code class="language-bash" style="white-space:pre"><span class="token token" style="color:#ee6123">curl</span><span> </span><span class="token token punctuation">\</span><span> </span><span>-H </span><span class="token token" style="color:#acda95">'Authorization: Bearer {TOKEN}'</span><span> </span><span class="token token punctuation">\</span><span> </span><span>-H </span><span class="token token" style="color:#acda95">'Content-Type: application/json'</span><span> </span><span class="token token punctuation">\</span><span> </span><span>-X POST </span><span class="token token punctuation">\</span><span> </span><span>-d </span><span class="token token" style="color:#acda95">'{ </span><span class="token token" style="color:#acda95"> "bitlink_id": "bit.ly/12a4b6c" </span><span class="token token" style="color:#acda95">}'</span><span> </span><span class="token token punctuation">\</span><span> </span>https://api-ssl.bitly.com/v4/expand</code></pre></div></div></div><div><label class="CodeSyntaxSelector_header__6P_Jc"><span>Response</span><div class="Select_wrapper__58utF"><select class="Select_select__qXz_Z" aria-label="Select" autocomplete="off"><option value="200" selected="">200 SUCCESS</option><option value="400">400 BAD_REQUEST</option><option value="404">404 NOT_FOUND</option><option value="410">410 GONE</option><option value="422">422 UNPROCESSABLE_ENTITY</option><option value="500">500 INTERNAL_ERROR</option><option value="503">503 TEMPORARILY_UNAVAILABLE</option></select><svg viewbox="0 0 8 14" xmlns="http://www.w3.org/2000/svg"><path d="M6.463 7 .987 1.66a.61.61 0 0 1 0-.878.648.648 0 0 1 .9 0L7.813 6.56a.61.61 0 0 1 0 .878l-5.926 5.78a.648.648 0 0 1-.9 0 .61.61 0 0 1 0-.879L6.463 7Z"></path></svg></div></label><div class="CodeSyntaxSelector_body__hBJ7j" tabindex="0"><div class="CodeBlock_codeBlock__KlURa"><pre tabindex="0" style="color:#36383b;font-family:ProximaNova, monospace;line-height:1.2;font-size:1rem"><code class="language-json" style="white-space:pre"><span class="token token punctuation">{</span><span> </span><span> </span><span class="token token property">"link"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"id"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"long_url"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"created_at"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span> </span><span></span><span class="token token punctuation">}</span></code></pre></div></div></div></div></div><div class="MethodDetail_methodContainer__3EF7h" id="getClicksForBitlink"><div class="MethodDetail_method__fyEiw"><div><h3 class="MethodHeader_h3__seOfC">Get Clicks for a Bitlink</h3><h4 class="MethodHeader_description__3_p_p"><div class="MethodHeader_iconStyle__x5Ow4"><svg viewbox="0 0 14 6" xmlns="http://www.w3.org/2000/svg" class="IconRest_restIcon__3pju8 get"><title>Get</title><path d="M2.587 6c.307 0 .607-.044.9-.132.295-.088.533-.217.716-.387V2.876H2.271v.825h1.027v1.145a.772.772 0 0 1-.239.1 1.4 1.4 0 0 1-.383.049 1.338 1.338 0 0 1-1.083-.52c-.135-.17-.24-.379-.316-.626a2.879 2.879 0 0 1-.113-.84c0-.352.038-.655.113-.907.076-.253.182-.46.32-.623.137-.162.3-.281.488-.358a1.783 1.783 0 0 1 .97-.082l.13.032v.915h.889V.28a3.182 3.182 0 0 0-.59-.202A3.507 3.507 0 0 0 2.676 0c-.313 0-.628.055-.946.165a2.4 2.4 0 0 0-.861.523 2.707 2.707 0 0 0-.627.92C.081 1.98 0 2.433 0 2.966c0 .506.067.946.202 1.323.135.376.318.692.55.948a2.2 2.2 0 0 0 .82.572A2.7 2.7 0 0 0 2.587 6Zm6.24-.115V4.879H6.184V3.47h2.4V2.465h-2.4V1.121h2.602V.115h-3.71v5.77h3.75Zm4.43 0v-.907h-.914V1.022h.768v.997H14V.115H9.57V2.02h.89v-.997h.776v3.956h-.922v.907h2.942Z"></path></svg></div> /v4/bitlinks/{bitlink}/clicks</h4><p class="MethodHeader_description__3_p_p">Returns the click counts for the specified link in an array based on a date.</p></div><div><h4 class="ParameterList_h4__nH9G8 ParameterList_dividing__wRGRx">Path Parameters</h4><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">bitlink</span><span class="Parameter_type__djM_s">string</span><span class="Parameter_required__pcK_H">Required</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">A Bitlink made of the domain and hash</div></div></div><div><h4 class="ParameterList_h4__nH9G8 ParameterList_dividing__wRGRx">Query Parameters</h4><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">unit</span><span class="Parameter_type__djM_s">string</span><span class="Parameter_required__pcK_H">Required</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">A unit of time</div><div class="Parameter_default__HHgG0 Parameter_spacer__JKXbH">Default: <span class="Parameter_label__DUY7G">"day"</span></div><div class="Parameter_enum__csO6P Parameter_spacer__JKXbH">Enum: <span class="Parameter_label__DUY7G">"minute"</span><span class="Parameter_label__DUY7G">"hour"</span><span class="Parameter_label__DUY7G">"day"</span><span class="Parameter_label__DUY7G">"week"</span><span class="Parameter_label__DUY7G">"month"</span></div></div><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">units</span><span class="Parameter_type__djM_s">integer</span><span class="Parameter_required__pcK_H">Required</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">An integer representing the time units to query data for. pass -1 to return all units of time.</div><div class="Parameter_default__HHgG0 Parameter_spacer__JKXbH">Default: <span class="Parameter_label__DUY7G">-1</span></div></div><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">unit_reference</span><span class="Parameter_type__djM_s">string</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">An ISO-8601 timestamp, indicating the most recent time for which to pull metrics. Will default to current time. Timestamp values should be url encoded (i.e. replace '+' with '%2B' and ':' with '%3A'; 2022-02-02T15:53:02+0000 becomes 2022-02-02T15%3A53%3A02%2B0000)</div></div></div></div><div class="MethodDetail_examples__8nXeM"><div><label class="CodeSyntaxSelector_header__6P_Jc CodeSyntaxSelector_headerDark__hI3A0"><span>Request</span><div class="Select_wrapper__58utF Select_dark__KPIws"><select class="Select_select__qXz_Z Select_dark__KPIws" aria-label="Select" autocomplete="off"><option value="cURL" selected="">cURL</option><option value="Node">Node</option><option value="Browser">Browser</option><option value="Go">Go</option><option value="Python">Python</option></select><svg viewbox="0 0 8 14" xmlns="http://www.w3.org/2000/svg"><path d="M6.463 7 .987 1.66a.61.61 0 0 1 0-.878.648.648 0 0 1 .9 0L7.813 6.56a.61.61 0 0 1 0 .878l-5.926 5.78a.648.648 0 0 1-.9 0 .61.61 0 0 1 0-.879L6.463 7Z"></path></svg></div></label><div class="CodeSyntaxSelector_body__hBJ7j CodeSyntaxSelector_bodyDark__cizVw" tabindex="0"><div class="CodeBlock_codeBlock__KlURa"><pre tabindex="0" style="color:#ffffff;font-family:ProximaNova, monospace;line-height:1.2;font-size:1rem"><code class="language-bash" style="white-space:pre"><span class="token token" style="color:#ee6123">curl</span><span> </span><span class="token token punctuation">\</span><span> </span><span>-H </span><span class="token token" style="color:#acda95">'Authorization: Bearer {TOKEN}'</span><span> </span><span class="token token punctuation">\</span><span> </span><span>-X GET </span><span class="token token punctuation">\</span><span> </span><span>https://api-ssl.bitly.com/v4/bitlinks/bit.ly/12a4b6c/clicks?unit</span><span class="token token operator">=</span><span>month</span><span class="token token operator">&</span><span class="token token assign-left variable">units</span><span class="token token operator">=</span><span class="token token" style="color:#a1b8f3">5</span><span class="token token operator">&</span><span class="token token assign-left variable">unit_reference</span><span class="token token operator">=</span><span class="token token" style="color:#a1b8f3">2006</span><span>-01-02T15%3A04%3A05-0700</span></code></pre></div></div></div><div><label class="CodeSyntaxSelector_header__6P_Jc"><span>Response</span><div class="Select_wrapper__58utF"><select class="Select_select__qXz_Z" aria-label="Select" autocomplete="off"><option value="200" selected="">200 SUCCESS</option><option value="403">403 FORBIDDEN</option><option value="404">404 NOT_FOUND</option><option value="500">500 INTERNAL_ERROR</option><option value="503">503 TEMPORARILY_UNAVAILABLE</option></select><svg viewbox="0 0 8 14" xmlns="http://www.w3.org/2000/svg"><path d="M6.463 7 .987 1.66a.61.61 0 0 1 0-.878.648.648 0 0 1 .9 0L7.813 6.56a.61.61 0 0 1 0 .878l-5.926 5.78a.648.648 0 0 1-.9 0 .61.61 0 0 1 0-.879L6.463 7Z"></path></svg></div></label><div class="CodeSyntaxSelector_body__hBJ7j" tabindex="0"><div class="CodeBlock_codeBlock__KlURa"><pre tabindex="0" style="color:#36383b;font-family:ProximaNova, monospace;line-height:1.2;font-size:1rem"><code class="language-json" style="white-space:pre"><span class="token token punctuation">{</span><span> </span><span> </span><span class="token token property">"link_clicks"</span><span class="token token operator">:</span><span> </span><span class="token token punctuation">[</span><span> </span><span> </span><span class="token token punctuation">{</span><span> </span><span> </span><span class="token token property">"clicks"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"integer"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"date"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span> </span><span> </span><span class="token token punctuation">}</span><span> </span><span> </span><span class="token token punctuation">]</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"units"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"integer"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"unit"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"unit_reference"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span> </span><span></span><span class="token token punctuation">}</span></code></pre></div></div></div></div></div><div class="MethodDetail_methodContainer__3EF7h" id="getClicksSummaryForBitlink"><div class="MethodDetail_method__fyEiw"><div><h3 class="MethodHeader_h3__seOfC">Get a Clicks Summary for a Bitlink</h3><h4 class="MethodHeader_description__3_p_p"><div class="MethodHeader_iconStyle__x5Ow4"><svg viewbox="0 0 14 6" xmlns="http://www.w3.org/2000/svg" class="IconRest_restIcon__3pju8 get"><title>Get</title><path d="M2.587 6c.307 0 .607-.044.9-.132.295-.088.533-.217.716-.387V2.876H2.271v.825h1.027v1.145a.772.772 0 0 1-.239.1 1.4 1.4 0 0 1-.383.049 1.338 1.338 0 0 1-1.083-.52c-.135-.17-.24-.379-.316-.626a2.879 2.879 0 0 1-.113-.84c0-.352.038-.655.113-.907.076-.253.182-.46.32-.623.137-.162.3-.281.488-.358a1.783 1.783 0 0 1 .97-.082l.13.032v.915h.889V.28a3.182 3.182 0 0 0-.59-.202A3.507 3.507 0 0 0 2.676 0c-.313 0-.628.055-.946.165a2.4 2.4 0 0 0-.861.523 2.707 2.707 0 0 0-.627.92C.081 1.98 0 2.433 0 2.966c0 .506.067.946.202 1.323.135.376.318.692.55.948a2.2 2.2 0 0 0 .82.572A2.7 2.7 0 0 0 2.587 6Zm6.24-.115V4.879H6.184V3.47h2.4V2.465h-2.4V1.121h2.602V.115h-3.71v5.77h3.75Zm4.43 0v-.907h-.914V1.022h.768v.997H14V.115H9.57V2.02h.89v-.997h.776v3.956h-.922v.907h2.942Z"></path></svg></div> /v4/bitlinks/{bitlink}/clicks/summary</h4><p class="MethodHeader_description__3_p_p">Returns the click counts for the specified link rolled up into a single field.</p></div><div><h4 class="ParameterList_h4__nH9G8 ParameterList_dividing__wRGRx">Path Parameters</h4><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">bitlink</span><span class="Parameter_type__djM_s">string</span><span class="Parameter_required__pcK_H">Required</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">A Bitlink made of the domain and hash</div></div></div><div><h4 class="ParameterList_h4__nH9G8 ParameterList_dividing__wRGRx">Query Parameters</h4><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">unit</span><span class="Parameter_type__djM_s">string</span><span class="Parameter_required__pcK_H">Required</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">A unit of time</div><div class="Parameter_default__HHgG0 Parameter_spacer__JKXbH">Default: <span class="Parameter_label__DUY7G">"day"</span></div><div class="Parameter_enum__csO6P Parameter_spacer__JKXbH">Enum: <span class="Parameter_label__DUY7G">"minute"</span><span class="Parameter_label__DUY7G">"hour"</span><span class="Parameter_label__DUY7G">"day"</span><span class="Parameter_label__DUY7G">"week"</span><span class="Parameter_label__DUY7G">"month"</span></div></div><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">units</span><span class="Parameter_type__djM_s">integer</span><span class="Parameter_required__pcK_H">Required</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">An integer representing the time units to query data for. pass -1 to return all units of time.</div><div class="Parameter_default__HHgG0 Parameter_spacer__JKXbH">Default: <span class="Parameter_label__DUY7G">-1</span></div></div><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">unit_reference</span><span class="Parameter_type__djM_s">string</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">An ISO-8601 timestamp, indicating the most recent time for which to pull metrics. Will default to current time. Timestamp values should be url encoded (i.e. replace '+' with '%2B' and ':' with '%3A'; 2022-02-02T15:53:02+0000 becomes 2022-02-02T15%3A53%3A02%2B0000)</div></div></div></div><div class="MethodDetail_examples__8nXeM"><div><label class="CodeSyntaxSelector_header__6P_Jc CodeSyntaxSelector_headerDark__hI3A0"><span>Request</span><div class="Select_wrapper__58utF Select_dark__KPIws"><select class="Select_select__qXz_Z Select_dark__KPIws" aria-label="Select" autocomplete="off"><option value="cURL" selected="">cURL</option><option value="Node">Node</option><option value="Browser">Browser</option><option value="Go">Go</option><option value="Python">Python</option></select><svg viewbox="0 0 8 14" xmlns="http://www.w3.org/2000/svg"><path d="M6.463 7 .987 1.66a.61.61 0 0 1 0-.878.648.648 0 0 1 .9 0L7.813 6.56a.61.61 0 0 1 0 .878l-5.926 5.78a.648.648 0 0 1-.9 0 .61.61 0 0 1 0-.879L6.463 7Z"></path></svg></div></label><div class="CodeSyntaxSelector_body__hBJ7j CodeSyntaxSelector_bodyDark__cizVw" tabindex="0"><div class="CodeBlock_codeBlock__KlURa"><pre tabindex="0" style="color:#ffffff;font-family:ProximaNova, monospace;line-height:1.2;font-size:1rem"><code class="language-bash" style="white-space:pre"><span class="token token" style="color:#ee6123">curl</span><span> </span><span class="token token punctuation">\</span><span> </span><span>-H </span><span class="token token" style="color:#acda95">'Authorization: Bearer {TOKEN}'</span><span> </span><span class="token token punctuation">\</span><span> </span><span>-X GET </span><span class="token token punctuation">\</span><span> </span><span>https://api-ssl.bitly.com/v4/bitlinks/bit.ly/12a4b6c/clicks/summary?unit</span><span class="token token operator">=</span><span>month</span><span class="token token operator">&</span><span class="token token assign-left variable">units</span><span class="token token operator">=</span><span class="token token" style="color:#a1b8f3">5</span><span class="token token operator">&</span><span class="token token assign-left variable">unit_reference</span><span class="token token operator">=</span><span class="token token" style="color:#a1b8f3">2006</span><span>-01-02T15%3A04%3A05-0700</span></code></pre></div></div></div><div><label class="CodeSyntaxSelector_header__6P_Jc"><span>Response</span><div class="Select_wrapper__58utF"><select class="Select_select__qXz_Z" aria-label="Select" autocomplete="off"><option value="200" selected="">200 SUCCESS</option><option value="403">403 FORBIDDEN</option><option value="404">404 NOT_FOUND</option><option value="500">500 INTERNAL_ERROR</option><option value="503">503 TEMPORARILY_UNAVAILABLE</option></select><svg viewbox="0 0 8 14" xmlns="http://www.w3.org/2000/svg"><path d="M6.463 7 .987 1.66a.61.61 0 0 1 0-.878.648.648 0 0 1 .9 0L7.813 6.56a.61.61 0 0 1 0 .878l-5.926 5.78a.648.648 0 0 1-.9 0 .61.61 0 0 1 0-.879L6.463 7Z"></path></svg></div></label><div class="CodeSyntaxSelector_body__hBJ7j" tabindex="0"><div class="CodeBlock_codeBlock__KlURa"><pre tabindex="0" style="color:#36383b;font-family:ProximaNova, monospace;line-height:1.2;font-size:1rem"><code class="language-json" style="white-space:pre"><span class="token token punctuation">{</span><span> </span><span> </span><span class="token token property">"total_clicks"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"integer"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"units"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"integer"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"unit"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"unit_reference"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span> </span><span></span><span class="token token punctuation">}</span></code></pre></div></div></div></div></div><div class="MethodDetail_methodContainer__3EF7h" id="getMetricsForBitlinkByCountries"><div class="MethodDetail_method__fyEiw"><div><h3 class="MethodHeader_h3__seOfC">Get Metrics for a Bitlink by Country</h3><h4 class="MethodHeader_description__3_p_p"><div class="MethodHeader_iconStyle__x5Ow4"><svg viewbox="0 0 14 6" xmlns="http://www.w3.org/2000/svg" class="IconRest_restIcon__3pju8 get"><title>Get</title><path d="M2.587 6c.307 0 .607-.044.9-.132.295-.088.533-.217.716-.387V2.876H2.271v.825h1.027v1.145a.772.772 0 0 1-.239.1 1.4 1.4 0 0 1-.383.049 1.338 1.338 0 0 1-1.083-.52c-.135-.17-.24-.379-.316-.626a2.879 2.879 0 0 1-.113-.84c0-.352.038-.655.113-.907.076-.253.182-.46.32-.623.137-.162.3-.281.488-.358a1.783 1.783 0 0 1 .97-.082l.13.032v.915h.889V.28a3.182 3.182 0 0 0-.59-.202A3.507 3.507 0 0 0 2.676 0c-.313 0-.628.055-.946.165a2.4 2.4 0 0 0-.861.523 2.707 2.707 0 0 0-.627.92C.081 1.98 0 2.433 0 2.966c0 .506.067.946.202 1.323.135.376.318.692.55.948a2.2 2.2 0 0 0 .82.572A2.7 2.7 0 0 0 2.587 6Zm6.24-.115V4.879H6.184V3.47h2.4V2.465h-2.4V1.121h2.602V.115h-3.71v5.77h3.75Zm4.43 0v-.907h-.914V1.022h.768v.997H14V.115H9.57V2.02h.89v-.997h.776v3.956h-.922v.907h2.942Z"></path></svg></div> /v4/bitlinks/{bitlink}/countries</h4><p class="MethodHeader_description__3_p_p">Returns the country origins of click traffic for the specified link.</p></div><div><h4 class="ParameterList_h4__nH9G8 ParameterList_dividing__wRGRx">Path Parameters</h4><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">bitlink</span><span class="Parameter_type__djM_s">string</span><span class="Parameter_required__pcK_H">Required</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">A Bitlink made of the domain and hash</div></div></div><div><h4 class="ParameterList_h4__nH9G8 ParameterList_dividing__wRGRx">Query Parameters</h4><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">unit</span><span class="Parameter_type__djM_s">string</span><span class="Parameter_required__pcK_H">Required</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">A unit of time</div><div class="Parameter_default__HHgG0 Parameter_spacer__JKXbH">Default: <span class="Parameter_label__DUY7G">"day"</span></div><div class="Parameter_enum__csO6P Parameter_spacer__JKXbH">Enum: <span class="Parameter_label__DUY7G">"minute"</span><span class="Parameter_label__DUY7G">"hour"</span><span class="Parameter_label__DUY7G">"day"</span><span class="Parameter_label__DUY7G">"week"</span><span class="Parameter_label__DUY7G">"month"</span></div></div><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">units</span><span class="Parameter_type__djM_s">integer</span><span class="Parameter_required__pcK_H">Required</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">An integer representing the time units to query data for. pass -1 to return all units of time.</div><div class="Parameter_default__HHgG0 Parameter_spacer__JKXbH">Default: <span class="Parameter_label__DUY7G">-1</span></div></div><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">size</span><span class="Parameter_type__djM_s">integer</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">The quantity of items to be be returned</div><div class="Parameter_default__HHgG0 Parameter_spacer__JKXbH">Default: <span class="Parameter_label__DUY7G">50</span></div></div><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">unit_reference</span><span class="Parameter_type__djM_s">string</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">An ISO-8601 timestamp, indicating the most recent time for which to pull metrics. Will default to current time. Timestamp values should be url encoded (i.e. replace '+' with '%2B' and ':' with '%3A'; 2022-02-02T15:53:02+0000 becomes 2022-02-02T15%3A53%3A02%2B0000)</div></div></div></div><div class="MethodDetail_examples__8nXeM"><div><label class="CodeSyntaxSelector_header__6P_Jc CodeSyntaxSelector_headerDark__hI3A0"><span>Request</span><div class="Select_wrapper__58utF Select_dark__KPIws"><select class="Select_select__qXz_Z Select_dark__KPIws" aria-label="Select" autocomplete="off"><option value="cURL" selected="">cURL</option><option value="Node">Node</option><option value="Browser">Browser</option><option value="Go">Go</option><option value="Python">Python</option></select><svg viewbox="0 0 8 14" xmlns="http://www.w3.org/2000/svg"><path d="M6.463 7 .987 1.66a.61.61 0 0 1 0-.878.648.648 0 0 1 .9 0L7.813 6.56a.61.61 0 0 1 0 .878l-5.926 5.78a.648.648 0 0 1-.9 0 .61.61 0 0 1 0-.879L6.463 7Z"></path></svg></div></label><div class="CodeSyntaxSelector_body__hBJ7j CodeSyntaxSelector_bodyDark__cizVw" tabindex="0"><div class="CodeBlock_codeBlock__KlURa"><pre tabindex="0" style="color:#ffffff;font-family:ProximaNova, monospace;line-height:1.2;font-size:1rem"><code class="language-bash" style="white-space:pre"><span class="token token" style="color:#ee6123">curl</span><span> </span><span class="token token punctuation">\</span><span> </span><span>-H </span><span class="token token" style="color:#acda95">'Authorization: Bearer {TOKEN}'</span><span> </span><span class="token token punctuation">\</span><span> </span><span>-X GET </span><span class="token token punctuation">\</span><span> </span><span>https://api-ssl.bitly.com/v4/bitlinks/bit.ly/12a4b6c/countries?unit</span><span class="token token operator">=</span><span>month</span><span class="token token operator">&</span><span class="token token assign-left variable">units</span><span class="token token operator">=</span><span class="token token" style="color:#a1b8f3">5</span><span class="token token operator">&</span><span class="token token assign-left variable">size</span><span class="token token operator">=</span><span class="token token" style="color:#a1b8f3">10</span><span class="token token operator">&</span><span class="token token assign-left variable">unit_reference</span><span class="token token operator">=</span><span class="token token" style="color:#a1b8f3">2006</span><span>-01-02T15%3A04%3A05-0700</span></code></pre></div></div></div><div><label class="CodeSyntaxSelector_header__6P_Jc"><span>Response</span><div class="Select_wrapper__58utF"><select class="Select_select__qXz_Z" aria-label="Select" autocomplete="off"><option value="200" selected="">200 SUCCESS</option><option value="400">400 BAD_REQUEST</option><option value="403">403 FORBIDDEN</option><option value="404">404 NOT_FOUND</option><option value="410">410 GONE</option><option value="500">500 INTERNAL_ERROR</option><option value="503">503 TEMPORARILY_UNAVAILABLE</option></select><svg viewbox="0 0 8 14" xmlns="http://www.w3.org/2000/svg"><path d="M6.463 7 .987 1.66a.61.61 0 0 1 0-.878.648.648 0 0 1 .9 0L7.813 6.56a.61.61 0 0 1 0 .878l-5.926 5.78a.648.648 0 0 1-.9 0 .61.61 0 0 1 0-.879L6.463 7Z"></path></svg></div></label><div class="CodeSyntaxSelector_body__hBJ7j" tabindex="0"><div class="Response_formatSelect__Wt_qa"><div class="ButtonToggle_buttonToggle__6YJhd"><label class="ButtonToggle_label__ohGaG"><input class="ButtonToggle_input__vkfUm" name="getMetricsForBitlinkByCountries" type="radio" checked=""/><span>json</span></label><label class="ButtonToggle_label__ohGaG"><input class="ButtonToggle_input__vkfUm" name="getMetricsForBitlinkByCountries" type="radio"/><span>csv</span></label></div></div><div class="CodeBlock_codeBlock__KlURa"><pre tabindex="0" style="color:#36383b;font-family:ProximaNova, monospace;line-height:1.2;font-size:1rem"><code class="language-json" style="white-space:pre"><span class="token token punctuation">{</span><span> </span><span> </span><span class="token token property">"unit"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"units"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"integer"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"facet"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"unit_reference"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"metrics"</span><span class="token token operator">:</span><span> </span><span class="token token punctuation">[</span><span> </span><span> </span><span class="token token punctuation">{</span><span> </span><span> </span><span class="token token property">"clicks"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"integer"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"value"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span> </span><span> </span><span class="token token punctuation">}</span><span> </span><span> </span><span class="token token punctuation">]</span><span> </span><span></span><span class="token token punctuation">}</span></code></pre></div></div></div></div></div><div class="MethodDetail_methodContainer__3EF7h" id="getMetricsForBitlinkByCities"><div class="MethodDetail_method__fyEiw"><div><h3 class="MethodHeader_h3__seOfC">Get Metrics for a Bitlink by City</h3><h4 class="MethodHeader_description__3_p_p"><div class="MethodHeader_iconStyle__x5Ow4"><svg viewbox="0 0 14 6" xmlns="http://www.w3.org/2000/svg" class="IconRest_restIcon__3pju8 get"><title>Get</title><path d="M2.587 6c.307 0 .607-.044.9-.132.295-.088.533-.217.716-.387V2.876H2.271v.825h1.027v1.145a.772.772 0 0 1-.239.1 1.4 1.4 0 0 1-.383.049 1.338 1.338 0 0 1-1.083-.52c-.135-.17-.24-.379-.316-.626a2.879 2.879 0 0 1-.113-.84c0-.352.038-.655.113-.907.076-.253.182-.46.32-.623.137-.162.3-.281.488-.358a1.783 1.783 0 0 1 .97-.082l.13.032v.915h.889V.28a3.182 3.182 0 0 0-.59-.202A3.507 3.507 0 0 0 2.676 0c-.313 0-.628.055-.946.165a2.4 2.4 0 0 0-.861.523 2.707 2.707 0 0 0-.627.92C.081 1.98 0 2.433 0 2.966c0 .506.067.946.202 1.323.135.376.318.692.55.948a2.2 2.2 0 0 0 .82.572A2.7 2.7 0 0 0 2.587 6Zm6.24-.115V4.879H6.184V3.47h2.4V2.465h-2.4V1.121h2.602V.115h-3.71v5.77h3.75Zm4.43 0v-.907h-.914V1.022h.768v.997H14V.115H9.57V2.02h.89v-.997h.776v3.956h-.922v.907h2.942Z"></path></svg></div> /v4/bitlinks/{bitlink}/cities</h4><p class="MethodHeader_description__3_p_p">Returns the city origins of click traffic for the specified link.</p></div><div><h4 class="ParameterList_h4__nH9G8 ParameterList_dividing__wRGRx">Path Parameters</h4><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">bitlink</span><span class="Parameter_type__djM_s">string</span><span class="Parameter_required__pcK_H">Required</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">A Bitlink made of the domain and hash</div></div></div><div><h4 class="ParameterList_h4__nH9G8 ParameterList_dividing__wRGRx">Query Parameters</h4><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">unit</span><span class="Parameter_type__djM_s">string</span><span class="Parameter_required__pcK_H">Required</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">A unit of time</div><div class="Parameter_default__HHgG0 Parameter_spacer__JKXbH">Default: <span class="Parameter_label__DUY7G">"day"</span></div><div class="Parameter_enum__csO6P Parameter_spacer__JKXbH">Enum: <span class="Parameter_label__DUY7G">"minute"</span><span class="Parameter_label__DUY7G">"hour"</span><span class="Parameter_label__DUY7G">"day"</span><span class="Parameter_label__DUY7G">"week"</span><span class="Parameter_label__DUY7G">"month"</span></div></div><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">units</span><span class="Parameter_type__djM_s">integer</span><span class="Parameter_required__pcK_H">Required</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">An integer representing the time units to query data for. pass -1 to return all units of time.</div><div class="Parameter_default__HHgG0 Parameter_spacer__JKXbH">Default: <span class="Parameter_label__DUY7G">-1</span></div></div><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">size</span><span class="Parameter_type__djM_s">integer</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">The quantity of items to be be returned</div><div class="Parameter_default__HHgG0 Parameter_spacer__JKXbH">Default: <span class="Parameter_label__DUY7G">50</span></div></div><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">unit_reference</span><span class="Parameter_type__djM_s">string</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">An ISO-8601 timestamp, indicating the most recent time for which to pull metrics. Will default to current time. Timestamp values should be url encoded (i.e. replace '+' with '%2B' and ':' with '%3A'; 2022-02-02T15:53:02+0000 becomes 2022-02-02T15%3A53%3A02%2B0000)</div></div></div></div><div class="MethodDetail_examples__8nXeM"><div><label class="CodeSyntaxSelector_header__6P_Jc CodeSyntaxSelector_headerDark__hI3A0"><span>Request</span><div class="Select_wrapper__58utF Select_dark__KPIws"><select class="Select_select__qXz_Z Select_dark__KPIws" aria-label="Select" autocomplete="off"><option value="cURL" selected="">cURL</option><option value="Node">Node</option><option value="Browser">Browser</option><option value="Go">Go</option><option value="Python">Python</option></select><svg viewbox="0 0 8 14" xmlns="http://www.w3.org/2000/svg"><path d="M6.463 7 .987 1.66a.61.61 0 0 1 0-.878.648.648 0 0 1 .9 0L7.813 6.56a.61.61 0 0 1 0 .878l-5.926 5.78a.648.648 0 0 1-.9 0 .61.61 0 0 1 0-.879L6.463 7Z"></path></svg></div></label><div class="CodeSyntaxSelector_body__hBJ7j CodeSyntaxSelector_bodyDark__cizVw" tabindex="0"><div class="CodeBlock_codeBlock__KlURa"><pre tabindex="0" style="color:#ffffff;font-family:ProximaNova, monospace;line-height:1.2;font-size:1rem"><code class="language-bash" style="white-space:pre"><span class="token token" style="color:#ee6123">curl</span><span> </span><span class="token token punctuation">\</span><span> </span><span>-H </span><span class="token token" style="color:#acda95">'Authorization: Bearer {TOKEN}'</span><span> </span><span class="token token punctuation">\</span><span> </span><span>-X GET </span><span class="token token punctuation">\</span><span> </span><span>https://api-ssl.bitly.com/v4/bitlinks/bit.ly/12a4b6c/cities?unit</span><span class="token token operator">=</span><span>month</span><span class="token token operator">&</span><span class="token token assign-left variable">units</span><span class="token token operator">=</span><span class="token token" style="color:#a1b8f3">5</span><span class="token token operator">&</span><span class="token token assign-left variable">size</span><span class="token token operator">=</span><span class="token token" style="color:#a1b8f3">10</span><span class="token token operator">&</span><span class="token token assign-left variable">unit_reference</span><span class="token token operator">=</span><span class="token token" style="color:#a1b8f3">2006</span><span>-01-02T15%3A04%3A05-0700</span></code></pre></div></div></div><div><label class="CodeSyntaxSelector_header__6P_Jc"><span>Response</span><div class="Select_wrapper__58utF"><select class="Select_select__qXz_Z" aria-label="Select" autocomplete="off"><option value="200" selected="">200 SUCCESS</option><option value="400">400 BAD_REQUEST</option><option value="402">402 UPGRADE_REQUIRED</option><option value="403">403 FORBIDDEN</option><option value="404">404 NOT_FOUND</option><option value="410">410 GONE</option><option value="500">500 INTERNAL_ERROR</option><option value="503">503 TEMPORARILY_UNAVAILABLE</option></select><svg viewbox="0 0 8 14" xmlns="http://www.w3.org/2000/svg"><path d="M6.463 7 .987 1.66a.61.61 0 0 1 0-.878.648.648 0 0 1 .9 0L7.813 6.56a.61.61 0 0 1 0 .878l-5.926 5.78a.648.648 0 0 1-.9 0 .61.61 0 0 1 0-.879L6.463 7Z"></path></svg></div></label><div class="CodeSyntaxSelector_body__hBJ7j" tabindex="0"><div class="Response_formatSelect__Wt_qa"><div class="ButtonToggle_buttonToggle__6YJhd"><label class="ButtonToggle_label__ohGaG"><input class="ButtonToggle_input__vkfUm" name="getMetricsForBitlinkByCities" type="radio" checked=""/><span>json</span></label><label class="ButtonToggle_label__ohGaG"><input class="ButtonToggle_input__vkfUm" name="getMetricsForBitlinkByCities" type="radio"/><span>csv</span></label></div></div><div class="CodeBlock_codeBlock__KlURa"><pre tabindex="0" style="color:#36383b;font-family:ProximaNova, monospace;line-height:1.2;font-size:1rem"><code class="language-json" style="white-space:pre"><span class="token token punctuation">{</span><span> </span><span> </span><span class="token token property">"unit"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"units"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"integer"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"facet"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"unit_reference"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"metrics"</span><span class="token token operator">:</span><span> </span><span class="token token punctuation">[</span><span> </span><span> </span><span class="token token punctuation">{</span><span> </span><span> </span><span class="token token property">"clicks"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"integer"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"city"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"subregion"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"region"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"country"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span> </span><span> </span><span class="token token punctuation">}</span><span> </span><span> </span><span class="token token punctuation">]</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"other_metrics"</span><span class="token token operator">:</span><span> </span><span class="token token punctuation">{</span><span> </span><span> </span><span class="token token property">"other_city_clicks"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"integer"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"no_city_clicks"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"integer"</span><span> </span><span> </span><span class="token token punctuation">}</span><span> </span><span></span><span class="token token punctuation">}</span></code></pre></div></div></div></div></div><div class="MethodDetail_methodContainer__3EF7h" id="getMetricsForBitlinkByDevices"><div class="MethodDetail_method__fyEiw"><div><h3 class="MethodHeader_h3__seOfC">Get Metrics for a Bitlink by Device Type</h3><h4 class="MethodHeader_description__3_p_p"><div class="MethodHeader_iconStyle__x5Ow4"><svg viewbox="0 0 14 6" xmlns="http://www.w3.org/2000/svg" class="IconRest_restIcon__3pju8 get"><title>Get</title><path d="M2.587 6c.307 0 .607-.044.9-.132.295-.088.533-.217.716-.387V2.876H2.271v.825h1.027v1.145a.772.772 0 0 1-.239.1 1.4 1.4 0 0 1-.383.049 1.338 1.338 0 0 1-1.083-.52c-.135-.17-.24-.379-.316-.626a2.879 2.879 0 0 1-.113-.84c0-.352.038-.655.113-.907.076-.253.182-.46.32-.623.137-.162.3-.281.488-.358a1.783 1.783 0 0 1 .97-.082l.13.032v.915h.889V.28a3.182 3.182 0 0 0-.59-.202A3.507 3.507 0 0 0 2.676 0c-.313 0-.628.055-.946.165a2.4 2.4 0 0 0-.861.523 2.707 2.707 0 0 0-.627.92C.081 1.98 0 2.433 0 2.966c0 .506.067.946.202 1.323.135.376.318.692.55.948a2.2 2.2 0 0 0 .82.572A2.7 2.7 0 0 0 2.587 6Zm6.24-.115V4.879H6.184V3.47h2.4V2.465h-2.4V1.121h2.602V.115h-3.71v5.77h3.75Zm4.43 0v-.907h-.914V1.022h.768v.997H14V.115H9.57V2.02h.89v-.997h.776v3.956h-.922v.907h2.942Z"></path></svg></div> /v4/bitlinks/{bitlink}/devices</h4><p class="MethodHeader_description__3_p_p">Returns the device types generating click traffic to the specified link.</p></div><div><h4 class="ParameterList_h4__nH9G8 ParameterList_dividing__wRGRx">Path Parameters</h4><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">bitlink</span><span class="Parameter_type__djM_s">string</span><span class="Parameter_required__pcK_H">Required</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">A Bitlink made of the domain and hash</div></div></div><div><h4 class="ParameterList_h4__nH9G8 ParameterList_dividing__wRGRx">Query Parameters</h4><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">unit</span><span class="Parameter_type__djM_s">string</span><span class="Parameter_required__pcK_H">Required</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">A unit of time</div><div class="Parameter_default__HHgG0 Parameter_spacer__JKXbH">Default: <span class="Parameter_label__DUY7G">"day"</span></div><div class="Parameter_enum__csO6P Parameter_spacer__JKXbH">Enum: <span class="Parameter_label__DUY7G">"minute"</span><span class="Parameter_label__DUY7G">"hour"</span><span class="Parameter_label__DUY7G">"day"</span><span class="Parameter_label__DUY7G">"week"</span><span class="Parameter_label__DUY7G">"month"</span></div></div><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">units</span><span class="Parameter_type__djM_s">integer</span><span class="Parameter_required__pcK_H">Required</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">An integer representing the time units to query data for. pass -1 to return all units of time.</div><div class="Parameter_default__HHgG0 Parameter_spacer__JKXbH">Default: <span class="Parameter_label__DUY7G">-1</span></div></div><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">size</span><span class="Parameter_type__djM_s">integer</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">The quantity of items to be be returned</div><div class="Parameter_default__HHgG0 Parameter_spacer__JKXbH">Default: <span class="Parameter_label__DUY7G">50</span></div></div><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">unit_reference</span><span class="Parameter_type__djM_s">string</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">An ISO-8601 timestamp, indicating the most recent time for which to pull metrics. Will default to current time. Timestamp values should be url encoded (i.e. replace '+' with '%2B' and ':' with '%3A'; 2022-02-02T15:53:02+0000 becomes 2022-02-02T15%3A53%3A02%2B0000)</div></div></div></div><div class="MethodDetail_examples__8nXeM"><div><label class="CodeSyntaxSelector_header__6P_Jc CodeSyntaxSelector_headerDark__hI3A0"><span>Request</span><div class="Select_wrapper__58utF Select_dark__KPIws"><select class="Select_select__qXz_Z Select_dark__KPIws" aria-label="Select" autocomplete="off"><option value="cURL" selected="">cURL</option><option value="Node">Node</option><option value="Browser">Browser</option><option value="Go">Go</option><option value="Python">Python</option></select><svg viewbox="0 0 8 14" xmlns="http://www.w3.org/2000/svg"><path d="M6.463 7 .987 1.66a.61.61 0 0 1 0-.878.648.648 0 0 1 .9 0L7.813 6.56a.61.61 0 0 1 0 .878l-5.926 5.78a.648.648 0 0 1-.9 0 .61.61 0 0 1 0-.879L6.463 7Z"></path></svg></div></label><div class="CodeSyntaxSelector_body__hBJ7j CodeSyntaxSelector_bodyDark__cizVw" tabindex="0"><div class="CodeBlock_codeBlock__KlURa"><pre tabindex="0" style="color:#ffffff;font-family:ProximaNova, monospace;line-height:1.2;font-size:1rem"><code class="language-bash" style="white-space:pre"><span class="token token" style="color:#ee6123">curl</span><span> </span><span class="token token punctuation">\</span><span> </span><span>-H </span><span class="token token" style="color:#acda95">'Authorization: Bearer {TOKEN}'</span><span> </span><span class="token token punctuation">\</span><span> </span><span>-X GET </span><span class="token token punctuation">\</span><span> </span><span>https://api-ssl.bitly.com/v4/bitlinks/bit.ly/12a4b6c/devices?unit</span><span class="token token operator">=</span><span>month</span><span class="token token operator">&</span><span class="token token assign-left variable">units</span><span class="token token operator">=</span><span class="token token" style="color:#a1b8f3">5</span><span class="token token operator">&</span><span class="token token assign-left variable">size</span><span class="token token operator">=</span><span class="token token" style="color:#a1b8f3">10</span><span class="token token operator">&</span><span class="token token assign-left variable">unit_reference</span><span class="token token operator">=</span><span class="token token" style="color:#a1b8f3">2006</span><span>-01-02T15%3A04%3A05-0700</span></code></pre></div></div></div><div><label class="CodeSyntaxSelector_header__6P_Jc"><span>Response</span><div class="Select_wrapper__58utF"><select class="Select_select__qXz_Z" aria-label="Select" autocomplete="off"><option value="200" selected="">200 SUCCESS</option><option value="400">400 BAD_REQUEST</option><option value="402">402 UPGRADE_REQUIRED</option><option value="403">403 FORBIDDEN</option><option value="404">404 NOT_FOUND</option><option value="410">410 GONE</option><option value="500">500 INTERNAL_ERROR</option><option value="503">503 TEMPORARILY_UNAVAILABLE</option></select><svg viewbox="0 0 8 14" xmlns="http://www.w3.org/2000/svg"><path d="M6.463 7 .987 1.66a.61.61 0 0 1 0-.878.648.648 0 0 1 .9 0L7.813 6.56a.61.61 0 0 1 0 .878l-5.926 5.78a.648.648 0 0 1-.9 0 .61.61 0 0 1 0-.879L6.463 7Z"></path></svg></div></label><div class="CodeSyntaxSelector_body__hBJ7j" tabindex="0"><div class="Response_formatSelect__Wt_qa"><div class="ButtonToggle_buttonToggle__6YJhd"><label class="ButtonToggle_label__ohGaG"><input class="ButtonToggle_input__vkfUm" name="getMetricsForBitlinkByDevices" type="radio" checked=""/><span>json</span></label><label class="ButtonToggle_label__ohGaG"><input class="ButtonToggle_input__vkfUm" name="getMetricsForBitlinkByDevices" type="radio"/><span>csv</span></label></div></div><div class="CodeBlock_codeBlock__KlURa"><pre tabindex="0" style="color:#36383b;font-family:ProximaNova, monospace;line-height:1.2;font-size:1rem"><code class="language-json" style="white-space:pre"><span class="token token punctuation">{</span><span> </span><span> </span><span class="token token property">"unit"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"units"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"integer"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"facet"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"unit_reference"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"metrics"</span><span class="token token operator">:</span><span> </span><span class="token token punctuation">[</span><span> </span><span> </span><span class="token token punctuation">{</span><span> </span><span> </span><span class="token token property">"clicks"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"integer"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"device_type"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span> </span><span> </span><span class="token token punctuation">}</span><span> </span><span> </span><span class="token token punctuation">]</span><span> </span><span></span><span class="token token punctuation">}</span></code></pre></div></div></div></div></div><div class="MethodDetail_methodContainer__3EF7h" id="getMetricsForBitlinkByReferrers"><div class="MethodDetail_method__fyEiw"><div><h3 class="MethodHeader_h3__seOfC">Get Metrics for a Bitlink by Referrers</h3><h4 class="MethodHeader_description__3_p_p"><div class="MethodHeader_iconStyle__x5Ow4"><svg viewbox="0 0 14 6" xmlns="http://www.w3.org/2000/svg" class="IconRest_restIcon__3pju8 get"><title>Get</title><path d="M2.587 6c.307 0 .607-.044.9-.132.295-.088.533-.217.716-.387V2.876H2.271v.825h1.027v1.145a.772.772 0 0 1-.239.1 1.4 1.4 0 0 1-.383.049 1.338 1.338 0 0 1-1.083-.52c-.135-.17-.24-.379-.316-.626a2.879 2.879 0 0 1-.113-.84c0-.352.038-.655.113-.907.076-.253.182-.46.32-.623.137-.162.3-.281.488-.358a1.783 1.783 0 0 1 .97-.082l.13.032v.915h.889V.28a3.182 3.182 0 0 0-.59-.202A3.507 3.507 0 0 0 2.676 0c-.313 0-.628.055-.946.165a2.4 2.4 0 0 0-.861.523 2.707 2.707 0 0 0-.627.92C.081 1.98 0 2.433 0 2.966c0 .506.067.946.202 1.323.135.376.318.692.55.948a2.2 2.2 0 0 0 .82.572A2.7 2.7 0 0 0 2.587 6Zm6.24-.115V4.879H6.184V3.47h2.4V2.465h-2.4V1.121h2.602V.115h-3.71v5.77h3.75Zm4.43 0v-.907h-.914V1.022h.768v.997H14V.115H9.57V2.02h.89v-.997h.776v3.956h-.922v.907h2.942Z"></path></svg></div> /v4/bitlinks/{bitlink}/referrers</h4><p class="MethodHeader_description__3_p_p">Returns referrer click counts for the specified link.</p></div><div><h4 class="ParameterList_h4__nH9G8 ParameterList_dividing__wRGRx">Path Parameters</h4><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">bitlink</span><span class="Parameter_type__djM_s">string</span><span class="Parameter_required__pcK_H">Required</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">A Bitlink made of the domain and hash</div></div></div><div><h4 class="ParameterList_h4__nH9G8 ParameterList_dividing__wRGRx">Query Parameters</h4><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">unit</span><span class="Parameter_type__djM_s">string</span><span class="Parameter_required__pcK_H">Required</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">A unit of time</div><div class="Parameter_default__HHgG0 Parameter_spacer__JKXbH">Default: <span class="Parameter_label__DUY7G">"day"</span></div><div class="Parameter_enum__csO6P Parameter_spacer__JKXbH">Enum: <span class="Parameter_label__DUY7G">"minute"</span><span class="Parameter_label__DUY7G">"hour"</span><span class="Parameter_label__DUY7G">"day"</span><span class="Parameter_label__DUY7G">"week"</span><span class="Parameter_label__DUY7G">"month"</span></div></div><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">units</span><span class="Parameter_type__djM_s">integer</span><span class="Parameter_required__pcK_H">Required</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">An integer representing the time units to query data for. pass -1 to return all units of time.</div><div class="Parameter_default__HHgG0 Parameter_spacer__JKXbH">Default: <span class="Parameter_label__DUY7G">-1</span></div></div><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">size</span><span class="Parameter_type__djM_s">integer</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">The quantity of items to be be returned</div><div class="Parameter_default__HHgG0 Parameter_spacer__JKXbH">Default: <span class="Parameter_label__DUY7G">50</span></div></div><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">unit_reference</span><span class="Parameter_type__djM_s">string</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">An ISO-8601 timestamp, indicating the most recent time for which to pull metrics. Will default to current time. Timestamp values should be url encoded (i.e. replace '+' with '%2B' and ':' with '%3A'; 2022-02-02T15:53:02+0000 becomes 2022-02-02T15%3A53%3A02%2B0000)</div></div></div></div><div class="MethodDetail_examples__8nXeM"><div><label class="CodeSyntaxSelector_header__6P_Jc CodeSyntaxSelector_headerDark__hI3A0"><span>Request</span><div class="Select_wrapper__58utF Select_dark__KPIws"><select class="Select_select__qXz_Z Select_dark__KPIws" aria-label="Select" autocomplete="off"><option value="cURL" selected="">cURL</option><option value="Node">Node</option><option value="Browser">Browser</option><option value="Go">Go</option><option value="Python">Python</option></select><svg viewbox="0 0 8 14" xmlns="http://www.w3.org/2000/svg"><path d="M6.463 7 .987 1.66a.61.61 0 0 1 0-.878.648.648 0 0 1 .9 0L7.813 6.56a.61.61 0 0 1 0 .878l-5.926 5.78a.648.648 0 0 1-.9 0 .61.61 0 0 1 0-.879L6.463 7Z"></path></svg></div></label><div class="CodeSyntaxSelector_body__hBJ7j CodeSyntaxSelector_bodyDark__cizVw" tabindex="0"><div class="CodeBlock_codeBlock__KlURa"><pre tabindex="0" style="color:#ffffff;font-family:ProximaNova, monospace;line-height:1.2;font-size:1rem"><code class="language-bash" style="white-space:pre"><span class="token token" style="color:#ee6123">curl</span><span> </span><span class="token token punctuation">\</span><span> </span><span>-H </span><span class="token token" style="color:#acda95">'Authorization: Bearer {TOKEN}'</span><span> </span><span class="token token punctuation">\</span><span> </span><span>-X GET </span><span class="token token punctuation">\</span><span> </span><span>https://api-ssl.bitly.com/v4/bitlinks/bit.ly/12a4b6c/referrers?unit</span><span class="token token operator">=</span><span>month</span><span class="token token operator">&</span><span class="token token assign-left variable">units</span><span class="token token operator">=</span><span class="token token" style="color:#a1b8f3">5</span><span class="token token operator">&</span><span class="token token assign-left variable">size</span><span class="token token operator">=</span><span class="token token" style="color:#a1b8f3">10</span><span class="token token operator">&</span><span class="token token assign-left variable">unit_reference</span><span class="token token operator">=</span><span class="token token" style="color:#a1b8f3">2006</span><span>-01-02T15%3A04%3A05-0700</span></code></pre></div></div></div><div><label class="CodeSyntaxSelector_header__6P_Jc"><span>Response</span><div class="Select_wrapper__58utF"><select class="Select_select__qXz_Z" aria-label="Select" autocomplete="off"><option value="200" selected="">200 SUCCESS</option><option value="400">400 BAD_REQUEST</option><option value="403">403 FORBIDDEN</option><option value="404">404 NOT_FOUND</option><option value="410">410 GONE</option><option value="500">500 INTERNAL_ERROR</option><option value="503">503 TEMPORARILY_UNAVAILABLE</option></select><svg viewbox="0 0 8 14" xmlns="http://www.w3.org/2000/svg"><path d="M6.463 7 .987 1.66a.61.61 0 0 1 0-.878.648.648 0 0 1 .9 0L7.813 6.56a.61.61 0 0 1 0 .878l-5.926 5.78a.648.648 0 0 1-.9 0 .61.61 0 0 1 0-.879L6.463 7Z"></path></svg></div></label><div class="CodeSyntaxSelector_body__hBJ7j" tabindex="0"><div class="Response_formatSelect__Wt_qa"><div class="ButtonToggle_buttonToggle__6YJhd"><label class="ButtonToggle_label__ohGaG"><input class="ButtonToggle_input__vkfUm" name="getMetricsForBitlinkByReferrers" type="radio" checked=""/><span>json</span></label><label class="ButtonToggle_label__ohGaG"><input class="ButtonToggle_input__vkfUm" name="getMetricsForBitlinkByReferrers" type="radio"/><span>csv</span></label></div></div><div class="CodeBlock_codeBlock__KlURa"><pre tabindex="0" style="color:#36383b;font-family:ProximaNova, monospace;line-height:1.2;font-size:1rem"><code class="language-json" style="white-space:pre"><span class="token token punctuation">{</span><span> </span><span> </span><span class="token token property">"unit"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"units"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"integer"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"facet"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"unit_reference"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"metrics"</span><span class="token token operator">:</span><span> </span><span class="token token punctuation">[</span><span> </span><span> </span><span class="token token punctuation">{</span><span> </span><span> </span><span class="token token property">"clicks"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"integer"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"value"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span> </span><span> </span><span class="token token punctuation">}</span><span> </span><span> </span><span class="token token punctuation">]</span><span> </span><span></span><span class="token token punctuation">}</span></code></pre></div></div></div></div></div><div class="MethodDetail_methodContainer__3EF7h" id="getMetricsForBitlinkByReferringDomains"><div class="MethodDetail_method__fyEiw"><div><h3 class="MethodHeader_h3__seOfC">Get Metrics for a Bitlink by Referring Domains</h3><h4 class="MethodHeader_description__3_p_p"><div class="MethodHeader_iconStyle__x5Ow4"><svg viewbox="0 0 14 6" xmlns="http://www.w3.org/2000/svg" class="IconRest_restIcon__3pju8 get"><title>Get</title><path d="M2.587 6c.307 0 .607-.044.9-.132.295-.088.533-.217.716-.387V2.876H2.271v.825h1.027v1.145a.772.772 0 0 1-.239.1 1.4 1.4 0 0 1-.383.049 1.338 1.338 0 0 1-1.083-.52c-.135-.17-.24-.379-.316-.626a2.879 2.879 0 0 1-.113-.84c0-.352.038-.655.113-.907.076-.253.182-.46.32-.623.137-.162.3-.281.488-.358a1.783 1.783 0 0 1 .97-.082l.13.032v.915h.889V.28a3.182 3.182 0 0 0-.59-.202A3.507 3.507 0 0 0 2.676 0c-.313 0-.628.055-.946.165a2.4 2.4 0 0 0-.861.523 2.707 2.707 0 0 0-.627.92C.081 1.98 0 2.433 0 2.966c0 .506.067.946.202 1.323.135.376.318.692.55.948a2.2 2.2 0 0 0 .82.572A2.7 2.7 0 0 0 2.587 6Zm6.24-.115V4.879H6.184V3.47h2.4V2.465h-2.4V1.121h2.602V.115h-3.71v5.77h3.75Zm4.43 0v-.907h-.914V1.022h.768v.997H14V.115H9.57V2.02h.89v-.997h.776v3.956h-.922v.907h2.942Z"></path></svg></div> /v4/bitlinks/{bitlink}/referring_domains</h4><p class="MethodHeader_description__3_p_p">Returns the referring domain click counts for the specified link.</p></div><div><h4 class="ParameterList_h4__nH9G8 ParameterList_dividing__wRGRx">Path Parameters</h4><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">bitlink</span><span class="Parameter_type__djM_s">string</span><span class="Parameter_required__pcK_H">Required</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">A Bitlink made of the domain and hash</div></div></div><div><h4 class="ParameterList_h4__nH9G8 ParameterList_dividing__wRGRx">Query Parameters</h4><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">unit</span><span class="Parameter_type__djM_s">string</span><span class="Parameter_required__pcK_H">Required</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">A unit of time</div><div class="Parameter_default__HHgG0 Parameter_spacer__JKXbH">Default: <span class="Parameter_label__DUY7G">"day"</span></div><div class="Parameter_enum__csO6P Parameter_spacer__JKXbH">Enum: <span class="Parameter_label__DUY7G">"minute"</span><span class="Parameter_label__DUY7G">"hour"</span><span class="Parameter_label__DUY7G">"day"</span><span class="Parameter_label__DUY7G">"week"</span><span class="Parameter_label__DUY7G">"month"</span></div></div><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">units</span><span class="Parameter_type__djM_s">integer</span><span class="Parameter_required__pcK_H">Required</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">An integer representing the time units to query data for. pass -1 to return all units of time.</div><div class="Parameter_default__HHgG0 Parameter_spacer__JKXbH">Default: <span class="Parameter_label__DUY7G">-1</span></div></div><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">size</span><span class="Parameter_type__djM_s">integer</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">The quantity of items to be be returned</div><div class="Parameter_default__HHgG0 Parameter_spacer__JKXbH">Default: <span class="Parameter_label__DUY7G">50</span></div></div><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">unit_reference</span><span class="Parameter_type__djM_s">string</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">An ISO-8601 timestamp, indicating the most recent time for which to pull metrics. Will default to current time. Timestamp values should be url encoded (i.e. replace '+' with '%2B' and ':' with '%3A'; 2022-02-02T15:53:02+0000 becomes 2022-02-02T15%3A53%3A02%2B0000)</div></div></div></div><div class="MethodDetail_examples__8nXeM"><div><label class="CodeSyntaxSelector_header__6P_Jc CodeSyntaxSelector_headerDark__hI3A0"><span>Request</span><div class="Select_wrapper__58utF Select_dark__KPIws"><select class="Select_select__qXz_Z Select_dark__KPIws" aria-label="Select" autocomplete="off"><option value="cURL" selected="">cURL</option><option value="Node">Node</option><option value="Browser">Browser</option><option value="Go">Go</option><option value="Python">Python</option></select><svg viewbox="0 0 8 14" xmlns="http://www.w3.org/2000/svg"><path d="M6.463 7 .987 1.66a.61.61 0 0 1 0-.878.648.648 0 0 1 .9 0L7.813 6.56a.61.61 0 0 1 0 .878l-5.926 5.78a.648.648 0 0 1-.9 0 .61.61 0 0 1 0-.879L6.463 7Z"></path></svg></div></label><div class="CodeSyntaxSelector_body__hBJ7j CodeSyntaxSelector_bodyDark__cizVw" tabindex="0"><div class="CodeBlock_codeBlock__KlURa"><pre tabindex="0" style="color:#ffffff;font-family:ProximaNova, monospace;line-height:1.2;font-size:1rem"><code class="language-bash" style="white-space:pre"><span class="token token" style="color:#ee6123">curl</span><span> </span><span class="token token punctuation">\</span><span> </span><span>-H </span><span class="token token" style="color:#acda95">'Authorization: Bearer {TOKEN}'</span><span> </span><span class="token token punctuation">\</span><span> </span><span>-X GET </span><span class="token token punctuation">\</span><span> </span><span>https://api-ssl.bitly.com/v4/bitlinks/bit.ly/12a4b6c/referring_domains?unit</span><span class="token token operator">=</span><span>month</span><span class="token token operator">&</span><span class="token token assign-left variable">units</span><span class="token token operator">=</span><span class="token token" style="color:#a1b8f3">5</span><span class="token token operator">&</span><span class="token token assign-left variable">size</span><span class="token token operator">=</span><span class="token token" style="color:#a1b8f3">10</span><span class="token token operator">&</span><span class="token token assign-left variable">unit_reference</span><span class="token token operator">=</span><span class="token token" style="color:#a1b8f3">2006</span><span>-01-02T15%3A04%3A05-0700</span></code></pre></div></div></div><div><label class="CodeSyntaxSelector_header__6P_Jc"><span>Response</span><div class="Select_wrapper__58utF"><select class="Select_select__qXz_Z" aria-label="Select" autocomplete="off"><option value="200" selected="">200 SUCCESS</option><option value="400">400 BAD_REQUEST</option><option value="403">403 FORBIDDEN</option><option value="404">404 NOT_FOUND</option><option value="410">410 GONE</option><option value="500">500 INTERNAL_ERROR</option><option value="503">503 TEMPORARILY_UNAVAILABLE</option></select><svg viewbox="0 0 8 14" xmlns="http://www.w3.org/2000/svg"><path d="M6.463 7 .987 1.66a.61.61 0 0 1 0-.878.648.648 0 0 1 .9 0L7.813 6.56a.61.61 0 0 1 0 .878l-5.926 5.78a.648.648 0 0 1-.9 0 .61.61 0 0 1 0-.879L6.463 7Z"></path></svg></div></label><div class="CodeSyntaxSelector_body__hBJ7j" tabindex="0"><div class="CodeBlock_codeBlock__KlURa"><pre tabindex="0" style="color:#36383b;font-family:ProximaNova, monospace;line-height:1.2;font-size:1rem"><code class="language-json" style="white-space:pre"><span class="token token punctuation">{</span><span> </span><span> </span><span class="token token property">"unit"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"units"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"integer"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"facet"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"unit_reference"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"metrics"</span><span class="token token operator">:</span><span> </span><span class="token token punctuation">[</span><span> </span><span> </span><span class="token token punctuation">{</span><span> </span><span> </span><span class="token token property">"clicks"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"integer"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"value"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span> </span><span> </span><span class="token token punctuation">}</span><span> </span><span> </span><span class="token token punctuation">]</span><span> </span><span></span><span class="token token punctuation">}</span></code></pre></div></div></div></div></div><div class="MethodDetail_methodContainer__3EF7h" id="getMetricsForBitlinkByReferrersByDomains"><div class="MethodDetail_method__fyEiw"><div><h3 class="MethodHeader_h3__seOfC">Get Metrics for a Bitlink by Referrers by Domain</h3><h4 class="MethodHeader_description__3_p_p"><div class="MethodHeader_iconStyle__x5Ow4"><svg viewbox="0 0 14 6" xmlns="http://www.w3.org/2000/svg" class="IconRest_restIcon__3pju8 get"><title>Get</title><path d="M2.587 6c.307 0 .607-.044.9-.132.295-.088.533-.217.716-.387V2.876H2.271v.825h1.027v1.145a.772.772 0 0 1-.239.1 1.4 1.4 0 0 1-.383.049 1.338 1.338 0 0 1-1.083-.52c-.135-.17-.24-.379-.316-.626a2.879 2.879 0 0 1-.113-.84c0-.352.038-.655.113-.907.076-.253.182-.46.32-.623.137-.162.3-.281.488-.358a1.783 1.783 0 0 1 .97-.082l.13.032v.915h.889V.28a3.182 3.182 0 0 0-.59-.202A3.507 3.507 0 0 0 2.676 0c-.313 0-.628.055-.946.165a2.4 2.4 0 0 0-.861.523 2.707 2.707 0 0 0-.627.92C.081 1.98 0 2.433 0 2.966c0 .506.067.946.202 1.323.135.376.318.692.55.948a2.2 2.2 0 0 0 .82.572A2.7 2.7 0 0 0 2.587 6Zm6.24-.115V4.879H6.184V3.47h2.4V2.465h-2.4V1.121h2.602V.115h-3.71v5.77h3.75Zm4.43 0v-.907h-.914V1.022h.768v.997H14V.115H9.57V2.02h.89v-.997h.776v3.956h-.922v.907h2.942Z"></path></svg></div> /v4/bitlinks/{bitlink}/referrers_by_domains</h4><p class="MethodHeader_description__3_p_p">Returns click metrics grouped by referrers for the specified link.</p></div><div><h4 class="ParameterList_h4__nH9G8 ParameterList_dividing__wRGRx">Path Parameters</h4><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">bitlink</span><span class="Parameter_type__djM_s">string</span><span class="Parameter_required__pcK_H">Required</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">A Bitlink made of the domain and hash</div></div></div><div><h4 class="ParameterList_h4__nH9G8 ParameterList_dividing__wRGRx">Query Parameters</h4><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">unit</span><span class="Parameter_type__djM_s">string</span><span class="Parameter_required__pcK_H">Required</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">A unit of time</div><div class="Parameter_default__HHgG0 Parameter_spacer__JKXbH">Default: <span class="Parameter_label__DUY7G">"day"</span></div><div class="Parameter_enum__csO6P Parameter_spacer__JKXbH">Enum: <span class="Parameter_label__DUY7G">"minute"</span><span class="Parameter_label__DUY7G">"hour"</span><span class="Parameter_label__DUY7G">"day"</span><span class="Parameter_label__DUY7G">"week"</span><span class="Parameter_label__DUY7G">"month"</span></div></div><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">units</span><span class="Parameter_type__djM_s">integer</span><span class="Parameter_required__pcK_H">Required</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">An integer representing the time units to query data for. pass -1 to return all units of time.</div><div class="Parameter_default__HHgG0 Parameter_spacer__JKXbH">Default: <span class="Parameter_label__DUY7G">-1</span></div></div><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">size</span><span class="Parameter_type__djM_s">integer</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">The quantity of items to be be returned</div><div class="Parameter_default__HHgG0 Parameter_spacer__JKXbH">Default: <span class="Parameter_label__DUY7G">50</span></div></div><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">unit_reference</span><span class="Parameter_type__djM_s">string</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">An ISO-8601 timestamp, indicating the most recent time for which to pull metrics. Will default to current time. Timestamp values should be url encoded (i.e. replace '+' with '%2B' and ':' with '%3A'; 2022-02-02T15:53:02+0000 becomes 2022-02-02T15%3A53%3A02%2B0000)</div></div></div></div><div class="MethodDetail_examples__8nXeM"><div><label class="CodeSyntaxSelector_header__6P_Jc CodeSyntaxSelector_headerDark__hI3A0"><span>Request</span><div class="Select_wrapper__58utF Select_dark__KPIws"><select class="Select_select__qXz_Z Select_dark__KPIws" aria-label="Select" autocomplete="off"><option value="cURL" selected="">cURL</option><option value="Node">Node</option><option value="Browser">Browser</option><option value="Go">Go</option><option value="Python">Python</option></select><svg viewbox="0 0 8 14" xmlns="http://www.w3.org/2000/svg"><path d="M6.463 7 .987 1.66a.61.61 0 0 1 0-.878.648.648 0 0 1 .9 0L7.813 6.56a.61.61 0 0 1 0 .878l-5.926 5.78a.648.648 0 0 1-.9 0 .61.61 0 0 1 0-.879L6.463 7Z"></path></svg></div></label><div class="CodeSyntaxSelector_body__hBJ7j CodeSyntaxSelector_bodyDark__cizVw" tabindex="0"><div class="CodeBlock_codeBlock__KlURa"><pre tabindex="0" style="color:#ffffff;font-family:ProximaNova, monospace;line-height:1.2;font-size:1rem"><code class="language-bash" style="white-space:pre"><span class="token token" style="color:#ee6123">curl</span><span> </span><span class="token token punctuation">\</span><span> </span><span>-H </span><span class="token token" style="color:#acda95">'Authorization: Bearer {TOKEN}'</span><span> </span><span class="token token punctuation">\</span><span> </span><span>-X GET </span><span class="token token punctuation">\</span><span> </span><span>https://api-ssl.bitly.com/v4/bitlinks/bit.ly/12a4b6c/referrers_by_domains?unit</span><span class="token token operator">=</span><span>month</span><span class="token token operator">&</span><span class="token token assign-left variable">units</span><span class="token token operator">=</span><span class="token token" style="color:#a1b8f3">5</span><span class="token token operator">&</span><span class="token token assign-left variable">size</span><span class="token token operator">=</span><span class="token token" style="color:#a1b8f3">10</span><span class="token token operator">&</span><span class="token token assign-left variable">unit_reference</span><span class="token token operator">=</span><span class="token token" style="color:#a1b8f3">2006</span><span>-01-02T15%3A04%3A05-0700</span></code></pre></div></div></div><div><label class="CodeSyntaxSelector_header__6P_Jc"><span>Response</span><div class="Select_wrapper__58utF"><select class="Select_select__qXz_Z" aria-label="Select" autocomplete="off"><option value="200" selected="">200 SUCCESS</option><option value="400">400 BAD_REQUEST</option><option value="403">403 FORBIDDEN</option><option value="404">404 NOT_FOUND</option><option value="410">410 GONE</option><option value="500">500 INTERNAL_ERROR</option><option value="503">503 TEMPORARILY_UNAVAILABLE</option></select><svg viewbox="0 0 8 14" xmlns="http://www.w3.org/2000/svg"><path d="M6.463 7 .987 1.66a.61.61 0 0 1 0-.878.648.648 0 0 1 .9 0L7.813 6.56a.61.61 0 0 1 0 .878l-5.926 5.78a.648.648 0 0 1-.9 0 .61.61 0 0 1 0-.879L6.463 7Z"></path></svg></div></label><div class="CodeSyntaxSelector_body__hBJ7j" tabindex="0"><div class="CodeBlock_codeBlock__KlURa"><pre tabindex="0" style="color:#36383b;font-family:ProximaNova, monospace;line-height:1.2;font-size:1rem"><code class="language-json" style="white-space:pre"><span class="token token punctuation">{</span><span> </span><span> </span><span class="token token property">"unit"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"units"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"integer"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"facet"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"unit_reference"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"referrers_by_domain"</span><span class="token token operator">:</span><span> </span><span class="token token punctuation">[</span><span> </span><span> </span><span class="token token punctuation">{</span><span> </span><span> </span><span class="token token property">"network"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"referrers"</span><span class="token token operator">:</span><span> </span><span class="token token punctuation">[</span><span> </span><span> </span><span class="token token punctuation">{</span><span> </span><span> </span><span class="token token property">"key"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"value"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"integer"</span><span> </span><span> </span><span class="token token punctuation">}</span><span> </span><span> </span><span class="token token punctuation">]</span><span> </span><span> </span><span class="token token punctuation">}</span><span> </span><span> </span><span class="token token punctuation">]</span><span> </span><span></span><span class="token token punctuation">}</span></code></pre></div></div></div></div></div><div class="MethodDetail_methodContainer__3EF7h" id="getBitlinksByGroup"><div class="MethodDetail_method__fyEiw"><div><h3 class="MethodHeader_h3__seOfC">Retrieve Bitlinks by Group</h3><h4 class="MethodHeader_description__3_p_p"><div class="MethodHeader_iconStyle__x5Ow4"><svg viewbox="0 0 14 6" xmlns="http://www.w3.org/2000/svg" class="IconRest_restIcon__3pju8 get"><title>Get</title><path d="M2.587 6c.307 0 .607-.044.9-.132.295-.088.533-.217.716-.387V2.876H2.271v.825h1.027v1.145a.772.772 0 0 1-.239.1 1.4 1.4 0 0 1-.383.049 1.338 1.338 0 0 1-1.083-.52c-.135-.17-.24-.379-.316-.626a2.879 2.879 0 0 1-.113-.84c0-.352.038-.655.113-.907.076-.253.182-.46.32-.623.137-.162.3-.281.488-.358a1.783 1.783 0 0 1 .97-.082l.13.032v.915h.889V.28a3.182 3.182 0 0 0-.59-.202A3.507 3.507 0 0 0 2.676 0c-.313 0-.628.055-.946.165a2.4 2.4 0 0 0-.861.523 2.707 2.707 0 0 0-.627.92C.081 1.98 0 2.433 0 2.966c0 .506.067.946.202 1.323.135.376.318.692.55.948a2.2 2.2 0 0 0 .82.572A2.7 2.7 0 0 0 2.587 6Zm6.24-.115V4.879H6.184V3.47h2.4V2.465h-2.4V1.121h2.602V.115h-3.71v5.77h3.75Zm4.43 0v-.907h-.914V1.022h.768v.997H14V.115H9.57V2.02h.89v-.997h.776v3.956h-.922v.907h2.942Z"></path></svg></div> /v4/groups/{group_guid}/bitlinks</h4><p class="MethodHeader_description__3_p_p">Returns a paginated collection of Bitlinks for a group.</p></div><div><h4 class="ParameterList_h4__nH9G8 ParameterList_dividing__wRGRx">Path Parameters</h4><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">group_guid</span><span class="Parameter_type__djM_s">string</span><span class="Parameter_required__pcK_H">Required</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">A GUID for a Bitly group</div></div></div><div><h4 class="ParameterList_h4__nH9G8 ParameterList_dividing__wRGRx">Query Parameters</h4><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">size</span><span class="Parameter_type__djM_s">integer</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">The quantity of items to be be returned</div><div class="Parameter_default__HHgG0 Parameter_spacer__JKXbH">Default: <span class="Parameter_label__DUY7G">50</span></div></div><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">page</span><span class="Parameter_type__djM_s">integer</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">Integer specifying the numbered result at which to start</div><div class="Parameter_default__HHgG0 Parameter_spacer__JKXbH">Default: <span class="Parameter_label__DUY7G">1</span></div></div><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">keyword</span><span class="Parameter_type__djM_s">string</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">Custom keyword to filter on history entries</div></div><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">query</span><span class="Parameter_type__djM_s">string</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">the value that you would like to search</div></div><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">created_before</span><span class="Parameter_type__djM_s">integer</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">Timestamp as an integer unix epoch</div></div><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">created_after</span><span class="Parameter_type__djM_s">integer</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">Timestamp as an integer unix epoch</div></div><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">modified_after</span><span class="Parameter_type__djM_s">integer</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">Timestamp as an integer unix epoch</div></div><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">archived</span><span class="Parameter_type__djM_s">string</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">Whether or not to include archived bitlinks</div><div class="Parameter_default__HHgG0 Parameter_spacer__JKXbH">Default: <span class="Parameter_label__DUY7G">"off"</span></div><div class="Parameter_enum__csO6P Parameter_spacer__JKXbH">Enum: <span class="Parameter_label__DUY7G">"on"</span><span class="Parameter_label__DUY7G">"off"</span><span class="Parameter_label__DUY7G">"both"</span></div></div><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">deeplinks</span><span class="Parameter_type__djM_s">string</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">Filter to only Bitlinks that contain deeplinks</div><div class="Parameter_default__HHgG0 Parameter_spacer__JKXbH">Default: <span class="Parameter_label__DUY7G">"both"</span></div><div class="Parameter_enum__csO6P Parameter_spacer__JKXbH">Enum: <span class="Parameter_label__DUY7G">"on"</span><span class="Parameter_label__DUY7G">"off"</span><span class="Parameter_label__DUY7G">"both"</span></div></div><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">domain_deeplinks</span><span class="Parameter_type__djM_s">string</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">Filter to only Bitlinks that contain deeplinks configured with a custom domain</div><div class="Parameter_default__HHgG0 Parameter_spacer__JKXbH">Default: <span class="Parameter_label__DUY7G">"both"</span></div><div class="Parameter_enum__csO6P Parameter_spacer__JKXbH">Enum: <span class="Parameter_label__DUY7G">"on"</span><span class="Parameter_label__DUY7G">"off"</span><span class="Parameter_label__DUY7G">"both"</span></div></div><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">campaign_guid</span><span class="Parameter_type__djM_s">string</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">Filter to return only links for the given campaign GUID, can be provided</div></div><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">channel_guid</span><span class="Parameter_type__djM_s">string</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">Filter to return only links for the given channel GUID, can be provided, overrides all other parameters</div></div><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">custom_bitlink</span><span class="Parameter_type__djM_s">string</span></div><div class="Parameter_default__HHgG0 Parameter_spacer__JKXbH">Default: <span class="Parameter_label__DUY7G">"both"</span></div><div class="Parameter_enum__csO6P Parameter_spacer__JKXbH">Enum: <span class="Parameter_label__DUY7G">"on"</span><span class="Parameter_label__DUY7G">"off"</span><span class="Parameter_label__DUY7G">"both"</span></div></div><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">tags</span><span class="Parameter_type__djM_s">array</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">filter by given tags</div></div><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">launchpad_ids</span><span class="Parameter_type__djM_s">array</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">filter by launchpad id</div></div><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">encoding_login</span><span class="Parameter_type__djM_s">array</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">Filter by the login of the authenticated user that created the Bitlink</div></div></div></div><div class="MethodDetail_examples__8nXeM"><div><label class="CodeSyntaxSelector_header__6P_Jc CodeSyntaxSelector_headerDark__hI3A0"><span>Request</span><div class="Select_wrapper__58utF Select_dark__KPIws"><select class="Select_select__qXz_Z Select_dark__KPIws" aria-label="Select" autocomplete="off"><option value="cURL" selected="">cURL</option><option value="Node">Node</option><option value="Browser">Browser</option><option value="Go">Go</option><option value="Python">Python</option></select><svg viewbox="0 0 8 14" xmlns="http://www.w3.org/2000/svg"><path d="M6.463 7 .987 1.66a.61.61 0 0 1 0-.878.648.648 0 0 1 .9 0L7.813 6.56a.61.61 0 0 1 0 .878l-5.926 5.78a.648.648 0 0 1-.9 0 .61.61 0 0 1 0-.879L6.463 7Z"></path></svg></div></label><div class="CodeSyntaxSelector_body__hBJ7j CodeSyntaxSelector_bodyDark__cizVw" tabindex="0"><div class="CodeBlock_codeBlock__KlURa"><pre tabindex="0" style="color:#ffffff;font-family:ProximaNova, monospace;line-height:1.2;font-size:1rem"><code class="language-bash" style="white-space:pre"><span class="token token" style="color:#ee6123">curl</span><span> </span><span class="token token punctuation">\</span><span> </span><span>-H </span><span class="token token" style="color:#acda95">'Authorization: Bearer {TOKEN}'</span><span> </span><span class="token token punctuation">\</span><span> </span><span>-X GET </span><span class="token token punctuation">\</span><span> </span><span>https://api-ssl.bitly.com/v4/groups/Ba1bc23dE4F/bitlinks?size</span><span class="token token operator">=</span><span class="token token" style="color:#a1b8f3">10</span><span class="token token operator">&</span><span class="token token assign-left variable">page</span><span class="token token operator">=</span><span class="token token" style="color:#a1b8f3">1</span><span class="token token operator">&</span><span class="token token assign-left variable">keyword</span><span class="token token operator">=</span><span>chauncey</span><span class="token token operator">&</span><span class="token token assign-left variable">query</span><span class="token token operator">=</span><span>api</span><span class="token token operator">&</span><span class="token token assign-left variable">created_before</span><span class="token token operator">=</span><span class="token token" style="color:#a1b8f3">1501027200</span><span class="token token operator">&</span><span class="token token assign-left variable">created_after</span><span class="token token operator">=</span><span class="token token" style="color:#a1b8f3">1501027200</span><span class="token token operator">&</span><span class="token token assign-left variable">modified_after</span><span class="token token operator">=</span><span class="token token" style="color:#a1b8f3">1501027200</span><span class="token token operator">&</span><span class="token token assign-left variable">archived</span><span class="token token operator">=</span><span>both</span><span class="token token operator">&</span><span class="token token assign-left variable">deeplinks</span><span class="token token operator">=</span><span>both</span><span class="token token operator">&</span><span class="token token assign-left variable">domain_deeplinks</span><span class="token token operator">=</span><span>both</span><span class="token token operator">&</span><span class="token token assign-left variable">campaign_guid</span><span class="token token operator">=</span><span>Ca1bcd2EFGh</span><span class="token token operator">&</span><span class="token token assign-left variable">channel_guid</span><span class="token token operator">=</span><span>Ha1bc2DefGh</span><span class="token token operator">&</span><span class="token token assign-left variable">custom_bitlink</span><span class="token token operator">=</span><span>both</span><span class="token token operator">&</span><span>tags%5B0%5D</span><span class="token token operator">=</span><span>bitly</span><span class="token token operator">&</span><span>tags%5B1%5D</span><span class="token token operator">=</span><span>api</span><span class="token token operator">&</span><span>launchpad_ids%5B0%5D</span><span class="token token operator">=</span><span>M1234567890</span><span class="token token operator">&</span><span>encoding_login%5B0%5D</span><span class="token token operator">=</span><span>chauncey</span></code></pre></div></div></div><div><label class="CodeSyntaxSelector_header__6P_Jc"><span>Response</span><div class="Select_wrapper__58utF"><select class="Select_select__qXz_Z" aria-label="Select" autocomplete="off"><option value="200" selected="">200 SUCCESS</option><option value="403">403 FORBIDDEN</option><option value="404">404 NOT_FOUND</option><option value="500">500 INTERNAL_ERROR</option><option value="503">503 TEMPORARILY_UNAVAILABLE</option></select><svg viewbox="0 0 8 14" xmlns="http://www.w3.org/2000/svg"><path d="M6.463 7 .987 1.66a.61.61 0 0 1 0-.878.648.648 0 0 1 .9 0L7.813 6.56a.61.61 0 0 1 0 .878l-5.926 5.78a.648.648 0 0 1-.9 0 .61.61 0 0 1 0-.879L6.463 7Z"></path></svg></div></label><div class="CodeSyntaxSelector_body__hBJ7j" tabindex="0"><div class="CodeBlock_codeBlock__KlURa"><pre tabindex="0" style="color:#36383b;font-family:ProximaNova, monospace;line-height:1.2;font-size:1rem"><code class="language-json" style="white-space:pre"><span class="token token punctuation">{</span><span> </span><span> </span><span class="token token property">"links"</span><span class="token token operator">:</span><span> </span><span class="token token punctuation">[</span><span> </span><span> </span><span class="token token punctuation">{</span><span> </span><span> </span><span class="token token property">"references"</span><span class="token token operator">:</span><span> </span><span class="token token punctuation">{</span><span> </span><span class="token token" style="color:#51763e">"any"</span><span> </span><span class="token token punctuation">}</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"link"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"id"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"long_url"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"title"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"archived"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"boolean"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"created_at"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"created_by"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"client_id"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"custom_bitlinks"</span><span class="token token operator">:</span><span> </span><span class="token token punctuation">[</span><span> </span><span> </span><span class="token token" style="color:#51763e">"string"</span><span> </span><span> </span><span class="token token punctuation">]</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"tags"</span><span class="token token operator">:</span><span> </span><span class="token token punctuation">[</span><span> </span><span> </span><span class="token token" style="color:#51763e">"string"</span><span> </span><span> </span><span class="token token punctuation">]</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"launchpad_ids"</span><span class="token token operator">:</span><span> </span><span class="token token punctuation">[</span><span> </span><span> </span><span class="token token" style="color:#51763e">"string"</span><span> </span><span> </span><span class="token token punctuation">]</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"deeplinks"</span><span class="token token operator">:</span><span> </span><span class="token token punctuation">[</span><span> </span><span> </span><span class="token token punctuation">{</span><span> </span><span> </span><span class="token token property">"guid"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"bitlink"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"app_uri_path"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"install_url"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"app_guid"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"os"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"install_type"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"created"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"modified"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"brand_guid"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span> </span><span> </span><span class="token token punctuation">}</span><span> </span><span> </span><span class="token token punctuation">]</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"is_deleted"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"boolean"</span><span> </span><span> </span><span class="token token punctuation">}</span><span> </span><span> </span><span class="token token punctuation">]</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"pagination"</span><span class="token token operator">:</span><span> </span><span class="token token punctuation">{</span><span> </span><span> </span><span class="token token property">"prev"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"next"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"size"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"integer"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"page"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"integer"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"total"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"integer"</span><span> </span><span> </span><span class="token token punctuation">}</span><span> </span><span></span><span class="token token punctuation">}</span></code></pre></div></div></div></div></div><div class="MethodDetail_methodContainer__3EF7h" id="updateBitlinksByGroup"><div class="MethodDetail_method__fyEiw"><div><h3 class="MethodHeader_h3__seOfC">Bulk update bitlinks</h3><h4 class="MethodHeader_description__3_p_p"><div class="MethodHeader_iconStyle__x5Ow4"><svg viewbox="0 0 23 6" xmlns="http://www.w3.org/2000/svg" class="IconRest_restIcon__3pju8 patch"><title>Patch</title><path d="M1.095 5.885V3.898c.027.006.07.011.132.017a4.052 4.052 0 0 0 .372.016h.128c.277 0 .545-.037.803-.11.259-.075.49-.193.692-.355.202-.162.365-.368.487-.618.123-.25.184-.551.184-.903 0-.401-.07-.727-.212-.977a1.606 1.606 0 0 0-.547-.585 2.041 2.041 0 0 0-.756-.28 5.067 5.067 0 0 0-.835-.07c-.267 0-.534.012-.804.037C.47.095.224.13 0 .173v5.712h1.095Zm.472-2.934h-.1a2.448 2.448 0 0 1-.276-.017.853.853 0 0 1-.096-.016V1.047c.059-.011.136-.02.232-.03.096-.007.197-.012.304-.012.138 0 .274.014.408.042a.964.964 0 0 1 .355.148.801.801 0 0 1 .252.284.937.937 0 0 1 .096.45c0 .214-.033.387-.1.519a.787.787 0 0 1-.268.309 1.038 1.038 0 0 1-.38.152 2.235 2.235 0 0 1-.427.042Zm3.79 2.934.383-1.278h1.67l.4 1.278h1.152L7.163.115H6.068L4.26 5.885h1.095ZM7.194 3.7h-1.2l.56-1.929h.072l.568 1.929Zm5.668 2.184v-.907h-.903V1.022h.76v.997h.879V.115H9.218V2.02h.879v-.997h.767v3.956h-.91v.907h2.91Zm3.91.115c.276 0 .547-.036.81-.107.265-.072.482-.17.652-.297V3.948h-.88v.997c-.164.033-.335.05-.51.05-.246 0-.464-.049-.656-.145a1.383 1.383 0 0 1-.488-.408 1.881 1.881 0 0 1-.304-.63A2.973 2.973 0 0 1 15.293 3c0-.34.038-.636.112-.886.075-.25.179-.457.312-.622.133-.165.29-.287.468-.367.178-.08.371-.12.58-.12.175 0 .346.014.511.042v.94h.88V.271a2.727 2.727 0 0 0-.548-.19A3.419 3.419 0 0 0 16.796 0c-.303 0-.613.05-.927.152-.314.102-.6.27-.855.503a2.611 2.611 0 0 0-.628.923c-.163.382-.244.856-.244 1.422 0 .544.072 1.007.216 1.389.144.382.336.692.576.931.24.24.518.412.835.52.317.106.652.16 1.003.16Zm3.325-.115V3.47h1.807v2.415H23V.115h-1.095v2.35h-1.807V.114h-1.095v5.77h1.095Z"></path></svg></div> /v4/groups/{group_guid}/bitlinks</h4><p class="MethodHeader_description__3_p_p">Bulk update can add or remove tags or archive up to 100 links at a time; The response includes a list of bitlink ids that were updated.</p></div><div><h4 class="ParameterList_h4__nH9G8 ParameterList_dividing__wRGRx">Path Parameters</h4><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">group_guid</span><span class="Parameter_type__djM_s">string</span><span class="Parameter_required__pcK_H">Required</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">A GUID for a Bitly group</div></div></div><div><h4 class="ParameterList_h4__nH9G8 ParameterList_dividing__wRGRx">Request Body Schema</h4><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">action</span><span class="Parameter_type__djM_s">string</span><span class="Parameter_required__pcK_H">Required</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">archive or edit_tags</div><div class="Parameter_enum__csO6P Parameter_spacer__JKXbH">Enum: <span class="Parameter_label__DUY7G">"archive"</span><span class="Parameter_label__DUY7G">"edit_tags"</span></div></div><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">archive</span><span class="Parameter_type__djM_s">boolean</span></div></div><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">add_tags</span><span class="Parameter_type__djM_s">array of string</span></div></div><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">remove_tags</span><span class="Parameter_type__djM_s">array of string</span></div></div><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">links</span><span class="Parameter_type__djM_s">array of string</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">this is limited to 100 bitlink ids</div></div></div></div><div class="MethodDetail_examples__8nXeM"><div><label class="CodeSyntaxSelector_header__6P_Jc CodeSyntaxSelector_headerDark__hI3A0"><span>Request</span><div class="Select_wrapper__58utF Select_dark__KPIws"><select class="Select_select__qXz_Z Select_dark__KPIws" aria-label="Select" autocomplete="off"><option value="cURL" selected="">cURL</option><option value="Node">Node</option><option value="Browser">Browser</option><option value="Go">Go</option><option value="Python">Python</option></select><svg viewbox="0 0 8 14" xmlns="http://www.w3.org/2000/svg"><path d="M6.463 7 .987 1.66a.61.61 0 0 1 0-.878.648.648 0 0 1 .9 0L7.813 6.56a.61.61 0 0 1 0 .878l-5.926 5.78a.648.648 0 0 1-.9 0 .61.61 0 0 1 0-.879L6.463 7Z"></path></svg></div></label><div class="CodeSyntaxSelector_body__hBJ7j CodeSyntaxSelector_bodyDark__cizVw" tabindex="0"><div class="CodeBlock_codeBlock__KlURa"><pre tabindex="0" style="color:#ffffff;font-family:ProximaNova, monospace;line-height:1.2;font-size:1rem"><code class="language-bash" style="white-space:pre"><span class="token token" style="color:#ee6123">curl</span><span> </span><span class="token token punctuation">\</span><span> </span><span>-H </span><span class="token token" style="color:#acda95">'Authorization: Bearer {TOKEN}'</span><span> </span><span class="token token punctuation">\</span><span> </span><span>-H </span><span class="token token" style="color:#acda95">'Content-Type: application/json'</span><span> </span><span class="token token punctuation">\</span><span> </span><span>-X PATCH </span><span class="token token punctuation">\</span><span> </span><span>-d </span><span class="token token" style="color:#acda95">'{ </span><span class="token token" style="color:#acda95"> "action": "edit_tags", </span><span class="token token" style="color:#acda95"> "add_tags": [ </span><span class="token token" style="color:#acda95"> "tag1", </span><span class="token token" style="color:#acda95"> "tag2" </span><span class="token token" style="color:#acda95"> ], </span><span class="token token" style="color:#acda95"> "links": [ </span><span class="token token" style="color:#acda95"> "bit.ly/1234abcd", </span><span class="token token" style="color:#acda95"> "bit.ly/5678efgh" </span><span class="token token" style="color:#acda95"> ] </span><span class="token token" style="color:#acda95">}'</span><span> </span><span class="token token punctuation">\</span><span> </span>https://api-ssl.bitly.com/v4/groups/Ba1bc23dE4F/bitlinks</code></pre></div></div></div><div><label class="CodeSyntaxSelector_header__6P_Jc"><span>Response</span><div class="Select_wrapper__58utF"><select class="Select_select__qXz_Z" aria-label="Select" autocomplete="off"><option value="200" selected="">200 SUCCESS</option><option value="400">400 BAD_REQUEST</option><option value="403">403 FORBIDDEN</option><option value="404">404 NOT_FOUND</option><option value="422">422 UNPROCESSABLE_ENTITY</option><option value="500">500 INTERNAL_ERROR</option><option value="503">503 TEMPORARILY_UNAVAILABLE</option></select><svg viewbox="0 0 8 14" xmlns="http://www.w3.org/2000/svg"><path d="M6.463 7 .987 1.66a.61.61 0 0 1 0-.878.648.648 0 0 1 .9 0L7.813 6.56a.61.61 0 0 1 0 .878l-5.926 5.78a.648.648 0 0 1-.9 0 .61.61 0 0 1 0-.879L6.463 7Z"></path></svg></div></label><div class="CodeSyntaxSelector_body__hBJ7j" tabindex="0"><div class="CodeBlock_codeBlock__KlURa"><pre tabindex="0" style="color:#36383b;font-family:ProximaNova, monospace;line-height:1.2;font-size:1rem"><code class="language-json" style="white-space:pre"><span class="token token punctuation">{</span><span> </span><span> </span><span class="token token property">"links"</span><span class="token token operator">:</span><span> </span><span class="token token punctuation">[</span><span> </span><span> </span><span class="token token" style="color:#51763e">"string"</span><span> </span><span> </span><span class="token token punctuation">]</span><span> </span><span></span><span class="token token punctuation">}</span></code></pre></div></div></div></div></div><div class="MethodDetail_methodContainer__3EF7h" id="getSortedBitlinks"><div class="MethodDetail_method__fyEiw"><div><h3 class="MethodHeader_h3__seOfC">Retrieve Sorted Bitlinks for Group</h3><h4 class="MethodHeader_description__3_p_p"><div class="MethodHeader_iconStyle__x5Ow4"><svg viewbox="0 0 14 6" xmlns="http://www.w3.org/2000/svg" class="IconRest_restIcon__3pju8 get"><title>Get</title><path d="M2.587 6c.307 0 .607-.044.9-.132.295-.088.533-.217.716-.387V2.876H2.271v.825h1.027v1.145a.772.772 0 0 1-.239.1 1.4 1.4 0 0 1-.383.049 1.338 1.338 0 0 1-1.083-.52c-.135-.17-.24-.379-.316-.626a2.879 2.879 0 0 1-.113-.84c0-.352.038-.655.113-.907.076-.253.182-.46.32-.623.137-.162.3-.281.488-.358a1.783 1.783 0 0 1 .97-.082l.13.032v.915h.889V.28a3.182 3.182 0 0 0-.59-.202A3.507 3.507 0 0 0 2.676 0c-.313 0-.628.055-.946.165a2.4 2.4 0 0 0-.861.523 2.707 2.707 0 0 0-.627.92C.081 1.98 0 2.433 0 2.966c0 .506.067.946.202 1.323.135.376.318.692.55.948a2.2 2.2 0 0 0 .82.572A2.7 2.7 0 0 0 2.587 6Zm6.24-.115V4.879H6.184V3.47h2.4V2.465h-2.4V1.121h2.602V.115h-3.71v5.77h3.75Zm4.43 0v-.907h-.914V1.022h.768v.997H14V.115H9.57V2.02h.89v-.997h.776v3.956h-.922v.907h2.942Z"></path></svg></div> /v4/groups/{group_guid}/bitlinks/{sort}</h4><p class="MethodHeader_description__3_p_p">Returns a list of Bitlinks sorted by group.</p></div><div><h4 class="ParameterList_h4__nH9G8 ParameterList_dividing__wRGRx">Path Parameters</h4><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">group_guid</span><span class="Parameter_type__djM_s">string</span><span class="Parameter_required__pcK_H">Required</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">A GUID for a Bitly group</div></div><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">sort</span><span class="Parameter_type__djM_s">string</span><span class="Parameter_required__pcK_H">Required</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">The type of sorting that you would like to do</div><div class="Parameter_enum__csO6P Parameter_spacer__JKXbH">Enum: <span class="Parameter_label__DUY7G">"clicks"</span></div></div></div><div><h4 class="ParameterList_h4__nH9G8 ParameterList_dividing__wRGRx">Query Parameters</h4><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">unit</span><span class="Parameter_type__djM_s">string</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">A unit of time</div><div class="Parameter_default__HHgG0 Parameter_spacer__JKXbH">Default: <span class="Parameter_label__DUY7G">"day"</span></div><div class="Parameter_enum__csO6P Parameter_spacer__JKXbH">Enum: <span class="Parameter_label__DUY7G">"minute"</span><span class="Parameter_label__DUY7G">"hour"</span><span class="Parameter_label__DUY7G">"day"</span><span class="Parameter_label__DUY7G">"week"</span><span class="Parameter_label__DUY7G">"month"</span></div></div><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">units</span><span class="Parameter_type__djM_s">integer</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">An integer representing the time units to query data for. pass -1 to return all units of time.</div><div class="Parameter_default__HHgG0 Parameter_spacer__JKXbH">Default: <span class="Parameter_label__DUY7G">-1</span></div></div><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">unit_reference</span><span class="Parameter_type__djM_s">string</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">An ISO-8601 timestamp, indicating the most recent time for which to pull metrics. Will default to current time. Timestamp values should be url encoded (i.e. replace '+' with '%2B' and ':' with '%3A'; 2022-02-02T15:53:02+0000 becomes 2022-02-02T15%3A53%3A02%2B0000)</div></div><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">size</span><span class="Parameter_type__djM_s">integer</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">The quantity of items to be be returned</div><div class="Parameter_default__HHgG0 Parameter_spacer__JKXbH">Default: <span class="Parameter_label__DUY7G">50</span></div></div></div></div><div class="MethodDetail_examples__8nXeM"><div><label class="CodeSyntaxSelector_header__6P_Jc CodeSyntaxSelector_headerDark__hI3A0"><span>Request</span><div class="Select_wrapper__58utF Select_dark__KPIws"><select class="Select_select__qXz_Z Select_dark__KPIws" aria-label="Select" autocomplete="off"><option value="cURL" selected="">cURL</option><option value="Node">Node</option><option value="Browser">Browser</option><option value="Go">Go</option><option value="Python">Python</option></select><svg viewbox="0 0 8 14" xmlns="http://www.w3.org/2000/svg"><path d="M6.463 7 .987 1.66a.61.61 0 0 1 0-.878.648.648 0 0 1 .9 0L7.813 6.56a.61.61 0 0 1 0 .878l-5.926 5.78a.648.648 0 0 1-.9 0 .61.61 0 0 1 0-.879L6.463 7Z"></path></svg></div></label><div class="CodeSyntaxSelector_body__hBJ7j CodeSyntaxSelector_bodyDark__cizVw" tabindex="0"><div class="CodeBlock_codeBlock__KlURa"><pre tabindex="0" style="color:#ffffff;font-family:ProximaNova, monospace;line-height:1.2;font-size:1rem"><code class="language-bash" style="white-space:pre"><span class="token token" style="color:#ee6123">curl</span><span> </span><span class="token token punctuation">\</span><span> </span><span>-H </span><span class="token token" style="color:#acda95">'Authorization: Bearer {TOKEN}'</span><span> </span><span class="token token punctuation">\</span><span> </span><span>-X GET </span><span class="token token punctuation">\</span><span> </span><span>https://api-ssl.bitly.com/v4/groups/Ba1bc23dE4F/bitlinks/clicks?unit</span><span class="token token operator">=</span><span>month</span><span class="token token operator">&</span><span class="token token assign-left variable">units</span><span class="token token operator">=</span><span class="token token" style="color:#a1b8f3">5</span><span class="token token operator">&</span><span class="token token assign-left variable">unit_reference</span><span class="token token operator">=</span><span class="token token" style="color:#a1b8f3">2006</span><span>-01-02T15%3A04%3A05-0700</span><span class="token token operator">&</span><span class="token token assign-left variable">size</span><span class="token token operator">=</span><span class="token token" style="color:#a1b8f3">10</span></code></pre></div></div></div><div><label class="CodeSyntaxSelector_header__6P_Jc"><span>Response</span><div class="Select_wrapper__58utF"><select class="Select_select__qXz_Z" aria-label="Select" autocomplete="off"><option value="200" selected="">200 SUCCESS</option><option value="403">403 FORBIDDEN</option><option value="404">404 NOT_FOUND</option><option value="500">500 INTERNAL_ERROR</option><option value="503">503 TEMPORARILY_UNAVAILABLE</option></select><svg viewbox="0 0 8 14" xmlns="http://www.w3.org/2000/svg"><path d="M6.463 7 .987 1.66a.61.61 0 0 1 0-.878.648.648 0 0 1 .9 0L7.813 6.56a.61.61 0 0 1 0 .878l-5.926 5.78a.648.648 0 0 1-.9 0 .61.61 0 0 1 0-.879L6.463 7Z"></path></svg></div></label><div class="CodeSyntaxSelector_body__hBJ7j" tabindex="0"><div class="CodeBlock_codeBlock__KlURa"><pre tabindex="0" style="color:#36383b;font-family:ProximaNova, monospace;line-height:1.2;font-size:1rem"><code class="language-json" style="white-space:pre"><span class="token token punctuation">{</span><span> </span><span> </span><span class="token token property">"links"</span><span class="token token operator">:</span><span> </span><span class="token token punctuation">[</span><span> </span><span> </span><span class="token token punctuation">{</span><span> </span><span> </span><span class="token token property">"references"</span><span class="token token operator">:</span><span> </span><span class="token token punctuation">{</span><span> </span><span class="token token" style="color:#51763e">"any"</span><span> </span><span class="token token punctuation">}</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"link"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"id"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"long_url"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"title"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"archived"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"boolean"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"created_at"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"created_by"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"client_id"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"custom_bitlinks"</span><span class="token token operator">:</span><span> </span><span class="token token punctuation">[</span><span> </span><span> </span><span class="token token" style="color:#51763e">"string"</span><span> </span><span> </span><span class="token token punctuation">]</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"tags"</span><span class="token token operator">:</span><span> </span><span class="token token punctuation">[</span><span> </span><span> </span><span class="token token" style="color:#51763e">"string"</span><span> </span><span> </span><span class="token token punctuation">]</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"launchpad_ids"</span><span class="token token operator">:</span><span> </span><span class="token token punctuation">[</span><span> </span><span> </span><span class="token token" style="color:#51763e">"string"</span><span> </span><span> </span><span class="token token punctuation">]</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"deeplinks"</span><span class="token token operator">:</span><span> </span><span class="token token punctuation">[</span><span> </span><span> </span><span class="token token punctuation">{</span><span> </span><span> </span><span class="token token property">"guid"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"bitlink"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"app_uri_path"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"install_url"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"app_guid"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"os"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"install_type"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"created"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"modified"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"brand_guid"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span> </span><span> </span><span class="token token punctuation">}</span><span> </span><span> </span><span class="token token punctuation">]</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"is_deleted"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"boolean"</span><span> </span><span> </span><span class="token token punctuation">}</span><span> </span><span> </span><span class="token token punctuation">]</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"sorted_links"</span><span class="token token operator">:</span><span> </span><span class="token token punctuation">[</span><span> </span><span> </span><span class="token token punctuation">{</span><span> </span><span> </span><span class="token token property">"clicks"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"integer"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"id"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span> </span><span> </span><span class="token token punctuation">}</span><span> </span><span> </span><span class="token token punctuation">]</span><span> </span><span></span><span class="token token punctuation">}</span></code></pre></div></div></div></div></div><div class="ApiReference_tagInfo__YVbgw"><h2 class="ApiReference_tagName__IJx2p">BSDs</h2><p class="ApiReference_tagDescription__8c1GM">Branded short domains (BSDs) are the custom domains used to brand your links. A BSD can be added to a Bitly organization and may be assigned to one or more groups. They can contain up to 32 characters. </p></div><div class="MethodDetail_methodContainer__3EF7h" id="getOverridesForGroups"><div class="MethodDetail_method__fyEiw"><div><h3 class="MethodHeader_h3__seOfC">Group Overrides</h3><h4 class="MethodHeader_description__3_p_p"><div class="MethodHeader_iconStyle__x5Ow4"><svg viewbox="0 0 14 6" xmlns="http://www.w3.org/2000/svg" class="IconRest_restIcon__3pju8 get"><title>Get</title><path d="M2.587 6c.307 0 .607-.044.9-.132.295-.088.533-.217.716-.387V2.876H2.271v.825h1.027v1.145a.772.772 0 0 1-.239.1 1.4 1.4 0 0 1-.383.049 1.338 1.338 0 0 1-1.083-.52c-.135-.17-.24-.379-.316-.626a2.879 2.879 0 0 1-.113-.84c0-.352.038-.655.113-.907.076-.253.182-.46.32-.623.137-.162.3-.281.488-.358a1.783 1.783 0 0 1 .97-.082l.13.032v.915h.889V.28a3.182 3.182 0 0 0-.59-.202A3.507 3.507 0 0 0 2.676 0c-.313 0-.628.055-.946.165a2.4 2.4 0 0 0-.861.523 2.707 2.707 0 0 0-.627.92C.081 1.98 0 2.433 0 2.966c0 .506.067.946.202 1.323.135.376.318.692.55.948a2.2 2.2 0 0 0 .82.572A2.7 2.7 0 0 0 2.587 6Zm6.24-.115V4.879H6.184V3.47h2.4V2.465h-2.4V1.121h2.602V.115h-3.71v5.77h3.75Zm4.43 0v-.907h-.914V1.022h.768v.997H14V.115H9.57V2.02h.89v-.997h.776v3.956h-.922v.907h2.942Z"></path></svg></div> /v4/groups/{group_guid}/overrides</h4><p class="MethodHeader_description__3_p_p">retrieves all account overrides matching specified group_guid and bsd query filters.</p></div><div><h4 class="ParameterList_h4__nH9G8 ParameterList_dividing__wRGRx">Path Parameters</h4><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">group_guid</span><span class="Parameter_type__djM_s">string</span><span class="Parameter_required__pcK_H">Required</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">A GUID for a Bitly group</div></div></div><div><h4 class="ParameterList_h4__nH9G8 ParameterList_dividing__wRGRx">Query Parameters</h4><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">group_guid</span><span class="Parameter_type__djM_s">array</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">GUIDs for a Bitly group</div></div><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">created_after</span><span class="Parameter_type__djM_s">integer</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">Timestamp as an integer unix epoch</div></div><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">limit</span><span class="Parameter_type__djM_s">integer</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">limit the amount of results returned</div></div><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">offset</span><span class="Parameter_type__djM_s">integer</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">set the starting index of the result set</div></div><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">bsd</span><span class="Parameter_type__djM_s">array</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">a branded short domains to filter results</div></div></div></div><div class="MethodDetail_examples__8nXeM"><div><label class="CodeSyntaxSelector_header__6P_Jc CodeSyntaxSelector_headerDark__hI3A0"><span>Request</span><div class="Select_wrapper__58utF Select_dark__KPIws"><select class="Select_select__qXz_Z Select_dark__KPIws" aria-label="Select" autocomplete="off"><option value="cURL" selected="">cURL</option><option value="Node">Node</option><option value="Browser">Browser</option><option value="Go">Go</option><option value="Python">Python</option></select><svg viewbox="0 0 8 14" xmlns="http://www.w3.org/2000/svg"><path d="M6.463 7 .987 1.66a.61.61 0 0 1 0-.878.648.648 0 0 1 .9 0L7.813 6.56a.61.61 0 0 1 0 .878l-5.926 5.78a.648.648 0 0 1-.9 0 .61.61 0 0 1 0-.879L6.463 7Z"></path></svg></div></label><div class="CodeSyntaxSelector_body__hBJ7j CodeSyntaxSelector_bodyDark__cizVw" tabindex="0"><div class="CodeBlock_codeBlock__KlURa"><pre tabindex="0" style="color:#ffffff;font-family:ProximaNova, monospace;line-height:1.2;font-size:1rem"><code class="language-bash" style="white-space:pre"><span class="token token" style="color:#ee6123">curl</span><span> </span><span class="token token punctuation">\</span><span> </span><span>-H </span><span class="token token" style="color:#acda95">'Authorization: Bearer {TOKEN}'</span><span> </span><span class="token token punctuation">\</span><span> </span><span>-X GET </span><span class="token token punctuation">\</span><span> </span><span>https://api-ssl.bitly.com/v4/groups/Ba1bc23dE4F/overrides?group_guid%5B0%5D</span><span class="token token operator">=</span><span>Ba1bc23dE4F</span><span class="token token operator">&</span><span>group_guid%5B1%5D</span><span class="token token operator">=</span><span>Br1bc55dE4J</span><span class="token token operator">&</span><span class="token token assign-left variable">created_after</span><span class="token token operator">=</span><span class="token token" style="color:#a1b8f3">1501027200</span><span class="token token operator">&</span><span class="token token assign-left variable">limit</span><span class="token token operator">=</span><span class="token token" style="color:#a1b8f3">50</span><span class="token token operator">&</span><span class="token token assign-left variable">offset</span><span class="token token operator">=</span><span class="token token" style="color:#a1b8f3">50</span><span class="token token operator">&</span><span class="token token assign-left variable">bsd</span><span class="token token operator">=</span><span>nyti.ms</span></code></pre></div></div></div><div><label class="CodeSyntaxSelector_header__6P_Jc"><span>Response</span><div class="Select_wrapper__58utF"><select class="Select_select__qXz_Z" aria-label="Select" autocomplete="off"><option value="200" selected="">200 SUCCESS</option><option value="400">400 BAD_REQUEST</option><option value="402">402 UPGRADE_REQUIRED</option><option value="403">403 FORBIDDEN</option><option value="404">404 NOT_FOUND</option><option value="500">500 INTERNAL_ERROR</option><option value="503">503 TEMPORARILY_UNAVAILABLE</option></select><svg viewbox="0 0 8 14" xmlns="http://www.w3.org/2000/svg"><path d="M6.463 7 .987 1.66a.61.61 0 0 1 0-.878.648.648 0 0 1 .9 0L7.813 6.56a.61.61 0 0 1 0 .878l-5.926 5.78a.648.648 0 0 1-.9 0 .61.61 0 0 1 0-.879L6.463 7Z"></path></svg></div></label><div class="CodeSyntaxSelector_body__hBJ7j" tabindex="0"><div class="CodeBlock_codeBlock__KlURa"><pre tabindex="0" style="color:#36383b;font-family:ProximaNova, monospace;line-height:1.2;font-size:1rem"><code class="language-json" style="white-space:pre"><span class="token token punctuation">{</span><span> </span><span> </span><span class="token token property">"overrides"</span><span class="token token operator">:</span><span> </span><span class="token token punctuation">[</span><span> </span><span> </span><span class="token token punctuation">{</span><span> </span><span> </span><span class="token token property">"references"</span><span class="token token operator">:</span><span> </span><span class="token token punctuation">{</span><span> </span><span class="token token" style="color:#51763e">"any"</span><span> </span><span class="token token punctuation">}</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"id"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"rules"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"version"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"integer"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"created"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"modified"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"link"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"group_guid"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span> </span><span> </span><span class="token token punctuation">}</span><span> </span><span> </span><span class="token token punctuation">]</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"total_count"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"integer"</span><span> </span><span></span><span class="token token punctuation">}</span></code></pre></div></div></div></div></div><div class="MethodDetail_methodContainer__3EF7h" id="getBSDs"><div class="MethodDetail_method__fyEiw"><div><h3 class="MethodHeader_h3__seOfC">Get BSDs</h3><h4 class="MethodHeader_description__3_p_p"><div class="MethodHeader_iconStyle__x5Ow4"><svg viewbox="0 0 14 6" xmlns="http://www.w3.org/2000/svg" class="IconRest_restIcon__3pju8 get"><title>Get</title><path d="M2.587 6c.307 0 .607-.044.9-.132.295-.088.533-.217.716-.387V2.876H2.271v.825h1.027v1.145a.772.772 0 0 1-.239.1 1.4 1.4 0 0 1-.383.049 1.338 1.338 0 0 1-1.083-.52c-.135-.17-.24-.379-.316-.626a2.879 2.879 0 0 1-.113-.84c0-.352.038-.655.113-.907.076-.253.182-.46.32-.623.137-.162.3-.281.488-.358a1.783 1.783 0 0 1 .97-.082l.13.032v.915h.889V.28a3.182 3.182 0 0 0-.59-.202A3.507 3.507 0 0 0 2.676 0c-.313 0-.628.055-.946.165a2.4 2.4 0 0 0-.861.523 2.707 2.707 0 0 0-.627.92C.081 1.98 0 2.433 0 2.966c0 .506.067.946.202 1.323.135.376.318.692.55.948a2.2 2.2 0 0 0 .82.572A2.7 2.7 0 0 0 2.587 6Zm6.24-.115V4.879H6.184V3.47h2.4V2.465h-2.4V1.121h2.602V.115h-3.71v5.77h3.75Zm4.43 0v-.907h-.914V1.022h.768v.997H14V.115H9.57V2.02h.89v-.997h.776v3.956h-.922v.907h2.942Z"></path></svg></div> /v4/bsds</h4><p class="MethodHeader_description__3_p_p">Fetch all Branded Short Domains</p></div></div><div class="MethodDetail_examples__8nXeM"><div><label class="CodeSyntaxSelector_header__6P_Jc CodeSyntaxSelector_headerDark__hI3A0"><span>Request</span><div class="Select_wrapper__58utF Select_dark__KPIws"><select class="Select_select__qXz_Z Select_dark__KPIws" aria-label="Select" autocomplete="off"><option value="cURL" selected="">cURL</option><option value="Node">Node</option><option value="Browser">Browser</option><option value="Go">Go</option><option value="Python">Python</option></select><svg viewbox="0 0 8 14" xmlns="http://www.w3.org/2000/svg"><path d="M6.463 7 .987 1.66a.61.61 0 0 1 0-.878.648.648 0 0 1 .9 0L7.813 6.56a.61.61 0 0 1 0 .878l-5.926 5.78a.648.648 0 0 1-.9 0 .61.61 0 0 1 0-.879L6.463 7Z"></path></svg></div></label><div class="CodeSyntaxSelector_body__hBJ7j CodeSyntaxSelector_bodyDark__cizVw" tabindex="0"><div class="CodeBlock_codeBlock__KlURa"><pre tabindex="0" style="color:#ffffff;font-family:ProximaNova, monospace;line-height:1.2;font-size:1rem"><code class="language-bash" style="white-space:pre"><span class="token token" style="color:#ee6123">curl</span><span> </span><span class="token token punctuation">\</span><span> </span><span>-H </span><span class="token token" style="color:#acda95">'Authorization: Bearer {TOKEN}'</span><span> </span><span class="token token punctuation">\</span><span> </span><span>-X GET </span><span class="token token punctuation">\</span><span> </span>https://api-ssl.bitly.com/v4/bsds</code></pre></div></div></div><div><label class="CodeSyntaxSelector_header__6P_Jc"><span>Response</span><div class="Select_wrapper__58utF"><select class="Select_select__qXz_Z" aria-label="Select" autocomplete="off"><option value="200" selected="">200 SUCCESS</option><option value="400">400 BAD_REQUEST</option><option value="403">403 FORBIDDEN</option><option value="500">500 INTERNAL_ERROR</option><option value="503">503 TEMPORARILY_UNAVAILABLE</option></select><svg viewbox="0 0 8 14" xmlns="http://www.w3.org/2000/svg"><path d="M6.463 7 .987 1.66a.61.61 0 0 1 0-.878.648.648 0 0 1 .9 0L7.813 6.56a.61.61 0 0 1 0 .878l-5.926 5.78a.648.648 0 0 1-.9 0 .61.61 0 0 1 0-.879L6.463 7Z"></path></svg></div></label><div class="CodeSyntaxSelector_body__hBJ7j" tabindex="0"><div class="CodeBlock_codeBlock__KlURa"><pre tabindex="0" style="color:#36383b;font-family:ProximaNova, monospace;line-height:1.2;font-size:1rem"><code class="language-json" style="white-space:pre"><span class="token token punctuation">{</span><span> </span><span> </span><span class="token token property">"bsds"</span><span class="token token operator">:</span><span> </span><span class="token token punctuation">[</span><span> </span><span> </span><span class="token token" style="color:#51763e">"string"</span><span> </span><span> </span><span class="token token punctuation">]</span><span> </span><span></span><span class="token token punctuation">}</span></code></pre></div></div></div></div></div><div class="ApiReference_tagInfo__YVbgw"><h2 class="ApiReference_tagName__IJx2p">Campaigns</h2><p class="ApiReference_tagDescription__8c1GM">Bitly Campaigns are used to build and organize links and metrics for marketing campaigns. </p></div><div class="MethodDetail_methodContainer__3EF7h" id="getCampaigns"><div class="MethodDetail_method__fyEiw"><div><h3 class="MethodHeader_h3__seOfC">Retrieve Campaigns</h3><h4 class="MethodHeader_description__3_p_p"><div class="MethodHeader_iconStyle__x5Ow4"><svg viewbox="0 0 14 6" xmlns="http://www.w3.org/2000/svg" class="IconRest_restIcon__3pju8 get"><title>Get</title><path d="M2.587 6c.307 0 .607-.044.9-.132.295-.088.533-.217.716-.387V2.876H2.271v.825h1.027v1.145a.772.772 0 0 1-.239.1 1.4 1.4 0 0 1-.383.049 1.338 1.338 0 0 1-1.083-.52c-.135-.17-.24-.379-.316-.626a2.879 2.879 0 0 1-.113-.84c0-.352.038-.655.113-.907.076-.253.182-.46.32-.623.137-.162.3-.281.488-.358a1.783 1.783 0 0 1 .97-.082l.13.032v.915h.889V.28a3.182 3.182 0 0 0-.59-.202A3.507 3.507 0 0 0 2.676 0c-.313 0-.628.055-.946.165a2.4 2.4 0 0 0-.861.523 2.707 2.707 0 0 0-.627.92C.081 1.98 0 2.433 0 2.966c0 .506.067.946.202 1.323.135.376.318.692.55.948a2.2 2.2 0 0 0 .82.572A2.7 2.7 0 0 0 2.587 6Zm6.24-.115V4.879H6.184V3.47h2.4V2.465h-2.4V1.121h2.602V.115h-3.71v5.77h3.75Zm4.43 0v-.907h-.914V1.022h.768v.997H14V.115H9.57V2.02h.89v-.997h.776v3.956h-.922v.907h2.942Z"></path></svg></div> /v4/campaigns</h4><p class="MethodHeader_description__3_p_p">Returns the campaigns for the current authenticated user.</p></div><div><h4 class="ParameterList_h4__nH9G8 ParameterList_dividing__wRGRx">Query Parameters</h4><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">group_guid</span><span class="Parameter_type__djM_s">string</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">A GUID for a Bitly group</div></div></div></div><div class="MethodDetail_examples__8nXeM"><div><label class="CodeSyntaxSelector_header__6P_Jc CodeSyntaxSelector_headerDark__hI3A0"><span>Request</span><div class="Select_wrapper__58utF Select_dark__KPIws"><select class="Select_select__qXz_Z Select_dark__KPIws" aria-label="Select" autocomplete="off"><option value="cURL" selected="">cURL</option><option value="Node">Node</option><option value="Browser">Browser</option><option value="Go">Go</option><option value="Python">Python</option></select><svg viewbox="0 0 8 14" xmlns="http://www.w3.org/2000/svg"><path d="M6.463 7 .987 1.66a.61.61 0 0 1 0-.878.648.648 0 0 1 .9 0L7.813 6.56a.61.61 0 0 1 0 .878l-5.926 5.78a.648.648 0 0 1-.9 0 .61.61 0 0 1 0-.879L6.463 7Z"></path></svg></div></label><div class="CodeSyntaxSelector_body__hBJ7j CodeSyntaxSelector_bodyDark__cizVw" tabindex="0"><div class="CodeBlock_codeBlock__KlURa"><pre tabindex="0" style="color:#ffffff;font-family:ProximaNova, monospace;line-height:1.2;font-size:1rem"><code class="language-bash" style="white-space:pre"><span class="token token" style="color:#ee6123">curl</span><span> </span><span class="token token punctuation">\</span><span> </span><span>-H </span><span class="token token" style="color:#acda95">'Authorization: Bearer {TOKEN}'</span><span> </span><span class="token token punctuation">\</span><span> </span><span>-X GET </span><span class="token token punctuation">\</span><span> </span><span>https://api-ssl.bitly.com/v4/campaigns?group_guid</span><span class="token token operator">=</span><span>Ba1bc23dE4F</span></code></pre></div></div></div><div><label class="CodeSyntaxSelector_header__6P_Jc"><span>Response</span><div class="Select_wrapper__58utF"><select class="Select_select__qXz_Z" aria-label="Select" autocomplete="off"><option value="200" selected="">200 SUCCESS</option><option value="400">400 BAD_REQUEST</option><option value="402">402 UPGRADE_REQUIRED</option><option value="403">403 FORBIDDEN</option><option value="404">404 NOT_FOUND</option><option value="500">500 INTERNAL_ERROR</option><option value="502">502 BAD_GATEWAY</option><option value="503">503 TEMPORARILY_UNAVAILABLE</option></select><svg viewbox="0 0 8 14" xmlns="http://www.w3.org/2000/svg"><path d="M6.463 7 .987 1.66a.61.61 0 0 1 0-.878.648.648 0 0 1 .9 0L7.813 6.56a.61.61 0 0 1 0 .878l-5.926 5.78a.648.648 0 0 1-.9 0 .61.61 0 0 1 0-.879L6.463 7Z"></path></svg></div></label><div class="CodeSyntaxSelector_body__hBJ7j" tabindex="0"><div class="CodeBlock_codeBlock__KlURa"><pre tabindex="0" style="color:#36383b;font-family:ProximaNova, monospace;line-height:1.2;font-size:1rem"><code class="language-json" style="white-space:pre"><span class="token token punctuation">{</span><span> </span><span> </span><span class="token token property">"campaigns"</span><span class="token token operator">:</span><span> </span><span class="token token punctuation">[</span><span> </span><span> </span><span class="token token punctuation">{</span><span> </span><span> </span><span class="token token property">"references"</span><span class="token token operator">:</span><span> </span><span class="token token punctuation">{</span><span> </span><span class="token token" style="color:#51763e">"any"</span><span> </span><span class="token token punctuation">}</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"guid"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"group_guid"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"created_by"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"name"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"description"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"created"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"modified"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span> </span><span> </span><span class="token token punctuation">}</span><span> </span><span> </span><span class="token token punctuation">]</span><span> </span><span></span><span class="token token punctuation">}</span></code></pre></div></div></div></div></div><div class="MethodDetail_methodContainer__3EF7h" id="createCampaign"><div class="MethodDetail_method__fyEiw"><div><h3 class="MethodHeader_h3__seOfC">Create Campaign</h3><h4 class="MethodHeader_description__3_p_p"><div class="MethodHeader_iconStyle__x5Ow4"><svg viewbox="0 0 18 6" xmlns="http://www.w3.org/2000/svg" class="IconRest_restIcon__3pju8 post"><title>Post</title><path d="M1.072 5.885V3.898c.026.006.069.011.129.017a3.88 3.88 0 0 0 .364.016h.125c.27 0 .533-.037.786-.11.253-.075.478-.193.677-.355.198-.162.357-.368.477-.618s.18-.551.18-.903c0-.401-.07-.727-.208-.977a1.592 1.592 0 0 0-.536-.585 1.971 1.971 0 0 0-.739-.28 4.854 4.854 0 0 0-.817-.07C1.249.033.987.045.724.07.46.095.219.13 0 .173v5.712h1.072Zm.461-2.934h-.098a2.344 2.344 0 0 1-.27-.017.818.818 0 0 1-.093-.016V1.047c.057-.011.133-.02.227-.03.093-.007.193-.012.297-.012.135 0 .268.014.399.042.13.027.246.077.348.148a.796.796 0 0 1 .246.284.954.954 0 0 1 .094.45c0 .214-.032.387-.098.519a.782.782 0 0 1-.262.309c-.11.074-.233.125-.371.152a2.141 2.141 0 0 1-.419.042ZM6.47 6c.694 0 1.212-.265 1.553-.795.342-.53.513-1.265.513-2.205 0-.44-.038-.843-.114-1.212a2.872 2.872 0 0 0-.36-.947 1.78 1.78 0 0 0-.637-.618C7.163.074 6.844 0 6.469 0c-.35 0-.653.069-.911.206a1.78 1.78 0 0 0-.645.59c-.172.255-.3.57-.384.943A5.804 5.804 0 0 0 4.404 3c0 .44.037.843.11 1.212.073.368.191.684.356.947.164.264.378.47.641.618.263.149.583.223.958.223Zm0-1.005c-.203 0-.366-.053-.489-.157a.989.989 0 0 1-.281-.425 2.57 2.57 0 0 1-.133-.63A8.129 8.129 0 0 1 5.53 3c0-.66.065-1.157.195-1.492.13-.335.378-.503.743-.503.209 0 .376.054.501.161a1 1 0 0 1 .286.433c.065.181.106.393.125.635.018.241.027.497.027.766 0 .34-.014.636-.043.886-.029.25-.08.457-.152.622a.826.826 0 0 1-.29.367.803.803 0 0 1-.454.12ZM10.991 6c.297 0 .574-.037.83-.111.255-.074.476-.187.664-.338.188-.151.334-.338.438-.56.104-.223.157-.483.157-.78 0-.307-.067-.563-.2-.766a1.814 1.814 0 0 0-.493-.507 3.3 3.3 0 0 0-.641-.342 11.165 11.165 0 0 1-.642-.28 2.185 2.185 0 0 1-.493-.313.562.562 0 0 1-.199-.445c0-.176.072-.316.215-.42.144-.105.34-.157.59-.157a2.757 2.757 0 0 1 .767.107.14.14 0 0 0 .047.008v.915h.86V.338a2.45 2.45 0 0 0-.735-.247C11.85.03 11.536 0 11.218 0c-.282 0-.537.041-.767.124-.23.082-.426.197-.59.346A1.557 1.557 0 0 0 9.476 1a1.66 1.66 0 0 0-.137.68c0 .324.067.588.2.792.133.203.297.372.493.506.195.135.409.246.641.334.232.088.446.176.642.264.195.088.36.19.492.305.133.115.2.266.2.453 0 .209-.081.375-.243.499-.161.123-.388.185-.68.185-.162 0-.314-.018-.458-.053a2.256 2.256 0 0 1-.395-.136l-.047-.017v-.816h-.86V5.53c.067.039.156.085.266.14.11.055.236.107.379.157.143.05.3.09.47.124.169.033.353.049.55.049Zm6.29-.115v-.907h-.885V1.022h.744v.997H18V.115h-4.287V2.02h.86v-.997h.752v3.956h-.892v.907h2.847Z"></path></svg></div> /v4/campaigns</h4><p class="MethodHeader_description__3_p_p">Creates a new campaign.</p></div><div><h4 class="ParameterList_h4__nH9G8 ParameterList_dividing__wRGRx">Request Body Schema</h4><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">group_guid</span><span class="Parameter_type__djM_s">string</span></div></div><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">name</span><span class="Parameter_type__djM_s">string</span></div></div><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">description</span><span class="Parameter_type__djM_s">string</span></div></div><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">channel_guids</span><span class="Parameter_type__djM_s">array of string</span></div></div></div></div><div class="MethodDetail_examples__8nXeM"><div><label class="CodeSyntaxSelector_header__6P_Jc CodeSyntaxSelector_headerDark__hI3A0"><span>Request</span><div class="Select_wrapper__58utF Select_dark__KPIws"><select class="Select_select__qXz_Z Select_dark__KPIws" aria-label="Select" autocomplete="off"><option value="cURL" selected="">cURL</option><option value="Node">Node</option><option value="Browser">Browser</option><option value="Go">Go</option><option value="Python">Python</option></select><svg viewbox="0 0 8 14" xmlns="http://www.w3.org/2000/svg"><path d="M6.463 7 .987 1.66a.61.61 0 0 1 0-.878.648.648 0 0 1 .9 0L7.813 6.56a.61.61 0 0 1 0 .878l-5.926 5.78a.648.648 0 0 1-.9 0 .61.61 0 0 1 0-.879L6.463 7Z"></path></svg></div></label><div class="CodeSyntaxSelector_body__hBJ7j CodeSyntaxSelector_bodyDark__cizVw" tabindex="0"><div class="CodeBlock_codeBlock__KlURa"><pre tabindex="0" style="color:#ffffff;font-family:ProximaNova, monospace;line-height:1.2;font-size:1rem"><code class="language-bash" style="white-space:pre"><span class="token token" style="color:#ee6123">curl</span><span> </span><span class="token token punctuation">\</span><span> </span><span>-H </span><span class="token token" style="color:#acda95">'Authorization: Bearer {TOKEN}'</span><span> </span><span class="token token punctuation">\</span><span> </span><span>-H </span><span class="token token" style="color:#acda95">'Content-Type: application/json'</span><span> </span><span class="token token punctuation">\</span><span> </span><span>-X POST </span><span class="token token punctuation">\</span><span> </span><span>-d </span><span class="token token" style="color:#acda95">'{ </span><span class="token token" style="color:#acda95"> "group_guid": "Ba1bc23dE4F", </span><span class="token token" style="color:#acda95"> "name": "My Campaign", </span><span class="token token" style="color:#acda95"> "description": "my new campaign", </span><span class="token token" style="color:#acda95"> "channel_guids": [ </span><span class="token token" style="color:#acda95"> "Ha1bc2DefGj", </span><span class="token token" style="color:#acda95"> "Ha1bc2DefGk" </span><span class="token token" style="color:#acda95"> ] </span><span class="token token" style="color:#acda95">}'</span><span> </span><span class="token token punctuation">\</span><span> </span>https://api-ssl.bitly.com/v4/campaigns</code></pre></div></div></div><div><label class="CodeSyntaxSelector_header__6P_Jc"><span>Response</span><div class="Select_wrapper__58utF"><select class="Select_select__qXz_Z" aria-label="Select" autocomplete="off"><option value="200" selected="">200 SUCCESS</option><option value="400">400 BAD_REQUEST</option><option value="402">402 UPGRADE_REQUIRED</option><option value="403">403 FORBIDDEN</option><option value="404">404 NOT_FOUND</option><option value="422">422 UNPROCESSABLE_ENTITY</option><option value="500">500 INTERNAL_ERROR</option><option value="503">503 TEMPORARILY_UNAVAILABLE</option></select><svg viewbox="0 0 8 14" xmlns="http://www.w3.org/2000/svg"><path d="M6.463 7 .987 1.66a.61.61 0 0 1 0-.878.648.648 0 0 1 .9 0L7.813 6.56a.61.61 0 0 1 0 .878l-5.926 5.78a.648.648 0 0 1-.9 0 .61.61 0 0 1 0-.879L6.463 7Z"></path></svg></div></label><div class="CodeSyntaxSelector_body__hBJ7j" tabindex="0"><div class="CodeBlock_codeBlock__KlURa"><pre tabindex="0" style="color:#36383b;font-family:ProximaNova, monospace;line-height:1.2;font-size:1rem"><code class="language-json" style="white-space:pre"><span class="token token punctuation">{</span><span> </span><span> </span><span class="token token property">"references"</span><span class="token token operator">:</span><span> </span><span class="token token punctuation">{</span><span> </span><span class="token token" style="color:#51763e">"any"</span><span> </span><span class="token token punctuation">}</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"guid"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"group_guid"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"created_by"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"name"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"description"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"created"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"modified"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span> </span><span></span><span class="token token punctuation">}</span></code></pre></div></div></div></div></div><div class="MethodDetail_methodContainer__3EF7h" id="getCampaign"><div class="MethodDetail_method__fyEiw"><div><h3 class="MethodHeader_h3__seOfC">Retrieve a Campaign</h3><h4 class="MethodHeader_description__3_p_p"><div class="MethodHeader_iconStyle__x5Ow4"><svg viewbox="0 0 14 6" xmlns="http://www.w3.org/2000/svg" class="IconRest_restIcon__3pju8 get"><title>Get</title><path d="M2.587 6c.307 0 .607-.044.9-.132.295-.088.533-.217.716-.387V2.876H2.271v.825h1.027v1.145a.772.772 0 0 1-.239.1 1.4 1.4 0 0 1-.383.049 1.338 1.338 0 0 1-1.083-.52c-.135-.17-.24-.379-.316-.626a2.879 2.879 0 0 1-.113-.84c0-.352.038-.655.113-.907.076-.253.182-.46.32-.623.137-.162.3-.281.488-.358a1.783 1.783 0 0 1 .97-.082l.13.032v.915h.889V.28a3.182 3.182 0 0 0-.59-.202A3.507 3.507 0 0 0 2.676 0c-.313 0-.628.055-.946.165a2.4 2.4 0 0 0-.861.523 2.707 2.707 0 0 0-.627.92C.081 1.98 0 2.433 0 2.966c0 .506.067.946.202 1.323.135.376.318.692.55.948a2.2 2.2 0 0 0 .82.572A2.7 2.7 0 0 0 2.587 6Zm6.24-.115V4.879H6.184V3.47h2.4V2.465h-2.4V1.121h2.602V.115h-3.71v5.77h3.75Zm4.43 0v-.907h-.914V1.022h.768v.997H14V.115H9.57V2.02h.89v-.997h.776v3.956h-.922v.907h2.942Z"></path></svg></div> /v4/campaigns/{campaign_guid}</h4><p class="MethodHeader_description__3_p_p">Returns details for a campaign.</p></div><div><h4 class="ParameterList_h4__nH9G8 ParameterList_dividing__wRGRx">Path Parameters</h4><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">campaign_guid</span><span class="Parameter_type__djM_s">string</span><span class="Parameter_required__pcK_H">Required</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">A GUID for a Bitly campaign</div></div></div></div><div class="MethodDetail_examples__8nXeM"><div><label class="CodeSyntaxSelector_header__6P_Jc CodeSyntaxSelector_headerDark__hI3A0"><span>Request</span><div class="Select_wrapper__58utF Select_dark__KPIws"><select class="Select_select__qXz_Z Select_dark__KPIws" aria-label="Select" autocomplete="off"><option value="cURL" selected="">cURL</option><option value="Node">Node</option><option value="Browser">Browser</option><option value="Go">Go</option><option value="Python">Python</option></select><svg viewbox="0 0 8 14" xmlns="http://www.w3.org/2000/svg"><path d="M6.463 7 .987 1.66a.61.61 0 0 1 0-.878.648.648 0 0 1 .9 0L7.813 6.56a.61.61 0 0 1 0 .878l-5.926 5.78a.648.648 0 0 1-.9 0 .61.61 0 0 1 0-.879L6.463 7Z"></path></svg></div></label><div class="CodeSyntaxSelector_body__hBJ7j CodeSyntaxSelector_bodyDark__cizVw" tabindex="0"><div class="CodeBlock_codeBlock__KlURa"><pre tabindex="0" style="color:#ffffff;font-family:ProximaNova, monospace;line-height:1.2;font-size:1rem"><code class="language-bash" style="white-space:pre"><span class="token token" style="color:#ee6123">curl</span><span> </span><span class="token token punctuation">\</span><span> </span><span>-H </span><span class="token token" style="color:#acda95">'Authorization: Bearer {TOKEN}'</span><span> </span><span class="token token punctuation">\</span><span> </span><span>-X GET </span><span class="token token punctuation">\</span><span> </span>https://api-ssl.bitly.com/v4/campaigns/Ca1bcd2EFGh</code></pre></div></div></div><div><label class="CodeSyntaxSelector_header__6P_Jc"><span>Response</span><div class="Select_wrapper__58utF"><select class="Select_select__qXz_Z" aria-label="Select" autocomplete="off"><option value="200" selected="">200 SUCCESS</option><option value="402">402 UPGRADE_REQUIRED</option><option value="403">403 FORBIDDEN</option><option value="404">404 NOT_FOUND</option><option value="500">500 INTERNAL_ERROR</option><option value="503">503 TEMPORARILY_UNAVAILABLE</option></select><svg viewbox="0 0 8 14" xmlns="http://www.w3.org/2000/svg"><path d="M6.463 7 .987 1.66a.61.61 0 0 1 0-.878.648.648 0 0 1 .9 0L7.813 6.56a.61.61 0 0 1 0 .878l-5.926 5.78a.648.648 0 0 1-.9 0 .61.61 0 0 1 0-.879L6.463 7Z"></path></svg></div></label><div class="CodeSyntaxSelector_body__hBJ7j" tabindex="0"><div class="CodeBlock_codeBlock__KlURa"><pre tabindex="0" style="color:#36383b;font-family:ProximaNova, monospace;line-height:1.2;font-size:1rem"><code class="language-json" style="white-space:pre"><span class="token token punctuation">{</span><span> </span><span> </span><span class="token token property">"references"</span><span class="token token operator">:</span><span> </span><span class="token token punctuation">{</span><span> </span><span class="token token" style="color:#51763e">"any"</span><span> </span><span class="token token punctuation">}</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"guid"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"group_guid"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"created_by"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"name"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"description"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"created"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"modified"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span> </span><span></span><span class="token token punctuation">}</span></code></pre></div></div></div></div></div><div class="MethodDetail_methodContainer__3EF7h" id="updateCampaign"><div class="MethodDetail_method__fyEiw"><div><h3 class="MethodHeader_h3__seOfC">Update Campaign</h3><h4 class="MethodHeader_description__3_p_p"><div class="MethodHeader_iconStyle__x5Ow4"><svg viewbox="0 0 23 6" xmlns="http://www.w3.org/2000/svg" class="IconRest_restIcon__3pju8 patch"><title>Patch</title><path d="M1.095 5.885V3.898c.027.006.07.011.132.017a4.052 4.052 0 0 0 .372.016h.128c.277 0 .545-.037.803-.11.259-.075.49-.193.692-.355.202-.162.365-.368.487-.618.123-.25.184-.551.184-.903 0-.401-.07-.727-.212-.977a1.606 1.606 0 0 0-.547-.585 2.041 2.041 0 0 0-.756-.28 5.067 5.067 0 0 0-.835-.07c-.267 0-.534.012-.804.037C.47.095.224.13 0 .173v5.712h1.095Zm.472-2.934h-.1a2.448 2.448 0 0 1-.276-.017.853.853 0 0 1-.096-.016V1.047c.059-.011.136-.02.232-.03.096-.007.197-.012.304-.012.138 0 .274.014.408.042a.964.964 0 0 1 .355.148.801.801 0 0 1 .252.284.937.937 0 0 1 .096.45c0 .214-.033.387-.1.519a.787.787 0 0 1-.268.309 1.038 1.038 0 0 1-.38.152 2.235 2.235 0 0 1-.427.042Zm3.79 2.934.383-1.278h1.67l.4 1.278h1.152L7.163.115H6.068L4.26 5.885h1.095ZM7.194 3.7h-1.2l.56-1.929h.072l.568 1.929Zm5.668 2.184v-.907h-.903V1.022h.76v.997h.879V.115H9.218V2.02h.879v-.997h.767v3.956h-.91v.907h2.91Zm3.91.115c.276 0 .547-.036.81-.107.265-.072.482-.17.652-.297V3.948h-.88v.997c-.164.033-.335.05-.51.05-.246 0-.464-.049-.656-.145a1.383 1.383 0 0 1-.488-.408 1.881 1.881 0 0 1-.304-.63A2.973 2.973 0 0 1 15.293 3c0-.34.038-.636.112-.886.075-.25.179-.457.312-.622.133-.165.29-.287.468-.367.178-.08.371-.12.58-.12.175 0 .346.014.511.042v.94h.88V.271a2.727 2.727 0 0 0-.548-.19A3.419 3.419 0 0 0 16.796 0c-.303 0-.613.05-.927.152-.314.102-.6.27-.855.503a2.611 2.611 0 0 0-.628.923c-.163.382-.244.856-.244 1.422 0 .544.072 1.007.216 1.389.144.382.336.692.576.931.24.24.518.412.835.52.317.106.652.16 1.003.16Zm3.325-.115V3.47h1.807v2.415H23V.115h-1.095v2.35h-1.807V.114h-1.095v5.77h1.095Z"></path></svg></div> /v4/campaigns/{campaign_guid}</h4><p class="MethodHeader_description__3_p_p">Updates a campaign's details.</p></div><div><h4 class="ParameterList_h4__nH9G8 ParameterList_dividing__wRGRx">Path Parameters</h4><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">campaign_guid</span><span class="Parameter_type__djM_s">string</span><span class="Parameter_required__pcK_H">Required</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">A GUID for a Bitly campaign</div></div></div><div><h4 class="ParameterList_h4__nH9G8 ParameterList_dividing__wRGRx">Request Body Schema</h4><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">group_guid</span><span class="Parameter_type__djM_s">string</span></div></div><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">name</span><span class="Parameter_type__djM_s">string</span></div></div><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">description</span><span class="Parameter_type__djM_s">string</span></div></div><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">channel_guids</span><span class="Parameter_type__djM_s">array of string</span></div></div></div></div><div class="MethodDetail_examples__8nXeM"><div><label class="CodeSyntaxSelector_header__6P_Jc CodeSyntaxSelector_headerDark__hI3A0"><span>Request</span><div class="Select_wrapper__58utF Select_dark__KPIws"><select class="Select_select__qXz_Z Select_dark__KPIws" aria-label="Select" autocomplete="off"><option value="cURL" selected="">cURL</option><option value="Node">Node</option><option value="Browser">Browser</option><option value="Go">Go</option><option value="Python">Python</option></select><svg viewbox="0 0 8 14" xmlns="http://www.w3.org/2000/svg"><path d="M6.463 7 .987 1.66a.61.61 0 0 1 0-.878.648.648 0 0 1 .9 0L7.813 6.56a.61.61 0 0 1 0 .878l-5.926 5.78a.648.648 0 0 1-.9 0 .61.61 0 0 1 0-.879L6.463 7Z"></path></svg></div></label><div class="CodeSyntaxSelector_body__hBJ7j CodeSyntaxSelector_bodyDark__cizVw" tabindex="0"><div class="CodeBlock_codeBlock__KlURa"><pre tabindex="0" style="color:#ffffff;font-family:ProximaNova, monospace;line-height:1.2;font-size:1rem"><code class="language-bash" style="white-space:pre"><span class="token token" style="color:#ee6123">curl</span><span> </span><span class="token token punctuation">\</span><span> </span><span>-H </span><span class="token token" style="color:#acda95">'Authorization: Bearer {TOKEN}'</span><span> </span><span class="token token punctuation">\</span><span> </span><span>-H </span><span class="token token" style="color:#acda95">'Content-Type: application/json'</span><span> </span><span class="token token punctuation">\</span><span> </span><span>-X PATCH </span><span class="token token punctuation">\</span><span> </span><span>-d </span><span class="token token" style="color:#acda95">'{ </span><span class="token token" style="color:#acda95"> "group_guid": "Ba1bc23dE4F", </span><span class="token token" style="color:#acda95"> "name": "My Campaign", </span><span class="token token" style="color:#acda95"> "description": "my new campaign", </span><span class="token token" style="color:#acda95"> "channel_guids": [ </span><span class="token token" style="color:#acda95"> "Ha1bc2DefGj", </span><span class="token token" style="color:#acda95"> "Ha1bc2DefGk" </span><span class="token token" style="color:#acda95"> ] </span><span class="token token" style="color:#acda95">}'</span><span> </span><span class="token token punctuation">\</span><span> </span>https://api-ssl.bitly.com/v4/campaigns/Ca1bcd2EFGh</code></pre></div></div></div><div><label class="CodeSyntaxSelector_header__6P_Jc"><span>Response</span><div class="Select_wrapper__58utF"><select class="Select_select__qXz_Z" aria-label="Select" autocomplete="off"><option value="200" selected="">200 SUCCESS</option><option value="400">400 BAD_REQUEST</option><option value="402">402 UPGRADE_REQUIRED</option><option value="403">403 FORBIDDEN</option><option value="404">404 NOT_FOUND</option><option value="422">422 UNPROCESSABLE_ENTITY</option><option value="500">500 INTERNAL_ERROR</option><option value="503">503 TEMPORARILY_UNAVAILABLE</option></select><svg viewbox="0 0 8 14" xmlns="http://www.w3.org/2000/svg"><path d="M6.463 7 .987 1.66a.61.61 0 0 1 0-.878.648.648 0 0 1 .9 0L7.813 6.56a.61.61 0 0 1 0 .878l-5.926 5.78a.648.648 0 0 1-.9 0 .61.61 0 0 1 0-.879L6.463 7Z"></path></svg></div></label><div class="CodeSyntaxSelector_body__hBJ7j" tabindex="0"><div class="CodeBlock_codeBlock__KlURa"><pre tabindex="0" style="color:#36383b;font-family:ProximaNova, monospace;line-height:1.2;font-size:1rem"><code class="language-json" style="white-space:pre"><span class="token token punctuation">{</span><span> </span><span> </span><span class="token token property">"references"</span><span class="token token operator">:</span><span> </span><span class="token token punctuation">{</span><span> </span><span class="token token" style="color:#51763e">"any"</span><span> </span><span class="token token punctuation">}</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"guid"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"group_guid"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"created_by"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"name"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"description"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"created"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"modified"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span> </span><span></span><span class="token token punctuation">}</span></code></pre></div></div></div></div></div><div class="MethodDetail_methodContainer__3EF7h" id="getChannels"><div class="MethodDetail_method__fyEiw"><div><h3 class="MethodHeader_h3__seOfC">Retrieve Channels</h3><h4 class="MethodHeader_description__3_p_p"><div class="MethodHeader_iconStyle__x5Ow4"><svg viewbox="0 0 14 6" xmlns="http://www.w3.org/2000/svg" class="IconRest_restIcon__3pju8 get"><title>Get</title><path d="M2.587 6c.307 0 .607-.044.9-.132.295-.088.533-.217.716-.387V2.876H2.271v.825h1.027v1.145a.772.772 0 0 1-.239.1 1.4 1.4 0 0 1-.383.049 1.338 1.338 0 0 1-1.083-.52c-.135-.17-.24-.379-.316-.626a2.879 2.879 0 0 1-.113-.84c0-.352.038-.655.113-.907.076-.253.182-.46.32-.623.137-.162.3-.281.488-.358a1.783 1.783 0 0 1 .97-.082l.13.032v.915h.889V.28a3.182 3.182 0 0 0-.59-.202A3.507 3.507 0 0 0 2.676 0c-.313 0-.628.055-.946.165a2.4 2.4 0 0 0-.861.523 2.707 2.707 0 0 0-.627.92C.081 1.98 0 2.433 0 2.966c0 .506.067.946.202 1.323.135.376.318.692.55.948a2.2 2.2 0 0 0 .82.572A2.7 2.7 0 0 0 2.587 6Zm6.24-.115V4.879H6.184V3.47h2.4V2.465h-2.4V1.121h2.602V.115h-3.71v5.77h3.75Zm4.43 0v-.907h-.914V1.022h.768v.997H14V.115H9.57V2.02h.89v-.997h.776v3.956h-.922v.907h2.942Z"></path></svg></div> /v4/channels</h4><p class="MethodHeader_description__3_p_p">Returns the channels available to a user.</p></div><div><h4 class="ParameterList_h4__nH9G8 ParameterList_dividing__wRGRx">Query Parameters</h4><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">group_guid</span><span class="Parameter_type__djM_s">string</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">A GUID for a Bitly group</div></div><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">campaign_guid</span><span class="Parameter_type__djM_s">string</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">A GUID for a Bitly campaign</div></div></div></div><div class="MethodDetail_examples__8nXeM"><div><label class="CodeSyntaxSelector_header__6P_Jc CodeSyntaxSelector_headerDark__hI3A0"><span>Request</span><div class="Select_wrapper__58utF Select_dark__KPIws"><select class="Select_select__qXz_Z Select_dark__KPIws" aria-label="Select" autocomplete="off"><option value="cURL" selected="">cURL</option><option value="Node">Node</option><option value="Browser">Browser</option><option value="Go">Go</option><option value="Python">Python</option></select><svg viewbox="0 0 8 14" xmlns="http://www.w3.org/2000/svg"><path d="M6.463 7 .987 1.66a.61.61 0 0 1 0-.878.648.648 0 0 1 .9 0L7.813 6.56a.61.61 0 0 1 0 .878l-5.926 5.78a.648.648 0 0 1-.9 0 .61.61 0 0 1 0-.879L6.463 7Z"></path></svg></div></label><div class="CodeSyntaxSelector_body__hBJ7j CodeSyntaxSelector_bodyDark__cizVw" tabindex="0"><div class="CodeBlock_codeBlock__KlURa"><pre tabindex="0" style="color:#ffffff;font-family:ProximaNova, monospace;line-height:1.2;font-size:1rem"><code class="language-bash" style="white-space:pre"><span class="token token" style="color:#ee6123">curl</span><span> </span><span class="token token punctuation">\</span><span> </span><span>-H </span><span class="token token" style="color:#acda95">'Authorization: Bearer {TOKEN}'</span><span> </span><span class="token token punctuation">\</span><span> </span><span>-X GET </span><span class="token token punctuation">\</span><span> </span><span>https://api-ssl.bitly.com/v4/channels?group_guid</span><span class="token token operator">=</span><span>Ba1bc23dE4F</span><span class="token token operator">&</span><span class="token token assign-left variable">campaign_guid</span><span class="token token operator">=</span><span>Ca1bcd2EFGh</span></code></pre></div></div></div><div><label class="CodeSyntaxSelector_header__6P_Jc"><span>Response</span><div class="Select_wrapper__58utF"><select class="Select_select__qXz_Z" aria-label="Select" autocomplete="off"><option value="200" selected="">200 SUCCESS</option><option value="402">402 UPGRADE_REQUIRED</option><option value="403">403 FORBIDDEN</option><option value="404">404 NOT_FOUND</option><option value="500">500 INTERNAL_ERROR</option><option value="503">503 TEMPORARILY_UNAVAILABLE</option></select><svg viewbox="0 0 8 14" xmlns="http://www.w3.org/2000/svg"><path d="M6.463 7 .987 1.66a.61.61 0 0 1 0-.878.648.648 0 0 1 .9 0L7.813 6.56a.61.61 0 0 1 0 .878l-5.926 5.78a.648.648 0 0 1-.9 0 .61.61 0 0 1 0-.879L6.463 7Z"></path></svg></div></label><div class="CodeSyntaxSelector_body__hBJ7j" tabindex="0"><div class="CodeBlock_codeBlock__KlURa"><pre tabindex="0" style="color:#36383b;font-family:ProximaNova, monospace;line-height:1.2;font-size:1rem"><code class="language-json" style="white-space:pre"><span class="token token punctuation">{</span><span> </span><span> </span><span class="token token property">"channels"</span><span class="token token operator">:</span><span> </span><span class="token token punctuation">[</span><span> </span><span> </span><span class="token token punctuation">{</span><span> </span><span> </span><span class="token token property">"name"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"guid"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"created"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"modified"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"group_guid"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"references"</span><span class="token token operator">:</span><span> </span><span class="token token punctuation">{</span><span> </span><span class="token token" style="color:#51763e">"any"</span><span> </span><span class="token token punctuation">}</span><span> </span><span> </span><span class="token token punctuation">}</span><span> </span><span> </span><span class="token token punctuation">]</span><span> </span><span></span><span class="token token punctuation">}</span></code></pre></div></div></div></div></div><div class="MethodDetail_methodContainer__3EF7h" id="createChannel"><div class="MethodDetail_method__fyEiw"><div><h3 class="MethodHeader_h3__seOfC">Create Channel</h3><h4 class="MethodHeader_description__3_p_p"><div class="MethodHeader_iconStyle__x5Ow4"><svg viewbox="0 0 18 6" xmlns="http://www.w3.org/2000/svg" class="IconRest_restIcon__3pju8 post"><title>Post</title><path d="M1.072 5.885V3.898c.026.006.069.011.129.017a3.88 3.88 0 0 0 .364.016h.125c.27 0 .533-.037.786-.11.253-.075.478-.193.677-.355.198-.162.357-.368.477-.618s.18-.551.18-.903c0-.401-.07-.727-.208-.977a1.592 1.592 0 0 0-.536-.585 1.971 1.971 0 0 0-.739-.28 4.854 4.854 0 0 0-.817-.07C1.249.033.987.045.724.07.46.095.219.13 0 .173v5.712h1.072Zm.461-2.934h-.098a2.344 2.344 0 0 1-.27-.017.818.818 0 0 1-.093-.016V1.047c.057-.011.133-.02.227-.03.093-.007.193-.012.297-.012.135 0 .268.014.399.042.13.027.246.077.348.148a.796.796 0 0 1 .246.284.954.954 0 0 1 .094.45c0 .214-.032.387-.098.519a.782.782 0 0 1-.262.309c-.11.074-.233.125-.371.152a2.141 2.141 0 0 1-.419.042ZM6.47 6c.694 0 1.212-.265 1.553-.795.342-.53.513-1.265.513-2.205 0-.44-.038-.843-.114-1.212a2.872 2.872 0 0 0-.36-.947 1.78 1.78 0 0 0-.637-.618C7.163.074 6.844 0 6.469 0c-.35 0-.653.069-.911.206a1.78 1.78 0 0 0-.645.59c-.172.255-.3.57-.384.943A5.804 5.804 0 0 0 4.404 3c0 .44.037.843.11 1.212.073.368.191.684.356.947.164.264.378.47.641.618.263.149.583.223.958.223Zm0-1.005c-.203 0-.366-.053-.489-.157a.989.989 0 0 1-.281-.425 2.57 2.57 0 0 1-.133-.63A8.129 8.129 0 0 1 5.53 3c0-.66.065-1.157.195-1.492.13-.335.378-.503.743-.503.209 0 .376.054.501.161a1 1 0 0 1 .286.433c.065.181.106.393.125.635.018.241.027.497.027.766 0 .34-.014.636-.043.886-.029.25-.08.457-.152.622a.826.826 0 0 1-.29.367.803.803 0 0 1-.454.12ZM10.991 6c.297 0 .574-.037.83-.111.255-.074.476-.187.664-.338.188-.151.334-.338.438-.56.104-.223.157-.483.157-.78 0-.307-.067-.563-.2-.766a1.814 1.814 0 0 0-.493-.507 3.3 3.3 0 0 0-.641-.342 11.165 11.165 0 0 1-.642-.28 2.185 2.185 0 0 1-.493-.313.562.562 0 0 1-.199-.445c0-.176.072-.316.215-.42.144-.105.34-.157.59-.157a2.757 2.757 0 0 1 .767.107.14.14 0 0 0 .047.008v.915h.86V.338a2.45 2.45 0 0 0-.735-.247C11.85.03 11.536 0 11.218 0c-.282 0-.537.041-.767.124-.23.082-.426.197-.59.346A1.557 1.557 0 0 0 9.476 1a1.66 1.66 0 0 0-.137.68c0 .324.067.588.2.792.133.203.297.372.493.506.195.135.409.246.641.334.232.088.446.176.642.264.195.088.36.19.492.305.133.115.2.266.2.453 0 .209-.081.375-.243.499-.161.123-.388.185-.68.185-.162 0-.314-.018-.458-.053a2.256 2.256 0 0 1-.395-.136l-.047-.017v-.816h-.86V5.53c.067.039.156.085.266.14.11.055.236.107.379.157.143.05.3.09.47.124.169.033.353.049.55.049Zm6.29-.115v-.907h-.885V1.022h.744v.997H18V.115h-4.287V2.02h.86v-.997h.752v3.956h-.892v.907h2.847Z"></path></svg></div> /v4/channels</h4><p class="MethodHeader_description__3_p_p">Creates a new channel.</p></div><div><h4 class="ParameterList_h4__nH9G8 ParameterList_dividing__wRGRx">Request Body Schema</h4><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">name</span><span class="Parameter_type__djM_s">string</span></div></div><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">guid</span><span class="Parameter_type__djM_s">string</span></div></div><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">created</span><span class="Parameter_type__djM_s">string</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">ISO TIMESTAMP</div></div><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">modified</span><span class="Parameter_type__djM_s">string</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">ISO_TIMESTAMP</div></div><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">group_guid</span><span class="Parameter_type__djM_s">string</span></div></div><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">bitlinks</span><span class="Parameter_type__djM_s">array of object</span></div><div class="Parameter_nestedList__KmKgd"><div class="Parameter_nested__X3i_l"><div class="Parameter_parameter__J0LgW Parameter_compact__V5419"><div><span class="Parameter_name___UYgz">campaign_guid</span><span class="Parameter_type__djM_s">string</span></div></div></div><div class="Parameter_nested__X3i_l"><div class="Parameter_parameter__J0LgW Parameter_compact__V5419"><div><span class="Parameter_name___UYgz">bitlink_id</span><span class="Parameter_type__djM_s">string</span></div></div></div></div></div></div></div><div class="MethodDetail_examples__8nXeM"><div><label class="CodeSyntaxSelector_header__6P_Jc CodeSyntaxSelector_headerDark__hI3A0"><span>Request</span><div class="Select_wrapper__58utF Select_dark__KPIws"><select class="Select_select__qXz_Z Select_dark__KPIws" aria-label="Select" autocomplete="off"><option value="cURL" selected="">cURL</option><option value="Node">Node</option><option value="Browser">Browser</option><option value="Go">Go</option><option value="Python">Python</option></select><svg viewbox="0 0 8 14" xmlns="http://www.w3.org/2000/svg"><path d="M6.463 7 .987 1.66a.61.61 0 0 1 0-.878.648.648 0 0 1 .9 0L7.813 6.56a.61.61 0 0 1 0 .878l-5.926 5.78a.648.648 0 0 1-.9 0 .61.61 0 0 1 0-.879L6.463 7Z"></path></svg></div></label><div class="CodeSyntaxSelector_body__hBJ7j CodeSyntaxSelector_bodyDark__cizVw" tabindex="0"><div class="CodeBlock_codeBlock__KlURa"><pre tabindex="0" style="color:#ffffff;font-family:ProximaNova, monospace;line-height:1.2;font-size:1rem"><code class="language-bash" style="white-space:pre"><span class="token token" style="color:#ee6123">curl</span><span> </span><span class="token token punctuation">\</span><span> </span><span>-H </span><span class="token token" style="color:#acda95">'Authorization: Bearer {TOKEN}'</span><span> </span><span class="token token punctuation">\</span><span> </span><span>-H </span><span class="token token" style="color:#acda95">'Content-Type: application/json'</span><span> </span><span class="token token punctuation">\</span><span> </span><span>-X POST </span><span class="token token punctuation">\</span><span> </span><span>-d </span><span class="token token" style="color:#acda95">'{ </span><span class="token token" style="color:#acda95"> "name": "My Channel", </span><span class="token token" style="color:#acda95"> "guid": "Ha1bc2DefGh", </span><span class="token token" style="color:#acda95"> "group_guid": "Ba1bc23dE4F", </span><span class="token token" style="color:#acda95"> "bitlinks": [ </span><span class="token token" style="color:#acda95"> { </span><span class="token token" style="color:#acda95"> "campaign_guid": "Ca1bcd2EFGh", </span><span class="token token" style="color:#acda95"> "bitlink_id": "bit.ly/1234abcd" </span><span class="token token" style="color:#acda95"> } </span><span class="token token" style="color:#acda95"> ] </span><span class="token token" style="color:#acda95">}'</span><span> </span><span class="token token punctuation">\</span><span> </span>https://api-ssl.bitly.com/v4/channels</code></pre></div></div></div><div><label class="CodeSyntaxSelector_header__6P_Jc"><span>Response</span><div class="Select_wrapper__58utF"><select class="Select_select__qXz_Z" aria-label="Select" autocomplete="off"><option value="200" selected="">200 SUCCESS</option><option value="400">400 BAD_REQUEST</option><option value="402">402 UPGRADE_REQUIRED</option><option value="403">403 FORBIDDEN</option><option value="404">404 NOT_FOUND</option><option value="422">422 UNPROCESSABLE_ENTITY</option><option value="500">500 INTERNAL_ERROR</option><option value="503">503 TEMPORARILY_UNAVAILABLE</option></select><svg viewbox="0 0 8 14" xmlns="http://www.w3.org/2000/svg"><path d="M6.463 7 .987 1.66a.61.61 0 0 1 0-.878.648.648 0 0 1 .9 0L7.813 6.56a.61.61 0 0 1 0 .878l-5.926 5.78a.648.648 0 0 1-.9 0 .61.61 0 0 1 0-.879L6.463 7Z"></path></svg></div></label><div class="CodeSyntaxSelector_body__hBJ7j" tabindex="0"><div class="CodeBlock_codeBlock__KlURa"><pre tabindex="0" style="color:#36383b;font-family:ProximaNova, monospace;line-height:1.2;font-size:1rem"><code class="language-json" style="white-space:pre"><span class="token token punctuation">{</span><span> </span><span> </span><span class="token token property">"name"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"guid"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"created"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"modified"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"group_guid"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"references"</span><span class="token token operator">:</span><span> </span><span class="token token punctuation">{</span><span> </span><span class="token token" style="color:#51763e">"any"</span><span> </span><span class="token token punctuation">}</span><span> </span><span></span><span class="token token punctuation">}</span></code></pre></div></div></div></div></div><div class="MethodDetail_methodContainer__3EF7h" id="getChannel"><div class="MethodDetail_method__fyEiw"><div><h3 class="MethodHeader_h3__seOfC">Get a Channel</h3><h4 class="MethodHeader_description__3_p_p"><div class="MethodHeader_iconStyle__x5Ow4"><svg viewbox="0 0 14 6" xmlns="http://www.w3.org/2000/svg" class="IconRest_restIcon__3pju8 get"><title>Get</title><path d="M2.587 6c.307 0 .607-.044.9-.132.295-.088.533-.217.716-.387V2.876H2.271v.825h1.027v1.145a.772.772 0 0 1-.239.1 1.4 1.4 0 0 1-.383.049 1.338 1.338 0 0 1-1.083-.52c-.135-.17-.24-.379-.316-.626a2.879 2.879 0 0 1-.113-.84c0-.352.038-.655.113-.907.076-.253.182-.46.32-.623.137-.162.3-.281.488-.358a1.783 1.783 0 0 1 .97-.082l.13.032v.915h.889V.28a3.182 3.182 0 0 0-.59-.202A3.507 3.507 0 0 0 2.676 0c-.313 0-.628.055-.946.165a2.4 2.4 0 0 0-.861.523 2.707 2.707 0 0 0-.627.92C.081 1.98 0 2.433 0 2.966c0 .506.067.946.202 1.323.135.376.318.692.55.948a2.2 2.2 0 0 0 .82.572A2.7 2.7 0 0 0 2.587 6Zm6.24-.115V4.879H6.184V3.47h2.4V2.465h-2.4V1.121h2.602V.115h-3.71v5.77h3.75Zm4.43 0v-.907h-.914V1.022h.768v.997H14V.115H9.57V2.02h.89v-.997h.776v3.956h-.922v.907h2.942Z"></path></svg></div> /v4/channels/{channel_guid}</h4><p class="MethodHeader_description__3_p_p">Returns a channel's details.</p></div><div><h4 class="ParameterList_h4__nH9G8 ParameterList_dividing__wRGRx">Path Parameters</h4><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">channel_guid</span><span class="Parameter_type__djM_s">string</span><span class="Parameter_required__pcK_H">Required</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">A GUID for a Bitly Channel</div></div></div></div><div class="MethodDetail_examples__8nXeM"><div><label class="CodeSyntaxSelector_header__6P_Jc CodeSyntaxSelector_headerDark__hI3A0"><span>Request</span><div class="Select_wrapper__58utF Select_dark__KPIws"><select class="Select_select__qXz_Z Select_dark__KPIws" aria-label="Select" autocomplete="off"><option value="cURL" selected="">cURL</option><option value="Node">Node</option><option value="Browser">Browser</option><option value="Go">Go</option><option value="Python">Python</option></select><svg viewbox="0 0 8 14" xmlns="http://www.w3.org/2000/svg"><path d="M6.463 7 .987 1.66a.61.61 0 0 1 0-.878.648.648 0 0 1 .9 0L7.813 6.56a.61.61 0 0 1 0 .878l-5.926 5.78a.648.648 0 0 1-.9 0 .61.61 0 0 1 0-.879L6.463 7Z"></path></svg></div></label><div class="CodeSyntaxSelector_body__hBJ7j CodeSyntaxSelector_bodyDark__cizVw" tabindex="0"><div class="CodeBlock_codeBlock__KlURa"><pre tabindex="0" style="color:#ffffff;font-family:ProximaNova, monospace;line-height:1.2;font-size:1rem"><code class="language-bash" style="white-space:pre"><span class="token token" style="color:#ee6123">curl</span><span> </span><span class="token token punctuation">\</span><span> </span><span>-H </span><span class="token token" style="color:#acda95">'Authorization: Bearer {TOKEN}'</span><span> </span><span class="token token punctuation">\</span><span> </span><span>-X GET </span><span class="token token punctuation">\</span><span> </span>https://api-ssl.bitly.com/v4/channels/Ha1bc2DefGh</code></pre></div></div></div><div><label class="CodeSyntaxSelector_header__6P_Jc"><span>Response</span><div class="Select_wrapper__58utF"><select class="Select_select__qXz_Z" aria-label="Select" autocomplete="off"><option value="200" selected="">200 SUCCESS</option><option value="402">402 UPGRADE_REQUIRED</option><option value="403">403 FORBIDDEN</option><option value="404">404 NOT_FOUND</option><option value="500">500 INTERNAL_ERROR</option><option value="503">503 TEMPORARILY_UNAVAILABLE</option></select><svg viewbox="0 0 8 14" xmlns="http://www.w3.org/2000/svg"><path d="M6.463 7 .987 1.66a.61.61 0 0 1 0-.878.648.648 0 0 1 .9 0L7.813 6.56a.61.61 0 0 1 0 .878l-5.926 5.78a.648.648 0 0 1-.9 0 .61.61 0 0 1 0-.879L6.463 7Z"></path></svg></div></label><div class="CodeSyntaxSelector_body__hBJ7j" tabindex="0"><div class="CodeBlock_codeBlock__KlURa"><pre tabindex="0" style="color:#36383b;font-family:ProximaNova, monospace;line-height:1.2;font-size:1rem"><code class="language-json" style="white-space:pre"><span class="token token punctuation">{</span><span> </span><span> </span><span class="token token property">"name"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"guid"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"created"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"modified"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"group_guid"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"references"</span><span class="token token operator">:</span><span> </span><span class="token token punctuation">{</span><span> </span><span class="token token" style="color:#51763e">"any"</span><span> </span><span class="token token punctuation">}</span><span> </span><span></span><span class="token token punctuation">}</span></code></pre></div></div></div></div></div><div class="MethodDetail_methodContainer__3EF7h" id="updateChannel"><div class="MethodDetail_method__fyEiw"><div><h3 class="MethodHeader_h3__seOfC">Update a Channel</h3><h4 class="MethodHeader_description__3_p_p"><div class="MethodHeader_iconStyle__x5Ow4"><svg viewbox="0 0 23 6" xmlns="http://www.w3.org/2000/svg" class="IconRest_restIcon__3pju8 patch"><title>Patch</title><path d="M1.095 5.885V3.898c.027.006.07.011.132.017a4.052 4.052 0 0 0 .372.016h.128c.277 0 .545-.037.803-.11.259-.075.49-.193.692-.355.202-.162.365-.368.487-.618.123-.25.184-.551.184-.903 0-.401-.07-.727-.212-.977a1.606 1.606 0 0 0-.547-.585 2.041 2.041 0 0 0-.756-.28 5.067 5.067 0 0 0-.835-.07c-.267 0-.534.012-.804.037C.47.095.224.13 0 .173v5.712h1.095Zm.472-2.934h-.1a2.448 2.448 0 0 1-.276-.017.853.853 0 0 1-.096-.016V1.047c.059-.011.136-.02.232-.03.096-.007.197-.012.304-.012.138 0 .274.014.408.042a.964.964 0 0 1 .355.148.801.801 0 0 1 .252.284.937.937 0 0 1 .096.45c0 .214-.033.387-.1.519a.787.787 0 0 1-.268.309 1.038 1.038 0 0 1-.38.152 2.235 2.235 0 0 1-.427.042Zm3.79 2.934.383-1.278h1.67l.4 1.278h1.152L7.163.115H6.068L4.26 5.885h1.095ZM7.194 3.7h-1.2l.56-1.929h.072l.568 1.929Zm5.668 2.184v-.907h-.903V1.022h.76v.997h.879V.115H9.218V2.02h.879v-.997h.767v3.956h-.91v.907h2.91Zm3.91.115c.276 0 .547-.036.81-.107.265-.072.482-.17.652-.297V3.948h-.88v.997c-.164.033-.335.05-.51.05-.246 0-.464-.049-.656-.145a1.383 1.383 0 0 1-.488-.408 1.881 1.881 0 0 1-.304-.63A2.973 2.973 0 0 1 15.293 3c0-.34.038-.636.112-.886.075-.25.179-.457.312-.622.133-.165.29-.287.468-.367.178-.08.371-.12.58-.12.175 0 .346.014.511.042v.94h.88V.271a2.727 2.727 0 0 0-.548-.19A3.419 3.419 0 0 0 16.796 0c-.303 0-.613.05-.927.152-.314.102-.6.27-.855.503a2.611 2.611 0 0 0-.628.923c-.163.382-.244.856-.244 1.422 0 .544.072 1.007.216 1.389.144.382.336.692.576.931.24.24.518.412.835.52.317.106.652.16 1.003.16Zm3.325-.115V3.47h1.807v2.415H23V.115h-1.095v2.35h-1.807V.114h-1.095v5.77h1.095Z"></path></svg></div> /v4/channels/{channel_guid}</h4><p class="MethodHeader_description__3_p_p">Updates an existing channel.</p></div><div><h4 class="ParameterList_h4__nH9G8 ParameterList_dividing__wRGRx">Path Parameters</h4><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">channel_guid</span><span class="Parameter_type__djM_s">string</span><span class="Parameter_required__pcK_H">Required</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">A GUID for a Bitly Channel</div></div></div><div><h4 class="ParameterList_h4__nH9G8 ParameterList_dividing__wRGRx">Request Body Schema</h4><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">name</span><span class="Parameter_type__djM_s">string</span></div></div><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">guid</span><span class="Parameter_type__djM_s">string</span></div></div><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">created</span><span class="Parameter_type__djM_s">string</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">ISO TIMESTAMP</div></div><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">modified</span><span class="Parameter_type__djM_s">string</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">ISO_TIMESTAMP</div></div><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">group_guid</span><span class="Parameter_type__djM_s">string</span></div></div><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">bitlinks</span><span class="Parameter_type__djM_s">array of object</span></div><div class="Parameter_nestedList__KmKgd"><div class="Parameter_nested__X3i_l"><div class="Parameter_parameter__J0LgW Parameter_compact__V5419"><div><span class="Parameter_name___UYgz">campaign_guid</span><span class="Parameter_type__djM_s">string</span></div></div></div><div class="Parameter_nested__X3i_l"><div class="Parameter_parameter__J0LgW Parameter_compact__V5419"><div><span class="Parameter_name___UYgz">bitlink_id</span><span class="Parameter_type__djM_s">string</span></div></div></div></div></div></div></div><div class="MethodDetail_examples__8nXeM"><div><label class="CodeSyntaxSelector_header__6P_Jc CodeSyntaxSelector_headerDark__hI3A0"><span>Request</span><div class="Select_wrapper__58utF Select_dark__KPIws"><select class="Select_select__qXz_Z Select_dark__KPIws" aria-label="Select" autocomplete="off"><option value="cURL" selected="">cURL</option><option value="Node">Node</option><option value="Browser">Browser</option><option value="Go">Go</option><option value="Python">Python</option></select><svg viewbox="0 0 8 14" xmlns="http://www.w3.org/2000/svg"><path d="M6.463 7 .987 1.66a.61.61 0 0 1 0-.878.648.648 0 0 1 .9 0L7.813 6.56a.61.61 0 0 1 0 .878l-5.926 5.78a.648.648 0 0 1-.9 0 .61.61 0 0 1 0-.879L6.463 7Z"></path></svg></div></label><div class="CodeSyntaxSelector_body__hBJ7j CodeSyntaxSelector_bodyDark__cizVw" tabindex="0"><div class="CodeBlock_codeBlock__KlURa"><pre tabindex="0" style="color:#ffffff;font-family:ProximaNova, monospace;line-height:1.2;font-size:1rem"><code class="language-bash" style="white-space:pre"><span class="token token" style="color:#ee6123">curl</span><span> </span><span class="token token punctuation">\</span><span> </span><span>-H </span><span class="token token" style="color:#acda95">'Authorization: Bearer {TOKEN}'</span><span> </span><span class="token token punctuation">\</span><span> </span><span>-H </span><span class="token token" style="color:#acda95">'Content-Type: application/json'</span><span> </span><span class="token token punctuation">\</span><span> </span><span>-X PATCH </span><span class="token token punctuation">\</span><span> </span><span>-d </span><span class="token token" style="color:#acda95">'{ </span><span class="token token" style="color:#acda95"> "name": "My Channel", </span><span class="token token" style="color:#acda95"> "guid": "Ha1bc2DefGh", </span><span class="token token" style="color:#acda95"> "group_guid": "Ba1bc23dE4F", </span><span class="token token" style="color:#acda95"> "bitlinks": [ </span><span class="token token" style="color:#acda95"> { </span><span class="token token" style="color:#acda95"> "campaign_guid": "Ca1bcd2EFGh", </span><span class="token token" style="color:#acda95"> "bitlink_id": "bit.ly/1234abcd" </span><span class="token token" style="color:#acda95"> } </span><span class="token token" style="color:#acda95"> ] </span><span class="token token" style="color:#acda95">}'</span><span> </span><span class="token token punctuation">\</span><span> </span>https://api-ssl.bitly.com/v4/channels/Ha1bc2DefGh</code></pre></div></div></div><div><label class="CodeSyntaxSelector_header__6P_Jc"><span>Response</span><div class="Select_wrapper__58utF"><select class="Select_select__qXz_Z" aria-label="Select" autocomplete="off"><option value="200" selected="">200 SUCCESS</option><option value="400">400 BAD_REQUEST</option><option value="402">402 UPGRADE_REQUIRED</option><option value="403">403 FORBIDDEN</option><option value="404">404 NOT_FOUND</option><option value="422">422 UNPROCESSABLE_ENTITY</option><option value="500">500 INTERNAL_ERROR</option><option value="503">503 TEMPORARILY_UNAVAILABLE</option></select><svg viewbox="0 0 8 14" xmlns="http://www.w3.org/2000/svg"><path d="M6.463 7 .987 1.66a.61.61 0 0 1 0-.878.648.648 0 0 1 .9 0L7.813 6.56a.61.61 0 0 1 0 .878l-5.926 5.78a.648.648 0 0 1-.9 0 .61.61 0 0 1 0-.879L6.463 7Z"></path></svg></div></label><div class="CodeSyntaxSelector_body__hBJ7j" tabindex="0"><div class="CodeBlock_codeBlock__KlURa"><pre tabindex="0" style="color:#36383b;font-family:ProximaNova, monospace;line-height:1.2;font-size:1rem"><code class="language-json" style="white-space:pre"><span class="token token punctuation">{</span><span> </span><span> </span><span class="token token property">"name"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"guid"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"created"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"modified"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"group_guid"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"references"</span><span class="token token operator">:</span><span> </span><span class="token token punctuation">{</span><span> </span><span class="token token" style="color:#51763e">"any"</span><span> </span><span class="token token punctuation">}</span><span> </span><span></span><span class="token token punctuation">}</span></code></pre></div></div></div></div></div><div class="ApiReference_tagInfo__YVbgw"><h2 class="ApiReference_tagName__IJx2p">Custom Bitlinks</h2><p class="ApiReference_tagDescription__8c1GM">These endpoints are for updating custom Bitlinks only. Custom Bitlinks have both a BSD and a customized back-half (e.g., yourcompany.com/yourcampaign). If a link begins with the bit.ly domain or ends with an auto-generated random string it is not a custom Bitlink. </p></div><div class="MethodDetail_methodContainer__3EF7h" id="addCustomBitlink"><div class="MethodDetail_method__fyEiw"><div><h3 class="MethodHeader_h3__seOfC">Add Custom Bitlink</h3><h4 class="MethodHeader_description__3_p_p"><div class="MethodHeader_iconStyle__x5Ow4"><svg viewbox="0 0 18 6" xmlns="http://www.w3.org/2000/svg" class="IconRest_restIcon__3pju8 post"><title>Post</title><path d="M1.072 5.885V3.898c.026.006.069.011.129.017a3.88 3.88 0 0 0 .364.016h.125c.27 0 .533-.037.786-.11.253-.075.478-.193.677-.355.198-.162.357-.368.477-.618s.18-.551.18-.903c0-.401-.07-.727-.208-.977a1.592 1.592 0 0 0-.536-.585 1.971 1.971 0 0 0-.739-.28 4.854 4.854 0 0 0-.817-.07C1.249.033.987.045.724.07.46.095.219.13 0 .173v5.712h1.072Zm.461-2.934h-.098a2.344 2.344 0 0 1-.27-.017.818.818 0 0 1-.093-.016V1.047c.057-.011.133-.02.227-.03.093-.007.193-.012.297-.012.135 0 .268.014.399.042.13.027.246.077.348.148a.796.796 0 0 1 .246.284.954.954 0 0 1 .094.45c0 .214-.032.387-.098.519a.782.782 0 0 1-.262.309c-.11.074-.233.125-.371.152a2.141 2.141 0 0 1-.419.042ZM6.47 6c.694 0 1.212-.265 1.553-.795.342-.53.513-1.265.513-2.205 0-.44-.038-.843-.114-1.212a2.872 2.872 0 0 0-.36-.947 1.78 1.78 0 0 0-.637-.618C7.163.074 6.844 0 6.469 0c-.35 0-.653.069-.911.206a1.78 1.78 0 0 0-.645.59c-.172.255-.3.57-.384.943A5.804 5.804 0 0 0 4.404 3c0 .44.037.843.11 1.212.073.368.191.684.356.947.164.264.378.47.641.618.263.149.583.223.958.223Zm0-1.005c-.203 0-.366-.053-.489-.157a.989.989 0 0 1-.281-.425 2.57 2.57 0 0 1-.133-.63A8.129 8.129 0 0 1 5.53 3c0-.66.065-1.157.195-1.492.13-.335.378-.503.743-.503.209 0 .376.054.501.161a1 1 0 0 1 .286.433c.065.181.106.393.125.635.018.241.027.497.027.766 0 .34-.014.636-.043.886-.029.25-.08.457-.152.622a.826.826 0 0 1-.29.367.803.803 0 0 1-.454.12ZM10.991 6c.297 0 .574-.037.83-.111.255-.074.476-.187.664-.338.188-.151.334-.338.438-.56.104-.223.157-.483.157-.78 0-.307-.067-.563-.2-.766a1.814 1.814 0 0 0-.493-.507 3.3 3.3 0 0 0-.641-.342 11.165 11.165 0 0 1-.642-.28 2.185 2.185 0 0 1-.493-.313.562.562 0 0 1-.199-.445c0-.176.072-.316.215-.42.144-.105.34-.157.59-.157a2.757 2.757 0 0 1 .767.107.14.14 0 0 0 .047.008v.915h.86V.338a2.45 2.45 0 0 0-.735-.247C11.85.03 11.536 0 11.218 0c-.282 0-.537.041-.767.124-.23.082-.426.197-.59.346A1.557 1.557 0 0 0 9.476 1a1.66 1.66 0 0 0-.137.68c0 .324.067.588.2.792.133.203.297.372.493.506.195.135.409.246.641.334.232.088.446.176.642.264.195.088.36.19.492.305.133.115.2.266.2.453 0 .209-.081.375-.243.499-.161.123-.388.185-.68.185-.162 0-.314-.018-.458-.053a2.256 2.256 0 0 1-.395-.136l-.047-.017v-.816h-.86V5.53c.067.039.156.085.266.14.11.055.236.107.379.157.143.05.3.09.47.124.169.033.353.049.55.049Zm6.29-.115v-.907h-.885V1.022h.744v.997H18V.115h-4.287V2.02h.86v-.997h.752v3.956h-.892v.907h2.847Z"></path></svg></div> /v4/custom_bitlinks</h4><p class="MethodHeader_description__3_p_p">Add a keyword (or "custom back-half") to a Bitlink with a Custom Domain (domains must match). This endpoint can also be used for initial redirects to a link.</p></div><div><h4 class="ParameterList_h4__nH9G8 ParameterList_dividing__wRGRx">Request Body Schema</h4><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">custom_bitlink</span><span class="Parameter_type__djM_s">string</span></div></div><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">bitlink_id</span><span class="Parameter_type__djM_s">string</span></div></div></div></div><div class="MethodDetail_examples__8nXeM"><div><label class="CodeSyntaxSelector_header__6P_Jc CodeSyntaxSelector_headerDark__hI3A0"><span>Request</span><div class="Select_wrapper__58utF Select_dark__KPIws"><select class="Select_select__qXz_Z Select_dark__KPIws" aria-label="Select" autocomplete="off"><option value="cURL" selected="">cURL</option><option value="Node">Node</option><option value="Browser">Browser</option><option value="Go">Go</option><option value="Python">Python</option></select><svg viewbox="0 0 8 14" xmlns="http://www.w3.org/2000/svg"><path d="M6.463 7 .987 1.66a.61.61 0 0 1 0-.878.648.648 0 0 1 .9 0L7.813 6.56a.61.61 0 0 1 0 .878l-5.926 5.78a.648.648 0 0 1-.9 0 .61.61 0 0 1 0-.879L6.463 7Z"></path></svg></div></label><div class="CodeSyntaxSelector_body__hBJ7j CodeSyntaxSelector_bodyDark__cizVw" tabindex="0"><div class="CodeBlock_codeBlock__KlURa"><pre tabindex="0" style="color:#ffffff;font-family:ProximaNova, monospace;line-height:1.2;font-size:1rem"><code class="language-bash" style="white-space:pre"><span class="token token" style="color:#ee6123">curl</span><span> </span><span class="token token punctuation">\</span><span> </span><span>-H </span><span class="token token" style="color:#acda95">'Authorization: Bearer {TOKEN}'</span><span> </span><span class="token token punctuation">\</span><span> </span><span>-H </span><span class="token token" style="color:#acda95">'Content-Type: application/json'</span><span> </span><span class="token token punctuation">\</span><span> </span><span>-X POST </span><span class="token token punctuation">\</span><span> </span><span>-d </span><span class="token token" style="color:#acda95">'{ </span><span class="token token" style="color:#acda95"> "custom_bitlink": "chauncey.ly/documentation", </span><span class="token token" style="color:#acda95"> "bitlink_id": "chauncey.ly/1234abcd" </span><span class="token token" style="color:#acda95">}'</span><span> </span><span class="token token punctuation">\</span><span> </span>https://api-ssl.bitly.com/v4/custom_bitlinks</code></pre></div></div></div><div><label class="CodeSyntaxSelector_header__6P_Jc"><span>Response</span><div class="Select_wrapper__58utF"><select class="Select_select__qXz_Z" aria-label="Select" autocomplete="off"><option value="200" selected="">200 SUCCESS</option><option value="400">400 BAD_REQUEST</option><option value="402">402 UPGRADE_REQUIRED</option><option value="403">403 FORBIDDEN</option><option value="404">404 NOT_FOUND</option><option value="409">409 Conflict</option><option value="422">422 UNPROCESSABLE_ENTITY</option><option value="500">500 INTERNAL_ERROR</option><option value="503">503 TEMPORARILY_UNAVAILABLE</option></select><svg viewbox="0 0 8 14" xmlns="http://www.w3.org/2000/svg"><path d="M6.463 7 .987 1.66a.61.61 0 0 1 0-.878.648.648 0 0 1 .9 0L7.813 6.56a.61.61 0 0 1 0 .878l-5.926 5.78a.648.648 0 0 1-.9 0 .61.61 0 0 1 0-.879L6.463 7Z"></path></svg></div></label><div class="CodeSyntaxSelector_body__hBJ7j" tabindex="0"><div class="CodeBlock_codeBlock__KlURa"><pre tabindex="0" style="color:#36383b;font-family:ProximaNova, monospace;line-height:1.2;font-size:1rem"><code class="language-json" style="white-space:pre"><span class="token token punctuation">{</span><span> </span><span> </span><span class="token token property">"custom_bitlink"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"bitlink"</span><span class="token token operator">:</span><span> </span><span class="token token punctuation">{</span><span> </span><span> </span><span class="token token property">"references"</span><span class="token token operator">:</span><span> </span><span class="token token punctuation">{</span><span> </span><span class="token token" style="color:#51763e">"any"</span><span> </span><span class="token token punctuation">}</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"link"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"id"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"long_url"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"title"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"archived"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"boolean"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"created_at"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"created_by"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"client_id"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"custom_bitlinks"</span><span class="token token operator">:</span><span> </span><span class="token token punctuation">[</span><span> </span><span> </span><span class="token token" style="color:#51763e">"string"</span><span> </span><span> </span><span class="token token punctuation">]</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"tags"</span><span class="token token operator">:</span><span> </span><span class="token token punctuation">[</span><span> </span><span> </span><span class="token token" style="color:#51763e">"string"</span><span> </span><span> </span><span class="token token punctuation">]</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"launchpad_ids"</span><span class="token token operator">:</span><span> </span><span class="token token punctuation">[</span><span> </span><span> </span><span class="token token" style="color:#51763e">"string"</span><span> </span><span> </span><span class="token token punctuation">]</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"deeplinks"</span><span class="token token operator">:</span><span> </span><span class="token token punctuation">[</span><span> </span><span> </span><span class="token token punctuation">{</span><span> </span><span> </span><span class="token token property">"guid"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"bitlink"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"app_uri_path"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"install_url"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"app_guid"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"os"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"install_type"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"created"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"modified"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"brand_guid"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span> </span><span> </span><span class="token token punctuation">}</span><span> </span><span> </span><span class="token token punctuation">]</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"is_deleted"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"boolean"</span><span> </span><span> </span><span class="token token punctuation">}</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"bitlink_history"</span><span class="token token operator">:</span><span> </span><span class="token token punctuation">[</span><span> </span><span> </span><span class="token token punctuation">{</span><span> </span><span> </span><span class="token token property">"uuid"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"group_guid"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"keyword"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"bsd"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"hash"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"login"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"long_url"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"created"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"first_created"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"deactivated"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"is_active"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"boolean"</span><span> </span><span> </span><span class="token token punctuation">}</span><span> </span><span> </span><span class="token token punctuation">]</span><span> </span><span></span><span class="token token punctuation">}</span></code></pre></div></div></div></div></div><div class="MethodDetail_methodContainer__3EF7h" id="updateCustomBitlink"><div class="MethodDetail_method__fyEiw"><div><h3 class="MethodHeader_h3__seOfC">Update Custom Bitlink</h3><h4 class="MethodHeader_description__3_p_p"><div class="MethodHeader_iconStyle__x5Ow4"><svg viewbox="0 0 23 6" xmlns="http://www.w3.org/2000/svg" class="IconRest_restIcon__3pju8 patch"><title>Patch</title><path d="M1.095 5.885V3.898c.027.006.07.011.132.017a4.052 4.052 0 0 0 .372.016h.128c.277 0 .545-.037.803-.11.259-.075.49-.193.692-.355.202-.162.365-.368.487-.618.123-.25.184-.551.184-.903 0-.401-.07-.727-.212-.977a1.606 1.606 0 0 0-.547-.585 2.041 2.041 0 0 0-.756-.28 5.067 5.067 0 0 0-.835-.07c-.267 0-.534.012-.804.037C.47.095.224.13 0 .173v5.712h1.095Zm.472-2.934h-.1a2.448 2.448 0 0 1-.276-.017.853.853 0 0 1-.096-.016V1.047c.059-.011.136-.02.232-.03.096-.007.197-.012.304-.012.138 0 .274.014.408.042a.964.964 0 0 1 .355.148.801.801 0 0 1 .252.284.937.937 0 0 1 .096.45c0 .214-.033.387-.1.519a.787.787 0 0 1-.268.309 1.038 1.038 0 0 1-.38.152 2.235 2.235 0 0 1-.427.042Zm3.79 2.934.383-1.278h1.67l.4 1.278h1.152L7.163.115H6.068L4.26 5.885h1.095ZM7.194 3.7h-1.2l.56-1.929h.072l.568 1.929Zm5.668 2.184v-.907h-.903V1.022h.76v.997h.879V.115H9.218V2.02h.879v-.997h.767v3.956h-.91v.907h2.91Zm3.91.115c.276 0 .547-.036.81-.107.265-.072.482-.17.652-.297V3.948h-.88v.997c-.164.033-.335.05-.51.05-.246 0-.464-.049-.656-.145a1.383 1.383 0 0 1-.488-.408 1.881 1.881 0 0 1-.304-.63A2.973 2.973 0 0 1 15.293 3c0-.34.038-.636.112-.886.075-.25.179-.457.312-.622.133-.165.29-.287.468-.367.178-.08.371-.12.58-.12.175 0 .346.014.511.042v.94h.88V.271a2.727 2.727 0 0 0-.548-.19A3.419 3.419 0 0 0 16.796 0c-.303 0-.613.05-.927.152-.314.102-.6.27-.855.503a2.611 2.611 0 0 0-.628.923c-.163.382-.244.856-.244 1.422 0 .544.072 1.007.216 1.389.144.382.336.692.576.931.24.24.518.412.835.52.317.106.652.16 1.003.16Zm3.325-.115V3.47h1.807v2.415H23V.115h-1.095v2.35h-1.807V.114h-1.095v5.77h1.095Z"></path></svg></div> /v4/custom_bitlinks/{custom_bitlink}</h4><p class="MethodHeader_description__3_p_p">Move a keyword (or custom back-half) to a different Bitlink (domains must match).</p></div><div><h4 class="ParameterList_h4__nH9G8 ParameterList_dividing__wRGRx">Path Parameters</h4><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">custom_bitlink</span><span class="Parameter_type__djM_s">string</span><span class="Parameter_required__pcK_H">Required</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">A Custom Bitlink made of the domain and keyword</div></div></div><div><h4 class="ParameterList_h4__nH9G8 ParameterList_dividing__wRGRx">Request Body Schema</h4><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">bitlink_id</span><span class="Parameter_type__djM_s">string</span></div></div></div></div><div class="MethodDetail_examples__8nXeM"><div><label class="CodeSyntaxSelector_header__6P_Jc CodeSyntaxSelector_headerDark__hI3A0"><span>Request</span><div class="Select_wrapper__58utF Select_dark__KPIws"><select class="Select_select__qXz_Z Select_dark__KPIws" aria-label="Select" autocomplete="off"><option value="cURL" selected="">cURL</option><option value="Node">Node</option><option value="Browser">Browser</option><option value="Go">Go</option><option value="Python">Python</option></select><svg viewbox="0 0 8 14" xmlns="http://www.w3.org/2000/svg"><path d="M6.463 7 .987 1.66a.61.61 0 0 1 0-.878.648.648 0 0 1 .9 0L7.813 6.56a.61.61 0 0 1 0 .878l-5.926 5.78a.648.648 0 0 1-.9 0 .61.61 0 0 1 0-.879L6.463 7Z"></path></svg></div></label><div class="CodeSyntaxSelector_body__hBJ7j CodeSyntaxSelector_bodyDark__cizVw" tabindex="0"><div class="CodeBlock_codeBlock__KlURa"><pre tabindex="0" style="color:#ffffff;font-family:ProximaNova, monospace;line-height:1.2;font-size:1rem"><code class="language-bash" style="white-space:pre"><span class="token token" style="color:#ee6123">curl</span><span> </span><span class="token token punctuation">\</span><span> </span><span>-H </span><span class="token token" style="color:#acda95">'Authorization: Bearer {TOKEN}'</span><span> </span><span class="token token punctuation">\</span><span> </span><span>-H </span><span class="token token" style="color:#acda95">'Content-Type: application/json'</span><span> </span><span class="token token punctuation">\</span><span> </span><span>-X PATCH </span><span class="token token punctuation">\</span><span> </span><span>-d </span><span class="token token" style="color:#acda95">'{ </span><span class="token token" style="color:#acda95"> "bitlink_id": "chauncey.ly/1234abcd" </span><span class="token token" style="color:#acda95">}'</span><span> </span><span class="token token punctuation">\</span><span> </span>https://api-ssl.bitly.com/v4/custom_bitlinks/chauncey.ly/chauncey</code></pre></div></div></div><div><label class="CodeSyntaxSelector_header__6P_Jc"><span>Response</span><div class="Select_wrapper__58utF"><select class="Select_select__qXz_Z" aria-label="Select" autocomplete="off"><option value="200" selected="">200 SUCCESS</option><option value="400">400 BAD_REQUEST</option><option value="402">402 UPGRADE_REQUIRED</option><option value="403">403 FORBIDDEN</option><option value="404">404 NOT_FOUND</option><option value="422">422 UNPROCESSABLE_ENTITY</option><option value="500">500 INTERNAL_ERROR</option><option value="503">503 TEMPORARILY_UNAVAILABLE</option></select><svg viewbox="0 0 8 14" xmlns="http://www.w3.org/2000/svg"><path d="M6.463 7 .987 1.66a.61.61 0 0 1 0-.878.648.648 0 0 1 .9 0L7.813 6.56a.61.61 0 0 1 0 .878l-5.926 5.78a.648.648 0 0 1-.9 0 .61.61 0 0 1 0-.879L6.463 7Z"></path></svg></div></label><div class="CodeSyntaxSelector_body__hBJ7j" tabindex="0"><div class="CodeBlock_codeBlock__KlURa"><pre tabindex="0" style="color:#36383b;font-family:ProximaNova, monospace;line-height:1.2;font-size:1rem"><code class="language-json" style="white-space:pre"><span class="token token punctuation">{</span><span> </span><span> </span><span class="token token property">"custom_bitlink"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"bitlink"</span><span class="token token operator">:</span><span> </span><span class="token token punctuation">{</span><span> </span><span> </span><span class="token token property">"references"</span><span class="token token operator">:</span><span> </span><span class="token token punctuation">{</span><span> </span><span class="token token" style="color:#51763e">"any"</span><span> </span><span class="token token punctuation">}</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"link"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"id"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"long_url"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"title"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"archived"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"boolean"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"created_at"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"created_by"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"client_id"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"custom_bitlinks"</span><span class="token token operator">:</span><span> </span><span class="token token punctuation">[</span><span> </span><span> </span><span class="token token" style="color:#51763e">"string"</span><span> </span><span> </span><span class="token token punctuation">]</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"tags"</span><span class="token token operator">:</span><span> </span><span class="token token punctuation">[</span><span> </span><span> </span><span class="token token" style="color:#51763e">"string"</span><span> </span><span> </span><span class="token token punctuation">]</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"launchpad_ids"</span><span class="token token operator">:</span><span> </span><span class="token token punctuation">[</span><span> </span><span> </span><span class="token token" style="color:#51763e">"string"</span><span> </span><span> </span><span class="token token punctuation">]</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"deeplinks"</span><span class="token token operator">:</span><span> </span><span class="token token punctuation">[</span><span> </span><span> </span><span class="token token punctuation">{</span><span> </span><span> </span><span class="token token property">"guid"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"bitlink"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"app_uri_path"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"install_url"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"app_guid"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"os"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"install_type"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"created"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"modified"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"brand_guid"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span> </span><span> </span><span class="token token punctuation">}</span><span> </span><span> </span><span class="token token punctuation">]</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"is_deleted"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"boolean"</span><span> </span><span> </span><span class="token token punctuation">}</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"bitlink_history"</span><span class="token token operator">:</span><span> </span><span class="token token punctuation">[</span><span> </span><span> </span><span class="token token punctuation">{</span><span> </span><span> </span><span class="token token property">"uuid"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"group_guid"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"keyword"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"bsd"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"hash"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"login"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"long_url"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"created"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"first_created"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"deactivated"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"is_active"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"boolean"</span><span> </span><span> </span><span class="token token punctuation">}</span><span> </span><span> </span><span class="token token punctuation">]</span><span> </span><span></span><span class="token token punctuation">}</span></code></pre></div></div></div></div></div><div class="MethodDetail_methodContainer__3EF7h" id="getCustomBitlink"><div class="MethodDetail_method__fyEiw"><div><h3 class="MethodHeader_h3__seOfC">Retrieve Custom Bitlink</h3><h4 class="MethodHeader_description__3_p_p"><div class="MethodHeader_iconStyle__x5Ow4"><svg viewbox="0 0 14 6" xmlns="http://www.w3.org/2000/svg" class="IconRest_restIcon__3pju8 get"><title>Get</title><path d="M2.587 6c.307 0 .607-.044.9-.132.295-.088.533-.217.716-.387V2.876H2.271v.825h1.027v1.145a.772.772 0 0 1-.239.1 1.4 1.4 0 0 1-.383.049 1.338 1.338 0 0 1-1.083-.52c-.135-.17-.24-.379-.316-.626a2.879 2.879 0 0 1-.113-.84c0-.352.038-.655.113-.907.076-.253.182-.46.32-.623.137-.162.3-.281.488-.358a1.783 1.783 0 0 1 .97-.082l.13.032v.915h.889V.28a3.182 3.182 0 0 0-.59-.202A3.507 3.507 0 0 0 2.676 0c-.313 0-.628.055-.946.165a2.4 2.4 0 0 0-.861.523 2.707 2.707 0 0 0-.627.92C.081 1.98 0 2.433 0 2.966c0 .506.067.946.202 1.323.135.376.318.692.55.948a2.2 2.2 0 0 0 .82.572A2.7 2.7 0 0 0 2.587 6Zm6.24-.115V4.879H6.184V3.47h2.4V2.465h-2.4V1.121h2.602V.115h-3.71v5.77h3.75Zm4.43 0v-.907h-.914V1.022h.768v.997H14V.115H9.57V2.02h.89v-.997h.776v3.956h-.922v.907h2.942Z"></path></svg></div> /v4/custom_bitlinks/{custom_bitlink}</h4><p class="MethodHeader_description__3_p_p">Returns the details and history of the specified link.</p></div><div><h4 class="ParameterList_h4__nH9G8 ParameterList_dividing__wRGRx">Path Parameters</h4><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">custom_bitlink</span><span class="Parameter_type__djM_s">string</span><span class="Parameter_required__pcK_H">Required</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">A Custom Bitlink made of the domain and keyword</div></div></div></div><div class="MethodDetail_examples__8nXeM"><div><label class="CodeSyntaxSelector_header__6P_Jc CodeSyntaxSelector_headerDark__hI3A0"><span>Request</span><div class="Select_wrapper__58utF Select_dark__KPIws"><select class="Select_select__qXz_Z Select_dark__KPIws" aria-label="Select" autocomplete="off"><option value="cURL" selected="">cURL</option><option value="Node">Node</option><option value="Browser">Browser</option><option value="Go">Go</option><option value="Python">Python</option></select><svg viewbox="0 0 8 14" xmlns="http://www.w3.org/2000/svg"><path d="M6.463 7 .987 1.66a.61.61 0 0 1 0-.878.648.648 0 0 1 .9 0L7.813 6.56a.61.61 0 0 1 0 .878l-5.926 5.78a.648.648 0 0 1-.9 0 .61.61 0 0 1 0-.879L6.463 7Z"></path></svg></div></label><div class="CodeSyntaxSelector_body__hBJ7j CodeSyntaxSelector_bodyDark__cizVw" tabindex="0"><div class="CodeBlock_codeBlock__KlURa"><pre tabindex="0" style="color:#ffffff;font-family:ProximaNova, monospace;line-height:1.2;font-size:1rem"><code class="language-bash" style="white-space:pre"><span class="token token" style="color:#ee6123">curl</span><span> </span><span class="token token punctuation">\</span><span> </span><span>-H </span><span class="token token" style="color:#acda95">'Authorization: Bearer {TOKEN}'</span><span> </span><span class="token token punctuation">\</span><span> </span><span>-X GET </span><span class="token token punctuation">\</span><span> </span>https://api-ssl.bitly.com/v4/custom_bitlinks/chauncey.ly/chauncey</code></pre></div></div></div><div><label class="CodeSyntaxSelector_header__6P_Jc"><span>Response</span><div class="Select_wrapper__58utF"><select class="Select_select__qXz_Z" aria-label="Select" autocomplete="off"><option value="200" selected="">200 SUCCESS</option><option value="402">402 UPGRADE_REQUIRED</option><option value="403">403 FORBIDDEN</option><option value="404">404 NOT_FOUND</option><option value="410">410 GONE</option><option value="500">500 INTERNAL_ERROR</option><option value="503">503 TEMPORARILY_UNAVAILABLE</option></select><svg viewbox="0 0 8 14" xmlns="http://www.w3.org/2000/svg"><path d="M6.463 7 .987 1.66a.61.61 0 0 1 0-.878.648.648 0 0 1 .9 0L7.813 6.56a.61.61 0 0 1 0 .878l-5.926 5.78a.648.648 0 0 1-.9 0 .61.61 0 0 1 0-.879L6.463 7Z"></path></svg></div></label><div class="CodeSyntaxSelector_body__hBJ7j" tabindex="0"><div class="CodeBlock_codeBlock__KlURa"><pre tabindex="0" style="color:#36383b;font-family:ProximaNova, monospace;line-height:1.2;font-size:1rem"><code class="language-json" style="white-space:pre"><span class="token token punctuation">{</span><span> </span><span> </span><span class="token token property">"custom_bitlink"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"bitlink"</span><span class="token token operator">:</span><span> </span><span class="token token punctuation">{</span><span> </span><span> </span><span class="token token property">"references"</span><span class="token token operator">:</span><span> </span><span class="token token punctuation">{</span><span> </span><span class="token token" style="color:#51763e">"any"</span><span> </span><span class="token token punctuation">}</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"link"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"id"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"long_url"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"title"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"archived"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"boolean"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"created_at"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"created_by"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"client_id"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"custom_bitlinks"</span><span class="token token operator">:</span><span> </span><span class="token token punctuation">[</span><span> </span><span> </span><span class="token token" style="color:#51763e">"string"</span><span> </span><span> </span><span class="token token punctuation">]</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"tags"</span><span class="token token operator">:</span><span> </span><span class="token token punctuation">[</span><span> </span><span> </span><span class="token token" style="color:#51763e">"string"</span><span> </span><span> </span><span class="token token punctuation">]</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"launchpad_ids"</span><span class="token token operator">:</span><span> </span><span class="token token punctuation">[</span><span> </span><span> </span><span class="token token" style="color:#51763e">"string"</span><span> </span><span> </span><span class="token token punctuation">]</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"deeplinks"</span><span class="token token operator">:</span><span> </span><span class="token token punctuation">[</span><span> </span><span> </span><span class="token token punctuation">{</span><span> </span><span> </span><span class="token token property">"guid"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"bitlink"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"app_uri_path"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"install_url"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"app_guid"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"os"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"install_type"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"created"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"modified"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"brand_guid"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span> </span><span> </span><span class="token token punctuation">}</span><span> </span><span> </span><span class="token token punctuation">]</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"is_deleted"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"boolean"</span><span> </span><span> </span><span class="token token punctuation">}</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"bitlink_history"</span><span class="token token operator">:</span><span> </span><span class="token token punctuation">[</span><span> </span><span> </span><span class="token token punctuation">{</span><span> </span><span> </span><span class="token token property">"uuid"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"group_guid"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"keyword"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"bsd"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"hash"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"login"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"long_url"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"created"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"first_created"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"deactivated"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"is_active"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"boolean"</span><span> </span><span> </span><span class="token token punctuation">}</span><span> </span><span> </span><span class="token token punctuation">]</span><span> </span><span></span><span class="token token punctuation">}</span></code></pre></div></div></div></div></div><div class="MethodDetail_methodContainer__3EF7h" id="getCustomBitlinkMetricsByDestination"><div class="MethodDetail_method__fyEiw"><div><h3 class="MethodHeader_h3__seOfC">Get Metrics for a Custom Bitlink by Destination</h3><h4 class="MethodHeader_description__3_p_p"><div class="MethodHeader_iconStyle__x5Ow4"><svg viewbox="0 0 14 6" xmlns="http://www.w3.org/2000/svg" class="IconRest_restIcon__3pju8 get"><title>Get</title><path d="M2.587 6c.307 0 .607-.044.9-.132.295-.088.533-.217.716-.387V2.876H2.271v.825h1.027v1.145a.772.772 0 0 1-.239.1 1.4 1.4 0 0 1-.383.049 1.338 1.338 0 0 1-1.083-.52c-.135-.17-.24-.379-.316-.626a2.879 2.879 0 0 1-.113-.84c0-.352.038-.655.113-.907.076-.253.182-.46.32-.623.137-.162.3-.281.488-.358a1.783 1.783 0 0 1 .97-.082l.13.032v.915h.889V.28a3.182 3.182 0 0 0-.59-.202A3.507 3.507 0 0 0 2.676 0c-.313 0-.628.055-.946.165a2.4 2.4 0 0 0-.861.523 2.707 2.707 0 0 0-.627.92C.081 1.98 0 2.433 0 2.966c0 .506.067.946.202 1.323.135.376.318.692.55.948a2.2 2.2 0 0 0 .82.572A2.7 2.7 0 0 0 2.587 6Zm6.24-.115V4.879H6.184V3.47h2.4V2.465h-2.4V1.121h2.602V.115h-3.71v5.77h3.75Zm4.43 0v-.907h-.914V1.022h.768v.997H14V.115H9.57V2.02h.89v-.997h.776v3.956h-.922v.907h2.942Z"></path></svg></div> /v4/custom_bitlinks/{custom_bitlink}/clicks_by_destination</h4><p class="MethodHeader_description__3_p_p">Returns click metrics for the specified link by its historical destinations.</p></div><div><h4 class="ParameterList_h4__nH9G8 ParameterList_dividing__wRGRx">Path Parameters</h4><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">custom_bitlink</span><span class="Parameter_type__djM_s">string</span><span class="Parameter_required__pcK_H">Required</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">A Custom Bitlink made of the domain and keyword</div></div></div><div><h4 class="ParameterList_h4__nH9G8 ParameterList_dividing__wRGRx">Query Parameters</h4><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">unit</span><span class="Parameter_type__djM_s">string</span><span class="Parameter_required__pcK_H">Required</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">A unit of time</div><div class="Parameter_default__HHgG0 Parameter_spacer__JKXbH">Default: <span class="Parameter_label__DUY7G">"day"</span></div><div class="Parameter_enum__csO6P Parameter_spacer__JKXbH">Enum: <span class="Parameter_label__DUY7G">"minute"</span><span class="Parameter_label__DUY7G">"hour"</span><span class="Parameter_label__DUY7G">"day"</span><span class="Parameter_label__DUY7G">"week"</span><span class="Parameter_label__DUY7G">"month"</span></div></div><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">units</span><span class="Parameter_type__djM_s">integer</span><span class="Parameter_required__pcK_H">Required</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">An integer representing the time units to query data for. pass -1 to return all units of time.</div><div class="Parameter_default__HHgG0 Parameter_spacer__JKXbH">Default: <span class="Parameter_label__DUY7G">-1</span></div></div><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">unit_reference</span><span class="Parameter_type__djM_s">string</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">An ISO-8601 timestamp, indicating the most recent time for which to pull metrics. Will default to current time. Timestamp values should be url encoded (i.e. replace '+' with '%2B' and ':' with '%3A'; 2022-02-02T15:53:02+0000 becomes 2022-02-02T15%3A53%3A02%2B0000)</div></div></div></div><div class="MethodDetail_examples__8nXeM"><div><label class="CodeSyntaxSelector_header__6P_Jc CodeSyntaxSelector_headerDark__hI3A0"><span>Request</span><div class="Select_wrapper__58utF Select_dark__KPIws"><select class="Select_select__qXz_Z Select_dark__KPIws" aria-label="Select" autocomplete="off"><option value="cURL" selected="">cURL</option><option value="Node">Node</option><option value="Browser">Browser</option><option value="Go">Go</option><option value="Python">Python</option></select><svg viewbox="0 0 8 14" xmlns="http://www.w3.org/2000/svg"><path d="M6.463 7 .987 1.66a.61.61 0 0 1 0-.878.648.648 0 0 1 .9 0L7.813 6.56a.61.61 0 0 1 0 .878l-5.926 5.78a.648.648 0 0 1-.9 0 .61.61 0 0 1 0-.879L6.463 7Z"></path></svg></div></label><div class="CodeSyntaxSelector_body__hBJ7j CodeSyntaxSelector_bodyDark__cizVw" tabindex="0"><div class="CodeBlock_codeBlock__KlURa"><pre tabindex="0" style="color:#ffffff;font-family:ProximaNova, monospace;line-height:1.2;font-size:1rem"><code class="language-bash" style="white-space:pre"><span class="token token" style="color:#ee6123">curl</span><span> </span><span class="token token punctuation">\</span><span> </span><span>-H </span><span class="token token" style="color:#acda95">'Authorization: Bearer {TOKEN}'</span><span> </span><span class="token token punctuation">\</span><span> </span><span>-X GET </span><span class="token token punctuation">\</span><span> </span><span>https://api-ssl.bitly.com/v4/custom_bitlinks/chauncey.ly/chauncey/clicks_by_destination?unit</span><span class="token token operator">=</span><span>month</span><span class="token token operator">&</span><span class="token token assign-left variable">units</span><span class="token token operator">=</span><span class="token token" style="color:#a1b8f3">5</span><span class="token token operator">&</span><span class="token token assign-left variable">unit_reference</span><span class="token token operator">=</span><span class="token token" style="color:#a1b8f3">2006</span><span>-01-02T15%3A04%3A05-0700</span></code></pre></div></div></div><div><label class="CodeSyntaxSelector_header__6P_Jc"><span>Response</span><div class="Select_wrapper__58utF"><select class="Select_select__qXz_Z" aria-label="Select" autocomplete="off"><option value="200" selected="">200 SUCCESS</option><option value="402">402 UPGRADE_REQUIRED</option><option value="403">403 FORBIDDEN</option><option value="404">404 NOT_FOUND</option><option value="410">410 GONE</option><option value="500">500 INTERNAL_ERROR</option><option value="503">503 TEMPORARILY_UNAVAILABLE</option></select><svg viewbox="0 0 8 14" xmlns="http://www.w3.org/2000/svg"><path d="M6.463 7 .987 1.66a.61.61 0 0 1 0-.878.648.648 0 0 1 .9 0L7.813 6.56a.61.61 0 0 1 0 .878l-5.926 5.78a.648.648 0 0 1-.9 0 .61.61 0 0 1 0-.879L6.463 7Z"></path></svg></div></label><div class="CodeSyntaxSelector_body__hBJ7j" tabindex="0"><div class="CodeBlock_codeBlock__KlURa"><pre tabindex="0" style="color:#36383b;font-family:ProximaNova, monospace;line-height:1.2;font-size:1rem"><code class="language-json" style="white-space:pre"><span class="token token punctuation">{</span><span> </span><span> </span><span class="token token property">"unit"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"units"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"integer"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"facet"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"unit_reference"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"metrics"</span><span class="token token operator">:</span><span> </span><span class="token token punctuation">[</span><span> </span><span> </span><span class="token token punctuation">{</span><span> </span><span> </span><span class="token token property">"clicks"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"integer"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"value"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span> </span><span> </span><span class="token token punctuation">}</span><span> </span><span> </span><span class="token token punctuation">]</span><span> </span><span></span><span class="token token punctuation">}</span></code></pre></div></div></div></div></div><div class="MethodDetail_methodContainer__3EF7h" id="getClicksForCustomBitlink"><div class="MethodDetail_method__fyEiw"><div><h3 class="MethodHeader_h3__seOfC">Get Clicks for a Custom Bitlink's Entire History</h3><h4 class="MethodHeader_description__3_p_p"><div class="MethodHeader_iconStyle__x5Ow4"><svg viewbox="0 0 14 6" xmlns="http://www.w3.org/2000/svg" class="IconRest_restIcon__3pju8 get"><title>Get</title><path d="M2.587 6c.307 0 .607-.044.9-.132.295-.088.533-.217.716-.387V2.876H2.271v.825h1.027v1.145a.772.772 0 0 1-.239.1 1.4 1.4 0 0 1-.383.049 1.338 1.338 0 0 1-1.083-.52c-.135-.17-.24-.379-.316-.626a2.879 2.879 0 0 1-.113-.84c0-.352.038-.655.113-.907.076-.253.182-.46.32-.623.137-.162.3-.281.488-.358a1.783 1.783 0 0 1 .97-.082l.13.032v.915h.889V.28a3.182 3.182 0 0 0-.59-.202A3.507 3.507 0 0 0 2.676 0c-.313 0-.628.055-.946.165a2.4 2.4 0 0 0-.861.523 2.707 2.707 0 0 0-.627.92C.081 1.98 0 2.433 0 2.966c0 .506.067.946.202 1.323.135.376.318.692.55.948a2.2 2.2 0 0 0 .82.572A2.7 2.7 0 0 0 2.587 6Zm6.24-.115V4.879H6.184V3.47h2.4V2.465h-2.4V1.121h2.602V.115h-3.71v5.77h3.75Zm4.43 0v-.907h-.914V1.022h.768v.997H14V.115H9.57V2.02h.89v-.997h.776v3.956h-.922v.907h2.942Z"></path></svg></div> /v4/custom_bitlinks/{custom_bitlink}/clicks</h4><p class="MethodHeader_description__3_p_p">Returns the click counts for the specified link. This returns an array with clicks based on a date.</p></div><div><h4 class="ParameterList_h4__nH9G8 ParameterList_dividing__wRGRx">Path Parameters</h4><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">custom_bitlink</span><span class="Parameter_type__djM_s">string</span><span class="Parameter_required__pcK_H">Required</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">A Custom Bitlink made of the domain and keyword</div></div></div><div><h4 class="ParameterList_h4__nH9G8 ParameterList_dividing__wRGRx">Query Parameters</h4><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">unit</span><span class="Parameter_type__djM_s">string</span><span class="Parameter_required__pcK_H">Required</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">A unit of time</div><div class="Parameter_default__HHgG0 Parameter_spacer__JKXbH">Default: <span class="Parameter_label__DUY7G">"day"</span></div><div class="Parameter_enum__csO6P Parameter_spacer__JKXbH">Enum: <span class="Parameter_label__DUY7G">"minute"</span><span class="Parameter_label__DUY7G">"hour"</span><span class="Parameter_label__DUY7G">"day"</span><span class="Parameter_label__DUY7G">"week"</span><span class="Parameter_label__DUY7G">"month"</span></div></div><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">units</span><span class="Parameter_type__djM_s">integer</span><span class="Parameter_required__pcK_H">Required</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">An integer representing the time units to query data for. pass -1 to return all units of time.</div><div class="Parameter_default__HHgG0 Parameter_spacer__JKXbH">Default: <span class="Parameter_label__DUY7G">-1</span></div></div><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">unit_reference</span><span class="Parameter_type__djM_s">string</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">An ISO-8601 timestamp, indicating the most recent time for which to pull metrics. Will default to current time. Timestamp values should be url encoded (i.e. replace '+' with '%2B' and ':' with '%3A'; 2022-02-02T15:53:02+0000 becomes 2022-02-02T15%3A53%3A02%2B0000)</div></div></div></div><div class="MethodDetail_examples__8nXeM"><div><label class="CodeSyntaxSelector_header__6P_Jc CodeSyntaxSelector_headerDark__hI3A0"><span>Request</span><div class="Select_wrapper__58utF Select_dark__KPIws"><select class="Select_select__qXz_Z Select_dark__KPIws" aria-label="Select" autocomplete="off"><option value="cURL" selected="">cURL</option><option value="Node">Node</option><option value="Browser">Browser</option><option value="Go">Go</option><option value="Python">Python</option></select><svg viewbox="0 0 8 14" xmlns="http://www.w3.org/2000/svg"><path d="M6.463 7 .987 1.66a.61.61 0 0 1 0-.878.648.648 0 0 1 .9 0L7.813 6.56a.61.61 0 0 1 0 .878l-5.926 5.78a.648.648 0 0 1-.9 0 .61.61 0 0 1 0-.879L6.463 7Z"></path></svg></div></label><div class="CodeSyntaxSelector_body__hBJ7j CodeSyntaxSelector_bodyDark__cizVw" tabindex="0"><div class="CodeBlock_codeBlock__KlURa"><pre tabindex="0" style="color:#ffffff;font-family:ProximaNova, monospace;line-height:1.2;font-size:1rem"><code class="language-bash" style="white-space:pre"><span class="token token" style="color:#ee6123">curl</span><span> </span><span class="token token punctuation">\</span><span> </span><span>-H </span><span class="token token" style="color:#acda95">'Authorization: Bearer {TOKEN}'</span><span> </span><span class="token token punctuation">\</span><span> </span><span>-X GET </span><span class="token token punctuation">\</span><span> </span><span>https://api-ssl.bitly.com/v4/custom_bitlinks/chauncey.ly/chauncey/clicks?unit</span><span class="token token operator">=</span><span>month</span><span class="token token operator">&</span><span class="token token assign-left variable">units</span><span class="token token operator">=</span><span class="token token" style="color:#a1b8f3">5</span><span class="token token operator">&</span><span class="token token assign-left variable">unit_reference</span><span class="token token operator">=</span><span class="token token" style="color:#a1b8f3">2006</span><span>-01-02T15%3A04%3A05-0700</span></code></pre></div></div></div><div><label class="CodeSyntaxSelector_header__6P_Jc"><span>Response</span><div class="Select_wrapper__58utF"><select class="Select_select__qXz_Z" aria-label="Select" autocomplete="off"><option value="200" selected="">200 SUCCESS</option><option value="400">400 BAD_REQUEST</option><option value="402">402 UPGRADE_REQUIRED</option><option value="403">403 FORBIDDEN</option><option value="404">404 NOT_FOUND</option><option value="410">410 GONE</option><option value="500">500 INTERNAL_ERROR</option><option value="503">503 TEMPORARILY_UNAVAILABLE</option></select><svg viewbox="0 0 8 14" xmlns="http://www.w3.org/2000/svg"><path d="M6.463 7 .987 1.66a.61.61 0 0 1 0-.878.648.648 0 0 1 .9 0L7.813 6.56a.61.61 0 0 1 0 .878l-5.926 5.78a.648.648 0 0 1-.9 0 .61.61 0 0 1 0-.879L6.463 7Z"></path></svg></div></label><div class="CodeSyntaxSelector_body__hBJ7j" tabindex="0"><div class="CodeBlock_codeBlock__KlURa"><pre tabindex="0" style="color:#36383b;font-family:ProximaNova, monospace;line-height:1.2;font-size:1rem"><code class="language-json" style="white-space:pre"><span class="token token punctuation">{</span><span> </span><span> </span><span class="token token property">"link_clicks"</span><span class="token token operator">:</span><span> </span><span class="token token punctuation">[</span><span> </span><span> </span><span class="token token punctuation">{</span><span> </span><span> </span><span class="token token property">"clicks"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"integer"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"date"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span> </span><span> </span><span class="token token punctuation">}</span><span> </span><span> </span><span class="token token punctuation">]</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"units"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"integer"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"unit"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"unit_reference"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span> </span><span></span><span class="token token punctuation">}</span></code></pre></div></div></div></div></div><div class="ApiReference_tagInfo__YVbgw"><h2 class="ApiReference_tagName__IJx2p">Groups</h2><p class="ApiReference_tagDescription__8c1GM">Groups are subdivisions within organizations. Every user will be in at least one group, and every shortened link will be in one group. Most actions on our API will be on behalf of a group. For example, when you shorten a link, it will be on behalf of a user and a group. </p></div><div class="MethodDetail_methodContainer__3EF7h" id="getGroups"><div class="MethodDetail_method__fyEiw"><div><h3 class="MethodHeader_h3__seOfC">Retrieve Groups</h3><h4 class="MethodHeader_description__3_p_p"><div class="MethodHeader_iconStyle__x5Ow4"><svg viewbox="0 0 14 6" xmlns="http://www.w3.org/2000/svg" class="IconRest_restIcon__3pju8 get"><title>Get</title><path d="M2.587 6c.307 0 .607-.044.9-.132.295-.088.533-.217.716-.387V2.876H2.271v.825h1.027v1.145a.772.772 0 0 1-.239.1 1.4 1.4 0 0 1-.383.049 1.338 1.338 0 0 1-1.083-.52c-.135-.17-.24-.379-.316-.626a2.879 2.879 0 0 1-.113-.84c0-.352.038-.655.113-.907.076-.253.182-.46.32-.623.137-.162.3-.281.488-.358a1.783 1.783 0 0 1 .97-.082l.13.032v.915h.889V.28a3.182 3.182 0 0 0-.59-.202A3.507 3.507 0 0 0 2.676 0c-.313 0-.628.055-.946.165a2.4 2.4 0 0 0-.861.523 2.707 2.707 0 0 0-.627.92C.081 1.98 0 2.433 0 2.966c0 .506.067.946.202 1.323.135.376.318.692.55.948a2.2 2.2 0 0 0 .82.572A2.7 2.7 0 0 0 2.587 6Zm6.24-.115V4.879H6.184V3.47h2.4V2.465h-2.4V1.121h2.602V.115h-3.71v5.77h3.75Zm4.43 0v-.907h-.914V1.022h.768v.997H14V.115H9.57V2.02h.89v-.997h.776v3.956h-.922v.907h2.942Z"></path></svg></div> /v4/groups</h4><p class="MethodHeader_description__3_p_p">Returns a list of groups in the organization.</p></div><div><h4 class="ParameterList_h4__nH9G8 ParameterList_dividing__wRGRx">Query Parameters</h4><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">organization_guid</span><span class="Parameter_type__djM_s">string</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">A GUID for a Bitly organization</div></div></div></div><div class="MethodDetail_examples__8nXeM"><div><label class="CodeSyntaxSelector_header__6P_Jc CodeSyntaxSelector_headerDark__hI3A0"><span>Request</span><div class="Select_wrapper__58utF Select_dark__KPIws"><select class="Select_select__qXz_Z Select_dark__KPIws" aria-label="Select" autocomplete="off"><option value="cURL" selected="">cURL</option><option value="Node">Node</option><option value="Browser">Browser</option><option value="Go">Go</option><option value="Python">Python</option></select><svg viewbox="0 0 8 14" xmlns="http://www.w3.org/2000/svg"><path d="M6.463 7 .987 1.66a.61.61 0 0 1 0-.878.648.648 0 0 1 .9 0L7.813 6.56a.61.61 0 0 1 0 .878l-5.926 5.78a.648.648 0 0 1-.9 0 .61.61 0 0 1 0-.879L6.463 7Z"></path></svg></div></label><div class="CodeSyntaxSelector_body__hBJ7j CodeSyntaxSelector_bodyDark__cizVw" tabindex="0"><div class="CodeBlock_codeBlock__KlURa"><pre tabindex="0" style="color:#ffffff;font-family:ProximaNova, monospace;line-height:1.2;font-size:1rem"><code class="language-bash" style="white-space:pre"><span class="token token" style="color:#ee6123">curl</span><span> </span><span class="token token punctuation">\</span><span> </span><span>-H </span><span class="token token" style="color:#acda95">'Authorization: Bearer {TOKEN}'</span><span> </span><span class="token token punctuation">\</span><span> </span><span>-X GET </span><span class="token token punctuation">\</span><span> </span><span>https://api-ssl.bitly.com/v4/groups?organization_guid</span><span class="token token operator">=</span><span>Oa1bcd234eF</span></code></pre></div></div></div><div><label class="CodeSyntaxSelector_header__6P_Jc"><span>Response</span><div class="Select_wrapper__58utF"><select class="Select_select__qXz_Z" aria-label="Select" autocomplete="off"><option value="200" selected="">200 SUCCESS</option><option value="400">400 BAD_REQUEST</option><option value="403">403 FORBIDDEN</option><option value="404">404 NOT_FOUND</option><option value="422">422 UNPROCESSABLE_ENTITY</option><option value="500">500 INTERNAL_ERROR</option><option value="503">503 TEMPORARILY_UNAVAILABLE</option></select><svg viewbox="0 0 8 14" xmlns="http://www.w3.org/2000/svg"><path d="M6.463 7 .987 1.66a.61.61 0 0 1 0-.878.648.648 0 0 1 .9 0L7.813 6.56a.61.61 0 0 1 0 .878l-5.926 5.78a.648.648 0 0 1-.9 0 .61.61 0 0 1 0-.879L6.463 7Z"></path></svg></div></label><div class="CodeSyntaxSelector_body__hBJ7j" tabindex="0"><div class="CodeBlock_codeBlock__KlURa"><pre tabindex="0" style="color:#36383b;font-family:ProximaNova, monospace;line-height:1.2;font-size:1rem"><code class="language-json" style="white-space:pre"><span class="token token punctuation">{</span><span> </span><span> </span><span class="token token property">"groups"</span><span class="token token operator">:</span><span> </span><span class="token token punctuation">[</span><span> </span><span> </span><span class="token token punctuation">{</span><span> </span><span> </span><span class="token token property">"references"</span><span class="token token operator">:</span><span> </span><span class="token token punctuation">{</span><span> </span><span class="token token" style="color:#51763e">"any"</span><span> </span><span class="token token punctuation">}</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"name"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"guid"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"created"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"modified"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"is_active"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"boolean"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"role"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"organization_guid"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"bsds"</span><span class="token token operator">:</span><span> </span><span class="token token punctuation">[</span><span> </span><span> </span><span class="token token" style="color:#51763e">"string"</span><span> </span><span> </span><span class="token token punctuation">]</span><span> </span><span> </span><span class="token token punctuation">}</span><span> </span><span> </span><span class="token token punctuation">]</span><span> </span><span></span><span class="token token punctuation">}</span></code></pre></div></div></div></div></div><div class="MethodDetail_methodContainer__3EF7h" id="updateGroup"><div class="MethodDetail_method__fyEiw"><div><h3 class="MethodHeader_h3__seOfC">Update a Group</h3><h4 class="MethodHeader_description__3_p_p"><div class="MethodHeader_iconStyle__x5Ow4"><svg viewbox="0 0 23 6" xmlns="http://www.w3.org/2000/svg" class="IconRest_restIcon__3pju8 patch"><title>Patch</title><path d="M1.095 5.885V3.898c.027.006.07.011.132.017a4.052 4.052 0 0 0 .372.016h.128c.277 0 .545-.037.803-.11.259-.075.49-.193.692-.355.202-.162.365-.368.487-.618.123-.25.184-.551.184-.903 0-.401-.07-.727-.212-.977a1.606 1.606 0 0 0-.547-.585 2.041 2.041 0 0 0-.756-.28 5.067 5.067 0 0 0-.835-.07c-.267 0-.534.012-.804.037C.47.095.224.13 0 .173v5.712h1.095Zm.472-2.934h-.1a2.448 2.448 0 0 1-.276-.017.853.853 0 0 1-.096-.016V1.047c.059-.011.136-.02.232-.03.096-.007.197-.012.304-.012.138 0 .274.014.408.042a.964.964 0 0 1 .355.148.801.801 0 0 1 .252.284.937.937 0 0 1 .096.45c0 .214-.033.387-.1.519a.787.787 0 0 1-.268.309 1.038 1.038 0 0 1-.38.152 2.235 2.235 0 0 1-.427.042Zm3.79 2.934.383-1.278h1.67l.4 1.278h1.152L7.163.115H6.068L4.26 5.885h1.095ZM7.194 3.7h-1.2l.56-1.929h.072l.568 1.929Zm5.668 2.184v-.907h-.903V1.022h.76v.997h.879V.115H9.218V2.02h.879v-.997h.767v3.956h-.91v.907h2.91Zm3.91.115c.276 0 .547-.036.81-.107.265-.072.482-.17.652-.297V3.948h-.88v.997c-.164.033-.335.05-.51.05-.246 0-.464-.049-.656-.145a1.383 1.383 0 0 1-.488-.408 1.881 1.881 0 0 1-.304-.63A2.973 2.973 0 0 1 15.293 3c0-.34.038-.636.112-.886.075-.25.179-.457.312-.622.133-.165.29-.287.468-.367.178-.08.371-.12.58-.12.175 0 .346.014.511.042v.94h.88V.271a2.727 2.727 0 0 0-.548-.19A3.419 3.419 0 0 0 16.796 0c-.303 0-.613.05-.927.152-.314.102-.6.27-.855.503a2.611 2.611 0 0 0-.628.923c-.163.382-.244.856-.244 1.422 0 .544.072 1.007.216 1.389.144.382.336.692.576.931.24.24.518.412.835.52.317.106.652.16 1.003.16Zm3.325-.115V3.47h1.807v2.415H23V.115h-1.095v2.35h-1.807V.114h-1.095v5.77h1.095Z"></path></svg></div> /v4/groups/{group_guid}</h4><p class="MethodHeader_description__3_p_p">Updates the details of a group.</p></div><div><h4 class="ParameterList_h4__nH9G8 ParameterList_dividing__wRGRx">Path Parameters</h4><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">group_guid</span><span class="Parameter_type__djM_s">string</span><span class="Parameter_required__pcK_H">Required</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">A GUID for a Bitly group</div></div></div><div><h4 class="ParameterList_h4__nH9G8 ParameterList_dividing__wRGRx">Request Body Schema</h4><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">name</span><span class="Parameter_type__djM_s">string</span></div></div><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">organization_guid</span><span class="Parameter_type__djM_s">string</span></div></div><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">bsds</span><span class="Parameter_type__djM_s">array of string</span></div></div></div></div><div class="MethodDetail_examples__8nXeM"><div><label class="CodeSyntaxSelector_header__6P_Jc CodeSyntaxSelector_headerDark__hI3A0"><span>Request</span><div class="Select_wrapper__58utF Select_dark__KPIws"><select class="Select_select__qXz_Z Select_dark__KPIws" aria-label="Select" autocomplete="off"><option value="cURL" selected="">cURL</option><option value="Node">Node</option><option value="Browser">Browser</option><option value="Go">Go</option><option value="Python">Python</option></select><svg viewbox="0 0 8 14" xmlns="http://www.w3.org/2000/svg"><path d="M6.463 7 .987 1.66a.61.61 0 0 1 0-.878.648.648 0 0 1 .9 0L7.813 6.56a.61.61 0 0 1 0 .878l-5.926 5.78a.648.648 0 0 1-.9 0 .61.61 0 0 1 0-.879L6.463 7Z"></path></svg></div></label><div class="CodeSyntaxSelector_body__hBJ7j CodeSyntaxSelector_bodyDark__cizVw" tabindex="0"><div class="CodeBlock_codeBlock__KlURa"><pre tabindex="0" style="color:#ffffff;font-family:ProximaNova, monospace;line-height:1.2;font-size:1rem"><code class="language-bash" style="white-space:pre"><span class="token token" style="color:#ee6123">curl</span><span> </span><span class="token token punctuation">\</span><span> </span><span>-H </span><span class="token token" style="color:#acda95">'Authorization: Bearer {TOKEN}'</span><span> </span><span class="token token punctuation">\</span><span> </span><span>-H </span><span class="token token" style="color:#acda95">'Content-Type: application/json'</span><span> </span><span class="token token punctuation">\</span><span> </span><span>-X PATCH </span><span class="token token punctuation">\</span><span> </span><span>-d </span><span class="token token" style="color:#acda95">'{ </span><span class="token token" style="color:#acda95"> "name": "My New Group", </span><span class="token token" style="color:#acda95"> "organization_guid": "Oa1bcd234eF", </span><span class="token token" style="color:#acda95"> "bsds": [ </span><span class="token token" style="color:#acda95"> "chauncey.ly" </span><span class="token token" style="color:#acda95"> ] </span><span class="token token" style="color:#acda95">}'</span><span> </span><span class="token token punctuation">\</span><span> </span>https://api-ssl.bitly.com/v4/groups/Ba1bc23dE4F</code></pre></div></div></div><div><label class="CodeSyntaxSelector_header__6P_Jc"><span>Response</span><div class="Select_wrapper__58utF"><select class="Select_select__qXz_Z" aria-label="Select" autocomplete="off"><option value="200" selected="">200 SUCCESS</option><option value="400">400 BAD_REQUEST</option><option value="403">403 FORBIDDEN</option><option value="404">404 NOT_FOUND</option><option value="422">422 UNPROCESSABLE_ENTITY</option><option value="500">500 INTERNAL_ERROR</option><option value="503">503 TEMPORARILY_UNAVAILABLE</option></select><svg viewbox="0 0 8 14" xmlns="http://www.w3.org/2000/svg"><path d="M6.463 7 .987 1.66a.61.61 0 0 1 0-.878.648.648 0 0 1 .9 0L7.813 6.56a.61.61 0 0 1 0 .878l-5.926 5.78a.648.648 0 0 1-.9 0 .61.61 0 0 1 0-.879L6.463 7Z"></path></svg></div></label><div class="CodeSyntaxSelector_body__hBJ7j" tabindex="0"><div class="CodeBlock_codeBlock__KlURa"><pre tabindex="0" style="color:#36383b;font-family:ProximaNova, monospace;line-height:1.2;font-size:1rem"><code class="language-json" style="white-space:pre"><span class="token token punctuation">{</span><span> </span><span> </span><span class="token token property">"references"</span><span class="token token operator">:</span><span> </span><span class="token token punctuation">{</span><span> </span><span class="token token" style="color:#51763e">"any"</span><span> </span><span class="token token punctuation">}</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"name"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"guid"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"created"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"modified"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"is_active"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"boolean"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"role"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"organization_guid"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"bsds"</span><span class="token token operator">:</span><span> </span><span class="token token punctuation">[</span><span> </span><span> </span><span class="token token" style="color:#51763e">"string"</span><span> </span><span> </span><span class="token token punctuation">]</span><span> </span><span></span><span class="token token punctuation">}</span></code></pre></div></div></div></div></div><div class="MethodDetail_methodContainer__3EF7h" id="getGroup"><div class="MethodDetail_method__fyEiw"><div><h3 class="MethodHeader_h3__seOfC">Retrieve a Group</h3><h4 class="MethodHeader_description__3_p_p"><div class="MethodHeader_iconStyle__x5Ow4"><svg viewbox="0 0 14 6" xmlns="http://www.w3.org/2000/svg" class="IconRest_restIcon__3pju8 get"><title>Get</title><path d="M2.587 6c.307 0 .607-.044.9-.132.295-.088.533-.217.716-.387V2.876H2.271v.825h1.027v1.145a.772.772 0 0 1-.239.1 1.4 1.4 0 0 1-.383.049 1.338 1.338 0 0 1-1.083-.52c-.135-.17-.24-.379-.316-.626a2.879 2.879 0 0 1-.113-.84c0-.352.038-.655.113-.907.076-.253.182-.46.32-.623.137-.162.3-.281.488-.358a1.783 1.783 0 0 1 .97-.082l.13.032v.915h.889V.28a3.182 3.182 0 0 0-.59-.202A3.507 3.507 0 0 0 2.676 0c-.313 0-.628.055-.946.165a2.4 2.4 0 0 0-.861.523 2.707 2.707 0 0 0-.627.92C.081 1.98 0 2.433 0 2.966c0 .506.067.946.202 1.323.135.376.318.692.55.948a2.2 2.2 0 0 0 .82.572A2.7 2.7 0 0 0 2.587 6Zm6.24-.115V4.879H6.184V3.47h2.4V2.465h-2.4V1.121h2.602V.115h-3.71v5.77h3.75Zm4.43 0v-.907h-.914V1.022h.768v.997H14V.115H9.57V2.02h.89v-.997h.776v3.956h-.922v.907h2.942Z"></path></svg></div> /v4/groups/{group_guid}</h4><p class="MethodHeader_description__3_p_p">Returns details for a group.</p></div><div><h4 class="ParameterList_h4__nH9G8 ParameterList_dividing__wRGRx">Path Parameters</h4><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">group_guid</span><span class="Parameter_type__djM_s">string</span><span class="Parameter_required__pcK_H">Required</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">A GUID for a Bitly group</div></div></div></div><div class="MethodDetail_examples__8nXeM"><div><label class="CodeSyntaxSelector_header__6P_Jc CodeSyntaxSelector_headerDark__hI3A0"><span>Request</span><div class="Select_wrapper__58utF Select_dark__KPIws"><select class="Select_select__qXz_Z Select_dark__KPIws" aria-label="Select" autocomplete="off"><option value="cURL" selected="">cURL</option><option value="Node">Node</option><option value="Browser">Browser</option><option value="Go">Go</option><option value="Python">Python</option></select><svg viewbox="0 0 8 14" xmlns="http://www.w3.org/2000/svg"><path d="M6.463 7 .987 1.66a.61.61 0 0 1 0-.878.648.648 0 0 1 .9 0L7.813 6.56a.61.61 0 0 1 0 .878l-5.926 5.78a.648.648 0 0 1-.9 0 .61.61 0 0 1 0-.879L6.463 7Z"></path></svg></div></label><div class="CodeSyntaxSelector_body__hBJ7j CodeSyntaxSelector_bodyDark__cizVw" tabindex="0"><div class="CodeBlock_codeBlock__KlURa"><pre tabindex="0" style="color:#ffffff;font-family:ProximaNova, monospace;line-height:1.2;font-size:1rem"><code class="language-bash" style="white-space:pre"><span class="token token" style="color:#ee6123">curl</span><span> </span><span class="token token punctuation">\</span><span> </span><span>-H </span><span class="token token" style="color:#acda95">'Authorization: Bearer {TOKEN}'</span><span> </span><span class="token token punctuation">\</span><span> </span><span>-X GET </span><span class="token token punctuation">\</span><span> </span>https://api-ssl.bitly.com/v4/groups/Ba1bc23dE4F</code></pre></div></div></div><div><label class="CodeSyntaxSelector_header__6P_Jc"><span>Response</span><div class="Select_wrapper__58utF"><select class="Select_select__qXz_Z" aria-label="Select" autocomplete="off"><option value="200" selected="">200 SUCCESS</option><option value="403">403 FORBIDDEN</option><option value="404">404 NOT_FOUND</option><option value="500">500 INTERNAL_ERROR</option><option value="503">503 TEMPORARILY_UNAVAILABLE</option></select><svg viewbox="0 0 8 14" xmlns="http://www.w3.org/2000/svg"><path d="M6.463 7 .987 1.66a.61.61 0 0 1 0-.878.648.648 0 0 1 .9 0L7.813 6.56a.61.61 0 0 1 0 .878l-5.926 5.78a.648.648 0 0 1-.9 0 .61.61 0 0 1 0-.879L6.463 7Z"></path></svg></div></label><div class="CodeSyntaxSelector_body__hBJ7j" tabindex="0"><div class="CodeBlock_codeBlock__KlURa"><pre tabindex="0" style="color:#36383b;font-family:ProximaNova, monospace;line-height:1.2;font-size:1rem"><code class="language-json" style="white-space:pre"><span class="token token punctuation">{</span><span> </span><span> </span><span class="token token property">"references"</span><span class="token token operator">:</span><span> </span><span class="token token punctuation">{</span><span> </span><span class="token token" style="color:#51763e">"any"</span><span> </span><span class="token token punctuation">}</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"name"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"guid"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"created"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"modified"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"is_active"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"boolean"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"role"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"organization_guid"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"bsds"</span><span class="token token operator">:</span><span> </span><span class="token token punctuation">[</span><span> </span><span> </span><span class="token token" style="color:#51763e">"string"</span><span> </span><span> </span><span class="token token punctuation">]</span><span> </span><span></span><span class="token token punctuation">}</span></code></pre></div></div></div></div></div><div class="MethodDetail_methodContainer__3EF7h" id="getGroupTags"><div class="MethodDetail_method__fyEiw"><div><h3 class="MethodHeader_h3__seOfC">Retrieve Tags by Group</h3><h4 class="MethodHeader_description__3_p_p"><div class="MethodHeader_iconStyle__x5Ow4"><svg viewbox="0 0 14 6" xmlns="http://www.w3.org/2000/svg" class="IconRest_restIcon__3pju8 get"><title>Get</title><path d="M2.587 6c.307 0 .607-.044.9-.132.295-.088.533-.217.716-.387V2.876H2.271v.825h1.027v1.145a.772.772 0 0 1-.239.1 1.4 1.4 0 0 1-.383.049 1.338 1.338 0 0 1-1.083-.52c-.135-.17-.24-.379-.316-.626a2.879 2.879 0 0 1-.113-.84c0-.352.038-.655.113-.907.076-.253.182-.46.32-.623.137-.162.3-.281.488-.358a1.783 1.783 0 0 1 .97-.082l.13.032v.915h.889V.28a3.182 3.182 0 0 0-.59-.202A3.507 3.507 0 0 0 2.676 0c-.313 0-.628.055-.946.165a2.4 2.4 0 0 0-.861.523 2.707 2.707 0 0 0-.627.92C.081 1.98 0 2.433 0 2.966c0 .506.067.946.202 1.323.135.376.318.692.55.948a2.2 2.2 0 0 0 .82.572A2.7 2.7 0 0 0 2.587 6Zm6.24-.115V4.879H6.184V3.47h2.4V2.465h-2.4V1.121h2.602V.115h-3.71v5.77h3.75Zm4.43 0v-.907h-.914V1.022h.768v.997H14V.115H9.57V2.02h.89v-.997h.776v3.956h-.922v.907h2.942Z"></path></svg></div> /v4/groups/{group_guid}/tags</h4><p class="MethodHeader_description__3_p_p">Returns the tags currently used in the specified group. Maximum 1000.</p></div><div><h4 class="ParameterList_h4__nH9G8 ParameterList_dividing__wRGRx">Path Parameters</h4><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">group_guid</span><span class="Parameter_type__djM_s">string</span><span class="Parameter_required__pcK_H">Required</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">A GUID for a Bitly group</div></div></div></div><div class="MethodDetail_examples__8nXeM"><div><label class="CodeSyntaxSelector_header__6P_Jc CodeSyntaxSelector_headerDark__hI3A0"><span>Request</span><div class="Select_wrapper__58utF Select_dark__KPIws"><select class="Select_select__qXz_Z Select_dark__KPIws" aria-label="Select" autocomplete="off"><option value="cURL" selected="">cURL</option><option value="Node">Node</option><option value="Browser">Browser</option><option value="Go">Go</option><option value="Python">Python</option></select><svg viewbox="0 0 8 14" xmlns="http://www.w3.org/2000/svg"><path d="M6.463 7 .987 1.66a.61.61 0 0 1 0-.878.648.648 0 0 1 .9 0L7.813 6.56a.61.61 0 0 1 0 .878l-5.926 5.78a.648.648 0 0 1-.9 0 .61.61 0 0 1 0-.879L6.463 7Z"></path></svg></div></label><div class="CodeSyntaxSelector_body__hBJ7j CodeSyntaxSelector_bodyDark__cizVw" tabindex="0"><div class="CodeBlock_codeBlock__KlURa"><pre tabindex="0" style="color:#ffffff;font-family:ProximaNova, monospace;line-height:1.2;font-size:1rem"><code class="language-bash" style="white-space:pre"><span class="token token" style="color:#ee6123">curl</span><span> </span><span class="token token punctuation">\</span><span> </span><span>-H </span><span class="token token" style="color:#acda95">'Authorization: Bearer {TOKEN}'</span><span> </span><span class="token token punctuation">\</span><span> </span><span>-X GET </span><span class="token token punctuation">\</span><span> </span>https://api-ssl.bitly.com/v4/groups/Ba1bc23dE4F/tags</code></pre></div></div></div><div><label class="CodeSyntaxSelector_header__6P_Jc"><span>Response</span><div class="Select_wrapper__58utF"><select class="Select_select__qXz_Z" aria-label="Select" autocomplete="off"><option value="200" selected="">200 SUCCESS</option><option value="403">403 FORBIDDEN</option><option value="404">404 NOT_FOUND</option><option value="500">500 INTERNAL_ERROR</option><option value="503">503 TEMPORARILY_UNAVAILABLE</option></select><svg viewbox="0 0 8 14" xmlns="http://www.w3.org/2000/svg"><path d="M6.463 7 .987 1.66a.61.61 0 0 1 0-.878.648.648 0 0 1 .9 0L7.813 6.56a.61.61 0 0 1 0 .878l-5.926 5.78a.648.648 0 0 1-.9 0 .61.61 0 0 1 0-.879L6.463 7Z"></path></svg></div></label><div class="CodeSyntaxSelector_body__hBJ7j" tabindex="0"><div class="CodeBlock_codeBlock__KlURa"><pre tabindex="0" style="color:#36383b;font-family:ProximaNova, monospace;line-height:1.2;font-size:1rem"><code class="language-json" style="white-space:pre"><span class="token token punctuation">{</span><span> </span><span> </span><span class="token token property">"tags"</span><span class="token token operator">:</span><span> </span><span class="token token punctuation">[</span><span> </span><span> </span><span class="token token" style="color:#51763e">"string"</span><span> </span><span> </span><span class="token token punctuation">]</span><span> </span><span></span><span class="token token punctuation">}</span></code></pre></div></div></div></div></div><div class="MethodDetail_methodContainer__3EF7h" id="getGroupPreferences"><div class="MethodDetail_method__fyEiw"><div><h3 class="MethodHeader_h3__seOfC">Retrieve Group Preferences</h3><h4 class="MethodHeader_description__3_p_p"><div class="MethodHeader_iconStyle__x5Ow4"><svg viewbox="0 0 14 6" xmlns="http://www.w3.org/2000/svg" class="IconRest_restIcon__3pju8 get"><title>Get</title><path d="M2.587 6c.307 0 .607-.044.9-.132.295-.088.533-.217.716-.387V2.876H2.271v.825h1.027v1.145a.772.772 0 0 1-.239.1 1.4 1.4 0 0 1-.383.049 1.338 1.338 0 0 1-1.083-.52c-.135-.17-.24-.379-.316-.626a2.879 2.879 0 0 1-.113-.84c0-.352.038-.655.113-.907.076-.253.182-.46.32-.623.137-.162.3-.281.488-.358a1.783 1.783 0 0 1 .97-.082l.13.032v.915h.889V.28a3.182 3.182 0 0 0-.59-.202A3.507 3.507 0 0 0 2.676 0c-.313 0-.628.055-.946.165a2.4 2.4 0 0 0-.861.523 2.707 2.707 0 0 0-.627.92C.081 1.98 0 2.433 0 2.966c0 .506.067.946.202 1.323.135.376.318.692.55.948a2.2 2.2 0 0 0 .82.572A2.7 2.7 0 0 0 2.587 6Zm6.24-.115V4.879H6.184V3.47h2.4V2.465h-2.4V1.121h2.602V.115h-3.71v5.77h3.75Zm4.43 0v-.907h-.914V1.022h.768v.997H14V.115H9.57V2.02h.89v-.997h.776v3.956h-.922v.907h2.942Z"></path></svg></div> /v4/groups/{group_guid}/preferences</h4><p class="MethodHeader_description__3_p_p">Returns preferences for the specified group.</p></div><div><h4 class="ParameterList_h4__nH9G8 ParameterList_dividing__wRGRx">Path Parameters</h4><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">group_guid</span><span class="Parameter_type__djM_s">string</span><span class="Parameter_required__pcK_H">Required</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">A GUID for a Bitly group</div></div></div></div><div class="MethodDetail_examples__8nXeM"><div><label class="CodeSyntaxSelector_header__6P_Jc CodeSyntaxSelector_headerDark__hI3A0"><span>Request</span><div class="Select_wrapper__58utF Select_dark__KPIws"><select class="Select_select__qXz_Z Select_dark__KPIws" aria-label="Select" autocomplete="off"><option value="cURL" selected="">cURL</option><option value="Node">Node</option><option value="Browser">Browser</option><option value="Go">Go</option><option value="Python">Python</option></select><svg viewbox="0 0 8 14" xmlns="http://www.w3.org/2000/svg"><path d="M6.463 7 .987 1.66a.61.61 0 0 1 0-.878.648.648 0 0 1 .9 0L7.813 6.56a.61.61 0 0 1 0 .878l-5.926 5.78a.648.648 0 0 1-.9 0 .61.61 0 0 1 0-.879L6.463 7Z"></path></svg></div></label><div class="CodeSyntaxSelector_body__hBJ7j CodeSyntaxSelector_bodyDark__cizVw" tabindex="0"><div class="CodeBlock_codeBlock__KlURa"><pre tabindex="0" style="color:#ffffff;font-family:ProximaNova, monospace;line-height:1.2;font-size:1rem"><code class="language-bash" style="white-space:pre"><span class="token token" style="color:#ee6123">curl</span><span> </span><span class="token token punctuation">\</span><span> </span><span>-H </span><span class="token token" style="color:#acda95">'Authorization: Bearer {TOKEN}'</span><span> </span><span class="token token punctuation">\</span><span> </span><span>-X GET </span><span class="token token punctuation">\</span><span> </span>https://api-ssl.bitly.com/v4/groups/Ba1bc23dE4F/preferences</code></pre></div></div></div><div><label class="CodeSyntaxSelector_header__6P_Jc"><span>Response</span><div class="Select_wrapper__58utF"><select class="Select_select__qXz_Z" aria-label="Select" autocomplete="off"><option value="200" selected="">200 SUCCESS</option><option value="403">403 FORBIDDEN</option><option value="404">404 NOT_FOUND</option><option value="500">500 INTERNAL_ERROR</option><option value="503">503 TEMPORARILY_UNAVAILABLE</option></select><svg viewbox="0 0 8 14" xmlns="http://www.w3.org/2000/svg"><path d="M6.463 7 .987 1.66a.61.61 0 0 1 0-.878.648.648 0 0 1 .9 0L7.813 6.56a.61.61 0 0 1 0 .878l-5.926 5.78a.648.648 0 0 1-.9 0 .61.61 0 0 1 0-.879L6.463 7Z"></path></svg></div></label><div class="CodeSyntaxSelector_body__hBJ7j" tabindex="0"><div class="CodeBlock_codeBlock__KlURa"><pre tabindex="0" style="color:#36383b;font-family:ProximaNova, monospace;line-height:1.2;font-size:1rem"><code class="language-json" style="white-space:pre"><span class="token token punctuation">{</span><span> </span><span> </span><span class="token token property">"group_guid"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"domain_preference"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span> </span><span></span><span class="token token punctuation">}</span></code></pre></div></div></div></div></div><div class="MethodDetail_methodContainer__3EF7h" id="updateGroupPreferences"><div class="MethodDetail_method__fyEiw"><div><h3 class="MethodHeader_h3__seOfC">Update Group Preferences</h3><h4 class="MethodHeader_description__3_p_p"><div class="MethodHeader_iconStyle__x5Ow4"><svg viewbox="0 0 23 6" xmlns="http://www.w3.org/2000/svg" class="IconRest_restIcon__3pju8 patch"><title>Patch</title><path d="M1.095 5.885V3.898c.027.006.07.011.132.017a4.052 4.052 0 0 0 .372.016h.128c.277 0 .545-.037.803-.11.259-.075.49-.193.692-.355.202-.162.365-.368.487-.618.123-.25.184-.551.184-.903 0-.401-.07-.727-.212-.977a1.606 1.606 0 0 0-.547-.585 2.041 2.041 0 0 0-.756-.28 5.067 5.067 0 0 0-.835-.07c-.267 0-.534.012-.804.037C.47.095.224.13 0 .173v5.712h1.095Zm.472-2.934h-.1a2.448 2.448 0 0 1-.276-.017.853.853 0 0 1-.096-.016V1.047c.059-.011.136-.02.232-.03.096-.007.197-.012.304-.012.138 0 .274.014.408.042a.964.964 0 0 1 .355.148.801.801 0 0 1 .252.284.937.937 0 0 1 .096.45c0 .214-.033.387-.1.519a.787.787 0 0 1-.268.309 1.038 1.038 0 0 1-.38.152 2.235 2.235 0 0 1-.427.042Zm3.79 2.934.383-1.278h1.67l.4 1.278h1.152L7.163.115H6.068L4.26 5.885h1.095ZM7.194 3.7h-1.2l.56-1.929h.072l.568 1.929Zm5.668 2.184v-.907h-.903V1.022h.76v.997h.879V.115H9.218V2.02h.879v-.997h.767v3.956h-.91v.907h2.91Zm3.91.115c.276 0 .547-.036.81-.107.265-.072.482-.17.652-.297V3.948h-.88v.997c-.164.033-.335.05-.51.05-.246 0-.464-.049-.656-.145a1.383 1.383 0 0 1-.488-.408 1.881 1.881 0 0 1-.304-.63A2.973 2.973 0 0 1 15.293 3c0-.34.038-.636.112-.886.075-.25.179-.457.312-.622.133-.165.29-.287.468-.367.178-.08.371-.12.58-.12.175 0 .346.014.511.042v.94h.88V.271a2.727 2.727 0 0 0-.548-.19A3.419 3.419 0 0 0 16.796 0c-.303 0-.613.05-.927.152-.314.102-.6.27-.855.503a2.611 2.611 0 0 0-.628.923c-.163.382-.244.856-.244 1.422 0 .544.072 1.007.216 1.389.144.382.336.692.576.931.24.24.518.412.835.52.317.106.652.16 1.003.16Zm3.325-.115V3.47h1.807v2.415H23V.115h-1.095v2.35h-1.807V.114h-1.095v5.77h1.095Z"></path></svg></div> /v4/groups/{group_guid}/preferences</h4><p class="MethodHeader_description__3_p_p">Updates preferences for a group.</p></div><div><h4 class="ParameterList_h4__nH9G8 ParameterList_dividing__wRGRx">Path Parameters</h4><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">group_guid</span><span class="Parameter_type__djM_s">string</span><span class="Parameter_required__pcK_H">Required</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">A GUID for a Bitly group</div></div></div><div><h4 class="ParameterList_h4__nH9G8 ParameterList_dividing__wRGRx">Request Body Schema</h4><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">group_guid</span><span class="Parameter_type__djM_s">string</span></div></div><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">domain_preference</span><span class="Parameter_type__djM_s">string</span></div></div></div></div><div class="MethodDetail_examples__8nXeM"><div><label class="CodeSyntaxSelector_header__6P_Jc CodeSyntaxSelector_headerDark__hI3A0"><span>Request</span><div class="Select_wrapper__58utF Select_dark__KPIws"><select class="Select_select__qXz_Z Select_dark__KPIws" aria-label="Select" autocomplete="off"><option value="cURL" selected="">cURL</option><option value="Node">Node</option><option value="Browser">Browser</option><option value="Go">Go</option><option value="Python">Python</option></select><svg viewbox="0 0 8 14" xmlns="http://www.w3.org/2000/svg"><path d="M6.463 7 .987 1.66a.61.61 0 0 1 0-.878.648.648 0 0 1 .9 0L7.813 6.56a.61.61 0 0 1 0 .878l-5.926 5.78a.648.648 0 0 1-.9 0 .61.61 0 0 1 0-.879L6.463 7Z"></path></svg></div></label><div class="CodeSyntaxSelector_body__hBJ7j CodeSyntaxSelector_bodyDark__cizVw" tabindex="0"><div class="CodeBlock_codeBlock__KlURa"><pre tabindex="0" style="color:#ffffff;font-family:ProximaNova, monospace;line-height:1.2;font-size:1rem"><code class="language-bash" style="white-space:pre"><span class="token token" style="color:#ee6123">curl</span><span> </span><span class="token token punctuation">\</span><span> </span><span>-H </span><span class="token token" style="color:#acda95">'Authorization: Bearer {TOKEN}'</span><span> </span><span class="token token punctuation">\</span><span> </span><span>-H </span><span class="token token" style="color:#acda95">'Content-Type: application/json'</span><span> </span><span class="token token punctuation">\</span><span> </span><span>-X PATCH </span><span class="token token punctuation">\</span><span> </span><span>-d </span><span class="token token" style="color:#acda95">'{ </span><span class="token token" style="color:#acda95"> "group_guid": "Ba1bc23dE4F", </span><span class="token token" style="color:#acda95"> "domain_preference": "chauncey.ly" </span><span class="token token" style="color:#acda95">}'</span><span> </span><span class="token token punctuation">\</span><span> </span>https://api-ssl.bitly.com/v4/groups/Ba1bc23dE4F/preferences</code></pre></div></div></div><div><label class="CodeSyntaxSelector_header__6P_Jc"><span>Response</span><div class="Select_wrapper__58utF"><select class="Select_select__qXz_Z" aria-label="Select" autocomplete="off"><option value="200" selected="">200 SUCCESS</option><option value="400">400 BAD_REQUEST</option><option value="403">403 FORBIDDEN</option><option value="404">404 NOT_FOUND</option><option value="422">422 UNPROCESSABLE_ENTITY</option><option value="500">500 INTERNAL_ERROR</option><option value="503">503 TEMPORARILY_UNAVAILABLE</option></select><svg viewbox="0 0 8 14" xmlns="http://www.w3.org/2000/svg"><path d="M6.463 7 .987 1.66a.61.61 0 0 1 0-.878.648.648 0 0 1 .9 0L7.813 6.56a.61.61 0 0 1 0 .878l-5.926 5.78a.648.648 0 0 1-.9 0 .61.61 0 0 1 0-.879L6.463 7Z"></path></svg></div></label><div class="CodeSyntaxSelector_body__hBJ7j" tabindex="0"><div class="CodeBlock_codeBlock__KlURa"><pre tabindex="0" style="color:#36383b;font-family:ProximaNova, monospace;line-height:1.2;font-size:1rem"><code class="language-json" style="white-space:pre"><span class="token token punctuation">{</span><span> </span><span> </span><span class="token token property">"group_guid"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"domain_preference"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span> </span><span></span><span class="token token punctuation">}</span></code></pre></div></div></div></div></div><div class="MethodDetail_methodContainer__3EF7h" id="getGroupShortenCounts"><div class="MethodDetail_method__fyEiw"><div><h3 class="MethodHeader_h3__seOfC">Retrieve Group Shorten Counts</h3><h4 class="MethodHeader_description__3_p_p"><div class="MethodHeader_iconStyle__x5Ow4"><svg viewbox="0 0 14 6" xmlns="http://www.w3.org/2000/svg" class="IconRest_restIcon__3pju8 get"><title>Get</title><path d="M2.587 6c.307 0 .607-.044.9-.132.295-.088.533-.217.716-.387V2.876H2.271v.825h1.027v1.145a.772.772 0 0 1-.239.1 1.4 1.4 0 0 1-.383.049 1.338 1.338 0 0 1-1.083-.52c-.135-.17-.24-.379-.316-.626a2.879 2.879 0 0 1-.113-.84c0-.352.038-.655.113-.907.076-.253.182-.46.32-.623.137-.162.3-.281.488-.358a1.783 1.783 0 0 1 .97-.082l.13.032v.915h.889V.28a3.182 3.182 0 0 0-.59-.202A3.507 3.507 0 0 0 2.676 0c-.313 0-.628.055-.946.165a2.4 2.4 0 0 0-.861.523 2.707 2.707 0 0 0-.627.92C.081 1.98 0 2.433 0 2.966c0 .506.067.946.202 1.323.135.376.318.692.55.948a2.2 2.2 0 0 0 .82.572A2.7 2.7 0 0 0 2.587 6Zm6.24-.115V4.879H6.184V3.47h2.4V2.465h-2.4V1.121h2.602V.115h-3.71v5.77h3.75Zm4.43 0v-.907h-.914V1.022h.768v.997H14V.115H9.57V2.02h.89v-.997h.776v3.956h-.922v.907h2.942Z"></path></svg></div> /v4/groups/{group_guid}/shorten_counts</h4><p class="MethodHeader_description__3_p_p">Returns all the shorten counts for a group.</p></div><div><h4 class="ParameterList_h4__nH9G8 ParameterList_dividing__wRGRx">Path Parameters</h4><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">group_guid</span><span class="Parameter_type__djM_s">string</span><span class="Parameter_required__pcK_H">Required</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">A GUID for a Bitly group</div></div></div><div><h4 class="ParameterList_h4__nH9G8 ParameterList_dividing__wRGRx">Query Parameters</h4><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">unit</span><span class="Parameter_type__djM_s">string</span><span class="Parameter_required__pcK_H">Required</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">A unit of time</div><div class="Parameter_default__HHgG0 Parameter_spacer__JKXbH">Default: <span class="Parameter_label__DUY7G">"day"</span></div><div class="Parameter_enum__csO6P Parameter_spacer__JKXbH">Enum: <span class="Parameter_label__DUY7G">"minute"</span><span class="Parameter_label__DUY7G">"hour"</span><span class="Parameter_label__DUY7G">"day"</span><span class="Parameter_label__DUY7G">"week"</span><span class="Parameter_label__DUY7G">"month"</span></div></div><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">units</span><span class="Parameter_type__djM_s">integer</span><span class="Parameter_required__pcK_H">Required</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">An integer representing the time units to query data for. pass -1 to return all units of time.</div><div class="Parameter_default__HHgG0 Parameter_spacer__JKXbH">Default: <span class="Parameter_label__DUY7G">-1</span></div></div><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">unit_reference</span><span class="Parameter_type__djM_s">string</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">An ISO-8601 timestamp, indicating the most recent time for which to pull metrics. Will default to current time. Timestamp values should be url encoded (i.e. replace '+' with '%2B' and ':' with '%3A'; 2022-02-02T15:53:02+0000 becomes 2022-02-02T15%3A53%3A02%2B0000)</div></div></div></div><div class="MethodDetail_examples__8nXeM"><div><label class="CodeSyntaxSelector_header__6P_Jc CodeSyntaxSelector_headerDark__hI3A0"><span>Request</span><div class="Select_wrapper__58utF Select_dark__KPIws"><select class="Select_select__qXz_Z Select_dark__KPIws" aria-label="Select" autocomplete="off"><option value="cURL" selected="">cURL</option><option value="Node">Node</option><option value="Browser">Browser</option><option value="Go">Go</option><option value="Python">Python</option></select><svg viewbox="0 0 8 14" xmlns="http://www.w3.org/2000/svg"><path d="M6.463 7 .987 1.66a.61.61 0 0 1 0-.878.648.648 0 0 1 .9 0L7.813 6.56a.61.61 0 0 1 0 .878l-5.926 5.78a.648.648 0 0 1-.9 0 .61.61 0 0 1 0-.879L6.463 7Z"></path></svg></div></label><div class="CodeSyntaxSelector_body__hBJ7j CodeSyntaxSelector_bodyDark__cizVw" tabindex="0"><div class="CodeBlock_codeBlock__KlURa"><pre tabindex="0" style="color:#ffffff;font-family:ProximaNova, monospace;line-height:1.2;font-size:1rem"><code class="language-bash" style="white-space:pre"><span class="token token" style="color:#ee6123">curl</span><span> </span><span class="token token punctuation">\</span><span> </span><span>-H </span><span class="token token" style="color:#acda95">'Authorization: Bearer {TOKEN}'</span><span> </span><span class="token token punctuation">\</span><span> </span><span>-X GET </span><span class="token token punctuation">\</span><span> </span><span>https://api-ssl.bitly.com/v4/groups/Ba1bc23dE4F/shorten_counts?unit</span><span class="token token operator">=</span><span>month</span><span class="token token operator">&</span><span class="token token assign-left variable">units</span><span class="token token operator">=</span><span class="token token" style="color:#a1b8f3">5</span><span class="token token operator">&</span><span class="token token assign-left variable">unit_reference</span><span class="token token operator">=</span><span class="token token" style="color:#a1b8f3">2006</span><span>-01-02T15%3A04%3A05-0700</span></code></pre></div></div></div><div><label class="CodeSyntaxSelector_header__6P_Jc"><span>Response</span><div class="Select_wrapper__58utF"><select class="Select_select__qXz_Z" aria-label="Select" autocomplete="off"><option value="200" selected="">200 SUCCESS</option><option value="403">403 FORBIDDEN</option><option value="404">404 NOT_FOUND</option><option value="500">500 INTERNAL_ERROR</option><option value="503">503 TEMPORARILY_UNAVAILABLE</option></select><svg viewbox="0 0 8 14" xmlns="http://www.w3.org/2000/svg"><path d="M6.463 7 .987 1.66a.61.61 0 0 1 0-.878.648.648 0 0 1 .9 0L7.813 6.56a.61.61 0 0 1 0 .878l-5.926 5.78a.648.648 0 0 1-.9 0 .61.61 0 0 1 0-.879L6.463 7Z"></path></svg></div></label><div class="CodeSyntaxSelector_body__hBJ7j" tabindex="0"><div class="CodeBlock_codeBlock__KlURa"><pre tabindex="0" style="color:#36383b;font-family:ProximaNova, monospace;line-height:1.2;font-size:1rem"><code class="language-json" style="white-space:pre"><span class="token token punctuation">{</span><span> </span><span> </span><span class="token token property">"unit"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"units"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"integer"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"facet"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"unit_reference"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"metrics"</span><span class="token token operator">:</span><span> </span><span class="token token punctuation">[</span><span> </span><span> </span><span class="token token punctuation">{</span><span> </span><span> </span><span class="token token property">"key"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"value"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"integer"</span><span> </span><span> </span><span class="token token punctuation">}</span><span> </span><span> </span><span class="token token punctuation">]</span><span> </span><span></span><span class="token token punctuation">}</span></code></pre></div></div></div></div></div><div class="MethodDetail_methodContainer__3EF7h" id="getGroupMetricsByCountries"><div class="MethodDetail_method__fyEiw"><div><h3 class="MethodHeader_h3__seOfC">Get Click Metrics for a Group by Country</h3><h4 class="MethodHeader_description__3_p_p"><div class="MethodHeader_iconStyle__x5Ow4"><svg viewbox="0 0 14 6" xmlns="http://www.w3.org/2000/svg" class="IconRest_restIcon__3pju8 get"><title>Get</title><path d="M2.587 6c.307 0 .607-.044.9-.132.295-.088.533-.217.716-.387V2.876H2.271v.825h1.027v1.145a.772.772 0 0 1-.239.1 1.4 1.4 0 0 1-.383.049 1.338 1.338 0 0 1-1.083-.52c-.135-.17-.24-.379-.316-.626a2.879 2.879 0 0 1-.113-.84c0-.352.038-.655.113-.907.076-.253.182-.46.32-.623.137-.162.3-.281.488-.358a1.783 1.783 0 0 1 .97-.082l.13.032v.915h.889V.28a3.182 3.182 0 0 0-.59-.202A3.507 3.507 0 0 0 2.676 0c-.313 0-.628.055-.946.165a2.4 2.4 0 0 0-.861.523 2.707 2.707 0 0 0-.627.92C.081 1.98 0 2.433 0 2.966c0 .506.067.946.202 1.323.135.376.318.692.55.948a2.2 2.2 0 0 0 .82.572A2.7 2.7 0 0 0 2.587 6Zm6.24-.115V4.879H6.184V3.47h2.4V2.465h-2.4V1.121h2.602V.115h-3.71v5.77h3.75Zm4.43 0v-.907h-.914V1.022h.768v.997H14V.115H9.57V2.02h.89v-.997h.776v3.956h-.922v.907h2.942Z"></path></svg></div> /v4/groups/{group_guid}/countries</h4><p class="MethodHeader_description__3_p_p">Returns the geographic origins of click traffic by country for the specified group.</p></div><div><h4 class="ParameterList_h4__nH9G8 ParameterList_dividing__wRGRx">Path Parameters</h4><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">group_guid</span><span class="Parameter_type__djM_s">string</span><span class="Parameter_required__pcK_H">Required</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">A GUID for a Bitly group</div></div></div><div><h4 class="ParameterList_h4__nH9G8 ParameterList_dividing__wRGRx">Query Parameters</h4><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">unit</span><span class="Parameter_type__djM_s">string</span><span class="Parameter_required__pcK_H">Required</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">A unit of time</div><div class="Parameter_default__HHgG0 Parameter_spacer__JKXbH">Default: <span class="Parameter_label__DUY7G">"day"</span></div><div class="Parameter_enum__csO6P Parameter_spacer__JKXbH">Enum: <span class="Parameter_label__DUY7G">"minute"</span><span class="Parameter_label__DUY7G">"hour"</span><span class="Parameter_label__DUY7G">"day"</span><span class="Parameter_label__DUY7G">"week"</span><span class="Parameter_label__DUY7G">"month"</span></div></div><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">units</span><span class="Parameter_type__djM_s">integer</span><span class="Parameter_required__pcK_H">Required</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">An integer representing the time units to query data for. pass -1 to return all units of time.</div><div class="Parameter_default__HHgG0 Parameter_spacer__JKXbH">Default: <span class="Parameter_label__DUY7G">-1</span></div></div><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">size</span><span class="Parameter_type__djM_s">integer</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">The quantity of items to be be returned</div><div class="Parameter_default__HHgG0 Parameter_spacer__JKXbH">Default: <span class="Parameter_label__DUY7G">50</span></div></div><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">unit_reference</span><span class="Parameter_type__djM_s">string</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">An ISO-8601 timestamp, indicating the most recent time for which to pull metrics. Will default to current time. Timestamp values should be url encoded (i.e. replace '+' with '%2B' and ':' with '%3A'; 2022-02-02T15:53:02+0000 becomes 2022-02-02T15%3A53%3A02%2B0000)</div></div></div></div><div class="MethodDetail_examples__8nXeM"><div><label class="CodeSyntaxSelector_header__6P_Jc CodeSyntaxSelector_headerDark__hI3A0"><span>Request</span><div class="Select_wrapper__58utF Select_dark__KPIws"><select class="Select_select__qXz_Z Select_dark__KPIws" aria-label="Select" autocomplete="off"><option value="cURL" selected="">cURL</option><option value="Node">Node</option><option value="Browser">Browser</option><option value="Go">Go</option><option value="Python">Python</option></select><svg viewbox="0 0 8 14" xmlns="http://www.w3.org/2000/svg"><path d="M6.463 7 .987 1.66a.61.61 0 0 1 0-.878.648.648 0 0 1 .9 0L7.813 6.56a.61.61 0 0 1 0 .878l-5.926 5.78a.648.648 0 0 1-.9 0 .61.61 0 0 1 0-.879L6.463 7Z"></path></svg></div></label><div class="CodeSyntaxSelector_body__hBJ7j CodeSyntaxSelector_bodyDark__cizVw" tabindex="0"><div class="CodeBlock_codeBlock__KlURa"><pre tabindex="0" style="color:#ffffff;font-family:ProximaNova, monospace;line-height:1.2;font-size:1rem"><code class="language-bash" style="white-space:pre"><span class="token token" style="color:#ee6123">curl</span><span> </span><span class="token token punctuation">\</span><span> </span><span>-H </span><span class="token token" style="color:#acda95">'Authorization: Bearer {TOKEN}'</span><span> </span><span class="token token punctuation">\</span><span> </span><span>-X GET </span><span class="token token punctuation">\</span><span> </span><span>https://api-ssl.bitly.com/v4/groups/Ba1bc23dE4F/countries?unit</span><span class="token token operator">=</span><span>month</span><span class="token token operator">&</span><span class="token token assign-left variable">units</span><span class="token token operator">=</span><span class="token token" style="color:#a1b8f3">5</span><span class="token token operator">&</span><span class="token token assign-left variable">size</span><span class="token token operator">=</span><span class="token token" style="color:#a1b8f3">10</span><span class="token token operator">&</span><span class="token token assign-left variable">unit_reference</span><span class="token token operator">=</span><span class="token token" style="color:#a1b8f3">2006</span><span>-01-02T15%3A04%3A05-0700</span></code></pre></div></div></div><div><label class="CodeSyntaxSelector_header__6P_Jc"><span>Response</span><div class="Select_wrapper__58utF"><select class="Select_select__qXz_Z" aria-label="Select" autocomplete="off"><option value="200" selected="">200 SUCCESS</option><option value="403">403 FORBIDDEN</option><option value="404">404 NOT_FOUND</option><option value="500">500 INTERNAL_ERROR</option><option value="503">503 TEMPORARILY_UNAVAILABLE</option></select><svg viewbox="0 0 8 14" xmlns="http://www.w3.org/2000/svg"><path d="M6.463 7 .987 1.66a.61.61 0 0 1 0-.878.648.648 0 0 1 .9 0L7.813 6.56a.61.61 0 0 1 0 .878l-5.926 5.78a.648.648 0 0 1-.9 0 .61.61 0 0 1 0-.879L6.463 7Z"></path></svg></div></label><div class="CodeSyntaxSelector_body__hBJ7j" tabindex="0"><div class="Response_formatSelect__Wt_qa"><div class="ButtonToggle_buttonToggle__6YJhd"><label class="ButtonToggle_label__ohGaG"><input class="ButtonToggle_input__vkfUm" name="getGroupMetricsByCountries" type="radio" checked=""/><span>json</span></label><label class="ButtonToggle_label__ohGaG"><input class="ButtonToggle_input__vkfUm" name="getGroupMetricsByCountries" type="radio"/><span>csv</span></label></div></div><div class="CodeBlock_codeBlock__KlURa"><pre tabindex="0" style="color:#36383b;font-family:ProximaNova, monospace;line-height:1.2;font-size:1rem"><code class="language-json" style="white-space:pre"><span class="token token punctuation">{</span><span> </span><span> </span><span class="token token property">"unit"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"units"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"integer"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"facet"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"unit_reference"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"metrics"</span><span class="token token operator">:</span><span> </span><span class="token token punctuation">[</span><span> </span><span> </span><span class="token token punctuation">{</span><span> </span><span> </span><span class="token token property">"clicks"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"integer"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"value"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span> </span><span> </span><span class="token token punctuation">}</span><span> </span><span> </span><span class="token token punctuation">]</span><span> </span><span></span><span class="token token punctuation">}</span></code></pre></div></div></div></div></div><div class="MethodDetail_methodContainer__3EF7h" id="getGroupMetricsByCities"><div class="MethodDetail_method__fyEiw"><div><h3 class="MethodHeader_h3__seOfC">Get Click Metrics for a Group by City</h3><h4 class="MethodHeader_description__3_p_p"><div class="MethodHeader_iconStyle__x5Ow4"><svg viewbox="0 0 14 6" xmlns="http://www.w3.org/2000/svg" class="IconRest_restIcon__3pju8 get"><title>Get</title><path d="M2.587 6c.307 0 .607-.044.9-.132.295-.088.533-.217.716-.387V2.876H2.271v.825h1.027v1.145a.772.772 0 0 1-.239.1 1.4 1.4 0 0 1-.383.049 1.338 1.338 0 0 1-1.083-.52c-.135-.17-.24-.379-.316-.626a2.879 2.879 0 0 1-.113-.84c0-.352.038-.655.113-.907.076-.253.182-.46.32-.623.137-.162.3-.281.488-.358a1.783 1.783 0 0 1 .97-.082l.13.032v.915h.889V.28a3.182 3.182 0 0 0-.59-.202A3.507 3.507 0 0 0 2.676 0c-.313 0-.628.055-.946.165a2.4 2.4 0 0 0-.861.523 2.707 2.707 0 0 0-.627.92C.081 1.98 0 2.433 0 2.966c0 .506.067.946.202 1.323.135.376.318.692.55.948a2.2 2.2 0 0 0 .82.572A2.7 2.7 0 0 0 2.587 6Zm6.24-.115V4.879H6.184V3.47h2.4V2.465h-2.4V1.121h2.602V.115h-3.71v5.77h3.75Zm4.43 0v-.907h-.914V1.022h.768v.997H14V.115H9.57V2.02h.89v-.997h.776v3.956h-.922v.907h2.942Z"></path></svg></div> /v4/groups/{group_guid}/cities</h4><p class="MethodHeader_description__3_p_p">Returns the geographic origins of click traffic by city for the specified group.</p></div><div><h4 class="ParameterList_h4__nH9G8 ParameterList_dividing__wRGRx">Path Parameters</h4><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">group_guid</span><span class="Parameter_type__djM_s">string</span><span class="Parameter_required__pcK_H">Required</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">A GUID for a Bitly group</div></div></div><div><h4 class="ParameterList_h4__nH9G8 ParameterList_dividing__wRGRx">Query Parameters</h4><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">unit</span><span class="Parameter_type__djM_s">string</span><span class="Parameter_required__pcK_H">Required</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">A unit of time</div><div class="Parameter_default__HHgG0 Parameter_spacer__JKXbH">Default: <span class="Parameter_label__DUY7G">"day"</span></div><div class="Parameter_enum__csO6P Parameter_spacer__JKXbH">Enum: <span class="Parameter_label__DUY7G">"minute"</span><span class="Parameter_label__DUY7G">"hour"</span><span class="Parameter_label__DUY7G">"day"</span><span class="Parameter_label__DUY7G">"week"</span><span class="Parameter_label__DUY7G">"month"</span></div></div><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">units</span><span class="Parameter_type__djM_s">integer</span><span class="Parameter_required__pcK_H">Required</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">An integer representing the time units to query data for. pass -1 to return all units of time.</div><div class="Parameter_default__HHgG0 Parameter_spacer__JKXbH">Default: <span class="Parameter_label__DUY7G">-1</span></div></div><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">size</span><span class="Parameter_type__djM_s">integer</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">The quantity of items to be be returned</div><div class="Parameter_default__HHgG0 Parameter_spacer__JKXbH">Default: <span class="Parameter_label__DUY7G">50</span></div></div><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">unit_reference</span><span class="Parameter_type__djM_s">string</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">An ISO-8601 timestamp, indicating the most recent time for which to pull metrics. Will default to current time. Timestamp values should be url encoded (i.e. replace '+' with '%2B' and ':' with '%3A'; 2022-02-02T15:53:02+0000 becomes 2022-02-02T15%3A53%3A02%2B0000)</div></div></div></div><div class="MethodDetail_examples__8nXeM"><div><label class="CodeSyntaxSelector_header__6P_Jc CodeSyntaxSelector_headerDark__hI3A0"><span>Request</span><div class="Select_wrapper__58utF Select_dark__KPIws"><select class="Select_select__qXz_Z Select_dark__KPIws" aria-label="Select" autocomplete="off"><option value="cURL" selected="">cURL</option><option value="Node">Node</option><option value="Browser">Browser</option><option value="Go">Go</option><option value="Python">Python</option></select><svg viewbox="0 0 8 14" xmlns="http://www.w3.org/2000/svg"><path d="M6.463 7 .987 1.66a.61.61 0 0 1 0-.878.648.648 0 0 1 .9 0L7.813 6.56a.61.61 0 0 1 0 .878l-5.926 5.78a.648.648 0 0 1-.9 0 .61.61 0 0 1 0-.879L6.463 7Z"></path></svg></div></label><div class="CodeSyntaxSelector_body__hBJ7j CodeSyntaxSelector_bodyDark__cizVw" tabindex="0"><div class="CodeBlock_codeBlock__KlURa"><pre tabindex="0" style="color:#ffffff;font-family:ProximaNova, monospace;line-height:1.2;font-size:1rem"><code class="language-bash" style="white-space:pre"><span class="token token" style="color:#ee6123">curl</span><span> </span><span class="token token punctuation">\</span><span> </span><span>-H </span><span class="token token" style="color:#acda95">'Authorization: Bearer {TOKEN}'</span><span> </span><span class="token token punctuation">\</span><span> </span><span>-X GET </span><span class="token token punctuation">\</span><span> </span><span>https://api-ssl.bitly.com/v4/groups/Ba1bc23dE4F/cities?unit</span><span class="token token operator">=</span><span>month</span><span class="token token operator">&</span><span class="token token assign-left variable">units</span><span class="token token operator">=</span><span class="token token" style="color:#a1b8f3">5</span><span class="token token operator">&</span><span class="token token assign-left variable">size</span><span class="token token operator">=</span><span class="token token" style="color:#a1b8f3">10</span><span class="token token operator">&</span><span class="token token assign-left variable">unit_reference</span><span class="token token operator">=</span><span class="token token" style="color:#a1b8f3">2006</span><span>-01-02T15%3A04%3A05-0700</span></code></pre></div></div></div><div><label class="CodeSyntaxSelector_header__6P_Jc"><span>Response</span><div class="Select_wrapper__58utF"><select class="Select_select__qXz_Z" aria-label="Select" autocomplete="off"><option value="200" selected="">200 SUCCESS</option><option value="402">402 UPGRADE_REQUIRED</option><option value="403">403 FORBIDDEN</option><option value="404">404 NOT_FOUND</option><option value="500">500 INTERNAL_ERROR</option><option value="503">503 TEMPORARILY_UNAVAILABLE</option></select><svg viewbox="0 0 8 14" xmlns="http://www.w3.org/2000/svg"><path d="M6.463 7 .987 1.66a.61.61 0 0 1 0-.878.648.648 0 0 1 .9 0L7.813 6.56a.61.61 0 0 1 0 .878l-5.926 5.78a.648.648 0 0 1-.9 0 .61.61 0 0 1 0-.879L6.463 7Z"></path></svg></div></label><div class="CodeSyntaxSelector_body__hBJ7j" tabindex="0"><div class="Response_formatSelect__Wt_qa"><div class="ButtonToggle_buttonToggle__6YJhd"><label class="ButtonToggle_label__ohGaG"><input class="ButtonToggle_input__vkfUm" name="getGroupMetricsByCities" type="radio" checked=""/><span>json</span></label><label class="ButtonToggle_label__ohGaG"><input class="ButtonToggle_input__vkfUm" name="getGroupMetricsByCities" type="radio"/><span>csv</span></label></div></div><div class="CodeBlock_codeBlock__KlURa"><pre tabindex="0" style="color:#36383b;font-family:ProximaNova, monospace;line-height:1.2;font-size:1rem"><code class="language-json" style="white-space:pre"><span class="token token punctuation">{</span><span> </span><span> </span><span class="token token property">"unit"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"units"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"integer"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"facet"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"unit_reference"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"metrics"</span><span class="token token operator">:</span><span> </span><span class="token token punctuation">[</span><span> </span><span> </span><span class="token token punctuation">{</span><span> </span><span> </span><span class="token token property">"clicks"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"integer"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"city"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"subregion"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"region"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"country"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span> </span><span> </span><span class="token token punctuation">}</span><span> </span><span> </span><span class="token token punctuation">]</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"other_metrics"</span><span class="token token operator">:</span><span> </span><span class="token token punctuation">{</span><span> </span><span> </span><span class="token token property">"other_city_clicks"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"integer"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"no_city_clicks"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"integer"</span><span> </span><span> </span><span class="token token punctuation">}</span><span> </span><span></span><span class="token token punctuation">}</span></code></pre></div></div></div></div></div><div class="MethodDetail_methodContainer__3EF7h" id="getGroupMetricsByDevices"><div class="MethodDetail_method__fyEiw"><div><h3 class="MethodHeader_h3__seOfC">Get Click Metrics for a Group by Device Type</h3><h4 class="MethodHeader_description__3_p_p"><div class="MethodHeader_iconStyle__x5Ow4"><svg viewbox="0 0 14 6" xmlns="http://www.w3.org/2000/svg" class="IconRest_restIcon__3pju8 get"><title>Get</title><path d="M2.587 6c.307 0 .607-.044.9-.132.295-.088.533-.217.716-.387V2.876H2.271v.825h1.027v1.145a.772.772 0 0 1-.239.1 1.4 1.4 0 0 1-.383.049 1.338 1.338 0 0 1-1.083-.52c-.135-.17-.24-.379-.316-.626a2.879 2.879 0 0 1-.113-.84c0-.352.038-.655.113-.907.076-.253.182-.46.32-.623.137-.162.3-.281.488-.358a1.783 1.783 0 0 1 .97-.082l.13.032v.915h.889V.28a3.182 3.182 0 0 0-.59-.202A3.507 3.507 0 0 0 2.676 0c-.313 0-.628.055-.946.165a2.4 2.4 0 0 0-.861.523 2.707 2.707 0 0 0-.627.92C.081 1.98 0 2.433 0 2.966c0 .506.067.946.202 1.323.135.376.318.692.55.948a2.2 2.2 0 0 0 .82.572A2.7 2.7 0 0 0 2.587 6Zm6.24-.115V4.879H6.184V3.47h2.4V2.465h-2.4V1.121h2.602V.115h-3.71v5.77h3.75Zm4.43 0v-.907h-.914V1.022h.768v.997H14V.115H9.57V2.02h.89v-.997h.776v3.956h-.922v.907h2.942Z"></path></svg></div> /v4/groups/{group_guid}/devices</h4><p class="MethodHeader_description__3_p_p">Returns the device types generating click traffic to the specified group's links.</p></div><div><h4 class="ParameterList_h4__nH9G8 ParameterList_dividing__wRGRx">Path Parameters</h4><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">group_guid</span><span class="Parameter_type__djM_s">string</span><span class="Parameter_required__pcK_H">Required</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">A GUID for a Bitly group</div></div></div><div><h4 class="ParameterList_h4__nH9G8 ParameterList_dividing__wRGRx">Query Parameters</h4><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">unit</span><span class="Parameter_type__djM_s">string</span><span class="Parameter_required__pcK_H">Required</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">A unit of time</div><div class="Parameter_default__HHgG0 Parameter_spacer__JKXbH">Default: <span class="Parameter_label__DUY7G">"day"</span></div><div class="Parameter_enum__csO6P Parameter_spacer__JKXbH">Enum: <span class="Parameter_label__DUY7G">"minute"</span><span class="Parameter_label__DUY7G">"hour"</span><span class="Parameter_label__DUY7G">"day"</span><span class="Parameter_label__DUY7G">"week"</span><span class="Parameter_label__DUY7G">"month"</span></div></div><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">units</span><span class="Parameter_type__djM_s">integer</span><span class="Parameter_required__pcK_H">Required</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">An integer representing the time units to query data for. pass -1 to return all units of time.</div><div class="Parameter_default__HHgG0 Parameter_spacer__JKXbH">Default: <span class="Parameter_label__DUY7G">-1</span></div></div><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">size</span><span class="Parameter_type__djM_s">integer</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">The quantity of items to be be returned</div><div class="Parameter_default__HHgG0 Parameter_spacer__JKXbH">Default: <span class="Parameter_label__DUY7G">50</span></div></div><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">unit_reference</span><span class="Parameter_type__djM_s">string</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">An ISO-8601 timestamp, indicating the most recent time for which to pull metrics. Will default to current time. Timestamp values should be url encoded (i.e. replace '+' with '%2B' and ':' with '%3A'; 2022-02-02T15:53:02+0000 becomes 2022-02-02T15%3A53%3A02%2B0000)</div></div></div></div><div class="MethodDetail_examples__8nXeM"><div><label class="CodeSyntaxSelector_header__6P_Jc CodeSyntaxSelector_headerDark__hI3A0"><span>Request</span><div class="Select_wrapper__58utF Select_dark__KPIws"><select class="Select_select__qXz_Z Select_dark__KPIws" aria-label="Select" autocomplete="off"><option value="cURL" selected="">cURL</option><option value="Node">Node</option><option value="Browser">Browser</option><option value="Go">Go</option><option value="Python">Python</option></select><svg viewbox="0 0 8 14" xmlns="http://www.w3.org/2000/svg"><path d="M6.463 7 .987 1.66a.61.61 0 0 1 0-.878.648.648 0 0 1 .9 0L7.813 6.56a.61.61 0 0 1 0 .878l-5.926 5.78a.648.648 0 0 1-.9 0 .61.61 0 0 1 0-.879L6.463 7Z"></path></svg></div></label><div class="CodeSyntaxSelector_body__hBJ7j CodeSyntaxSelector_bodyDark__cizVw" tabindex="0"><div class="CodeBlock_codeBlock__KlURa"><pre tabindex="0" style="color:#ffffff;font-family:ProximaNova, monospace;line-height:1.2;font-size:1rem"><code class="language-bash" style="white-space:pre"><span class="token token" style="color:#ee6123">curl</span><span> </span><span class="token token punctuation">\</span><span> </span><span>-H </span><span class="token token" style="color:#acda95">'Authorization: Bearer {TOKEN}'</span><span> </span><span class="token token punctuation">\</span><span> </span><span>-X GET </span><span class="token token punctuation">\</span><span> </span><span>https://api-ssl.bitly.com/v4/groups/Ba1bc23dE4F/devices?unit</span><span class="token token operator">=</span><span>month</span><span class="token token operator">&</span><span class="token token assign-left variable">units</span><span class="token token operator">=</span><span class="token token" style="color:#a1b8f3">5</span><span class="token token operator">&</span><span class="token token assign-left variable">size</span><span class="token token operator">=</span><span class="token token" style="color:#a1b8f3">10</span><span class="token token operator">&</span><span class="token token assign-left variable">unit_reference</span><span class="token token operator">=</span><span class="token token" style="color:#a1b8f3">2006</span><span>-01-02T15%3A04%3A05-0700</span></code></pre></div></div></div><div><label class="CodeSyntaxSelector_header__6P_Jc"><span>Response</span><div class="Select_wrapper__58utF"><select class="Select_select__qXz_Z" aria-label="Select" autocomplete="off"><option value="200" selected="">200 SUCCESS</option><option value="402">402 UPGRADE_REQUIRED</option><option value="403">403 FORBIDDEN</option><option value="404">404 NOT_FOUND</option><option value="500">500 INTERNAL_ERROR</option><option value="503">503 TEMPORARILY_UNAVAILABLE</option></select><svg viewbox="0 0 8 14" xmlns="http://www.w3.org/2000/svg"><path d="M6.463 7 .987 1.66a.61.61 0 0 1 0-.878.648.648 0 0 1 .9 0L7.813 6.56a.61.61 0 0 1 0 .878l-5.926 5.78a.648.648 0 0 1-.9 0 .61.61 0 0 1 0-.879L6.463 7Z"></path></svg></div></label><div class="CodeSyntaxSelector_body__hBJ7j" tabindex="0"><div class="Response_formatSelect__Wt_qa"><div class="ButtonToggle_buttonToggle__6YJhd"><label class="ButtonToggle_label__ohGaG"><input class="ButtonToggle_input__vkfUm" name="getGroupMetricsByDevices" type="radio" checked=""/><span>json</span></label><label class="ButtonToggle_label__ohGaG"><input class="ButtonToggle_input__vkfUm" name="getGroupMetricsByDevices" type="radio"/><span>csv</span></label></div></div><div class="CodeBlock_codeBlock__KlURa"><pre tabindex="0" style="color:#36383b;font-family:ProximaNova, monospace;line-height:1.2;font-size:1rem"><code class="language-json" style="white-space:pre"><span class="token token punctuation">{</span><span> </span><span> </span><span class="token token property">"unit"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"units"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"integer"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"facet"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"unit_reference"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"metrics"</span><span class="token token operator">:</span><span> </span><span class="token token punctuation">[</span><span> </span><span> </span><span class="token token punctuation">{</span><span> </span><span> </span><span class="token token property">"clicks"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"integer"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"device_type"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span> </span><span> </span><span class="token token punctuation">}</span><span> </span><span> </span><span class="token token punctuation">]</span><span> </span><span></span><span class="token token punctuation">}</span></code></pre></div></div></div></div></div><div class="MethodDetail_methodContainer__3EF7h" id="GetGroupMetricsByReferringNetworks"><div class="MethodDetail_method__fyEiw"><div><h3 class="MethodHeader_h3__seOfC">Get Click Metrics for a Group by Referring Networks</h3><h4 class="MethodHeader_description__3_p_p"><div class="MethodHeader_iconStyle__x5Ow4"><svg viewbox="0 0 14 6" xmlns="http://www.w3.org/2000/svg" class="IconRest_restIcon__3pju8 get"><title>Get</title><path d="M2.587 6c.307 0 .607-.044.9-.132.295-.088.533-.217.716-.387V2.876H2.271v.825h1.027v1.145a.772.772 0 0 1-.239.1 1.4 1.4 0 0 1-.383.049 1.338 1.338 0 0 1-1.083-.52c-.135-.17-.24-.379-.316-.626a2.879 2.879 0 0 1-.113-.84c0-.352.038-.655.113-.907.076-.253.182-.46.32-.623.137-.162.3-.281.488-.358a1.783 1.783 0 0 1 .97-.082l.13.032v.915h.889V.28a3.182 3.182 0 0 0-.59-.202A3.507 3.507 0 0 0 2.676 0c-.313 0-.628.055-.946.165a2.4 2.4 0 0 0-.861.523 2.707 2.707 0 0 0-.627.92C.081 1.98 0 2.433 0 2.966c0 .506.067.946.202 1.323.135.376.318.692.55.948a2.2 2.2 0 0 0 .82.572A2.7 2.7 0 0 0 2.587 6Zm6.24-.115V4.879H6.184V3.47h2.4V2.465h-2.4V1.121h2.602V.115h-3.71v5.77h3.75Zm4.43 0v-.907h-.914V1.022h.768v.997H14V.115H9.57V2.02h.89v-.997h.776v3.956h-.922v.907h2.942Z"></path></svg></div> /v4/groups/{group_guid}/referring_networks</h4><p class="MethodHeader_description__3_p_p">Returns metrics by referring networks for the specified group's links.</p></div><div><h4 class="ParameterList_h4__nH9G8 ParameterList_dividing__wRGRx">Path Parameters</h4><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">group_guid</span><span class="Parameter_type__djM_s">string</span><span class="Parameter_required__pcK_H">Required</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">A GUID for a Bitly group</div></div></div></div><div class="MethodDetail_examples__8nXeM"><div><label class="CodeSyntaxSelector_header__6P_Jc CodeSyntaxSelector_headerDark__hI3A0"><span>Request</span><div class="Select_wrapper__58utF Select_dark__KPIws"><select class="Select_select__qXz_Z Select_dark__KPIws" aria-label="Select" autocomplete="off"><option value="cURL" selected="">cURL</option><option value="Node">Node</option><option value="Browser">Browser</option><option value="Go">Go</option><option value="Python">Python</option></select><svg viewbox="0 0 8 14" xmlns="http://www.w3.org/2000/svg"><path d="M6.463 7 .987 1.66a.61.61 0 0 1 0-.878.648.648 0 0 1 .9 0L7.813 6.56a.61.61 0 0 1 0 .878l-5.926 5.78a.648.648 0 0 1-.9 0 .61.61 0 0 1 0-.879L6.463 7Z"></path></svg></div></label><div class="CodeSyntaxSelector_body__hBJ7j CodeSyntaxSelector_bodyDark__cizVw" tabindex="0"><div class="CodeBlock_codeBlock__KlURa"><pre tabindex="0" style="color:#ffffff;font-family:ProximaNova, monospace;line-height:1.2;font-size:1rem"><code class="language-bash" style="white-space:pre"><span class="token token" style="color:#ee6123">curl</span><span> </span><span class="token token punctuation">\</span><span> </span><span>-H </span><span class="token token" style="color:#acda95">'Authorization: Bearer {TOKEN}'</span><span> </span><span class="token token punctuation">\</span><span> </span><span>-X GET </span><span class="token token punctuation">\</span><span> </span>https://api-ssl.bitly.com/v4/groups/Ba1bc23dE4F/referring_networks</code></pre></div></div></div><div><label class="CodeSyntaxSelector_header__6P_Jc"><span>Response</span><div class="Select_wrapper__58utF"><select class="Select_select__qXz_Z" aria-label="Select" autocomplete="off"><option value="200" selected="">200 SUCCESS</option><option value="403">403 FORBIDDEN</option><option value="404">404 NOT_FOUND</option><option value="500">500 INTERNAL_ERROR</option><option value="503">503 TEMPORARILY_UNAVAILABLE</option></select><svg viewbox="0 0 8 14" xmlns="http://www.w3.org/2000/svg"><path d="M6.463 7 .987 1.66a.61.61 0 0 1 0-.878.648.648 0 0 1 .9 0L7.813 6.56a.61.61 0 0 1 0 .878l-5.926 5.78a.648.648 0 0 1-.9 0 .61.61 0 0 1 0-.879L6.463 7Z"></path></svg></div></label><div class="CodeSyntaxSelector_body__hBJ7j" tabindex="0"><div class="CodeBlock_codeBlock__KlURa"><pre tabindex="0" style="color:#36383b;font-family:ProximaNova, monospace;line-height:1.2;font-size:1rem"><code class="language-json" style="white-space:pre"><span class="token token punctuation">{</span><span> </span><span> </span><span class="token token property">"unit"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"units"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"integer"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"facet"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"unit_reference"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"metrics"</span><span class="token token operator">:</span><span> </span><span class="token token punctuation">[</span><span> </span><span> </span><span class="token token punctuation">{</span><span> </span><span> </span><span class="token token property">"clicks"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"integer"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"value"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span> </span><span> </span><span class="token token punctuation">}</span><span> </span><span> </span><span class="token token punctuation">]</span><span> </span><span></span><span class="token token punctuation">}</span></code></pre></div></div></div></div></div><div class="MethodDetail_methodContainer__3EF7h" id="getGroupClicks"><div class="MethodDetail_method__fyEiw"><div><h3 class="MethodHeader_h3__seOfC">Get clicks by group</h3><h4 class="MethodHeader_description__3_p_p"><div class="MethodHeader_iconStyle__x5Ow4"><svg viewbox="0 0 14 6" xmlns="http://www.w3.org/2000/svg" class="IconRest_restIcon__3pju8 get"><title>Get</title><path d="M2.587 6c.307 0 .607-.044.9-.132.295-.088.533-.217.716-.387V2.876H2.271v.825h1.027v1.145a.772.772 0 0 1-.239.1 1.4 1.4 0 0 1-.383.049 1.338 1.338 0 0 1-1.083-.52c-.135-.17-.24-.379-.316-.626a2.879 2.879 0 0 1-.113-.84c0-.352.038-.655.113-.907.076-.253.182-.46.32-.623.137-.162.3-.281.488-.358a1.783 1.783 0 0 1 .97-.082l.13.032v.915h.889V.28a3.182 3.182 0 0 0-.59-.202A3.507 3.507 0 0 0 2.676 0c-.313 0-.628.055-.946.165a2.4 2.4 0 0 0-.861.523 2.707 2.707 0 0 0-.627.92C.081 1.98 0 2.433 0 2.966c0 .506.067.946.202 1.323.135.376.318.692.55.948a2.2 2.2 0 0 0 .82.572A2.7 2.7 0 0 0 2.587 6Zm6.24-.115V4.879H6.184V3.47h2.4V2.465h-2.4V1.121h2.602V.115h-3.71v5.77h3.75Zm4.43 0v-.907h-.914V1.022h.768v.997H14V.115H9.57V2.02h.89v-.997h.776v3.956h-.922v.907h2.942Z"></path></svg></div> /v4/groups/{group_guid}/clicks</h4><p class="MethodHeader_description__3_p_p">get number of clicks on bitlinks in a group</p></div><div><h4 class="ParameterList_h4__nH9G8 ParameterList_dividing__wRGRx">Path Parameters</h4><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">group_guid</span><span class="Parameter_type__djM_s">string</span><span class="Parameter_required__pcK_H">Required</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">A GUID for a Bitly group</div></div></div><div><h4 class="ParameterList_h4__nH9G8 ParameterList_dividing__wRGRx">Query Parameters</h4><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">unit</span><span class="Parameter_type__djM_s">string</span><span class="Parameter_required__pcK_H">Required</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">A unit of time</div><div class="Parameter_default__HHgG0 Parameter_spacer__JKXbH">Default: <span class="Parameter_label__DUY7G">"day"</span></div><div class="Parameter_enum__csO6P Parameter_spacer__JKXbH">Enum: <span class="Parameter_label__DUY7G">"minute"</span><span class="Parameter_label__DUY7G">"hour"</span><span class="Parameter_label__DUY7G">"day"</span><span class="Parameter_label__DUY7G">"week"</span><span class="Parameter_label__DUY7G">"month"</span></div></div><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">units</span><span class="Parameter_type__djM_s">integer</span><span class="Parameter_required__pcK_H">Required</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">An integer representing the time units to query data for. pass -1 to return all units of time.</div><div class="Parameter_default__HHgG0 Parameter_spacer__JKXbH">Default: <span class="Parameter_label__DUY7G">-1</span></div></div><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">unit_reference</span><span class="Parameter_type__djM_s">string</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">An ISO-8601 timestamp, indicating the most recent time for which to pull metrics. Will default to current time. Timestamp values should be url encoded (i.e. replace '+' with '%2B' and ':' with '%3A'; 2022-02-02T15:53:02+0000 becomes 2022-02-02T15%3A53%3A02%2B0000)</div></div></div></div><div class="MethodDetail_examples__8nXeM"><div><label class="CodeSyntaxSelector_header__6P_Jc CodeSyntaxSelector_headerDark__hI3A0"><span>Request</span><div class="Select_wrapper__58utF Select_dark__KPIws"><select class="Select_select__qXz_Z Select_dark__KPIws" aria-label="Select" autocomplete="off"><option value="cURL" selected="">cURL</option><option value="Node">Node</option><option value="Browser">Browser</option><option value="Go">Go</option><option value="Python">Python</option></select><svg viewbox="0 0 8 14" xmlns="http://www.w3.org/2000/svg"><path d="M6.463 7 .987 1.66a.61.61 0 0 1 0-.878.648.648 0 0 1 .9 0L7.813 6.56a.61.61 0 0 1 0 .878l-5.926 5.78a.648.648 0 0 1-.9 0 .61.61 0 0 1 0-.879L6.463 7Z"></path></svg></div></label><div class="CodeSyntaxSelector_body__hBJ7j CodeSyntaxSelector_bodyDark__cizVw" tabindex="0"><div class="CodeBlock_codeBlock__KlURa"><pre tabindex="0" style="color:#ffffff;font-family:ProximaNova, monospace;line-height:1.2;font-size:1rem"><code class="language-bash" style="white-space:pre"><span class="token token" style="color:#ee6123">curl</span><span> </span><span class="token token punctuation">\</span><span> </span><span>-H </span><span class="token token" style="color:#acda95">'Authorization: Bearer {TOKEN}'</span><span> </span><span class="token token punctuation">\</span><span> </span><span>-X GET </span><span class="token token punctuation">\</span><span> </span><span>https://api-ssl.bitly.com/v4/groups/Ba1bc23dE4F/clicks?unit</span><span class="token token operator">=</span><span>month</span><span class="token token operator">&</span><span class="token token assign-left variable">units</span><span class="token token operator">=</span><span class="token token" style="color:#a1b8f3">5</span><span class="token token operator">&</span><span class="token token assign-left variable">unit_reference</span><span class="token token operator">=</span><span class="token token" style="color:#a1b8f3">2006</span><span>-01-02T15%3A04%3A05-0700</span></code></pre></div></div></div><div><label class="CodeSyntaxSelector_header__6P_Jc"><span>Response</span><div class="Select_wrapper__58utF"><select class="Select_select__qXz_Z" aria-label="Select" autocomplete="off"><option value="200" selected="">200 SUCCESS</option><option value="400">400 BAD_REQUEST</option><option value="402">402 UPGRADE_REQUIRED</option><option value="403">403 FORBIDDEN</option><option value="500">500 INTERNAL_ERROR</option><option value="503">503 TEMPORARILY_UNAVAILABLE</option></select><svg viewbox="0 0 8 14" xmlns="http://www.w3.org/2000/svg"><path d="M6.463 7 .987 1.66a.61.61 0 0 1 0-.878.648.648 0 0 1 .9 0L7.813 6.56a.61.61 0 0 1 0 .878l-5.926 5.78a.648.648 0 0 1-.9 0 .61.61 0 0 1 0-.879L6.463 7Z"></path></svg></div></label><div class="CodeSyntaxSelector_body__hBJ7j" tabindex="0"><div class="CodeBlock_codeBlock__KlURa"><pre tabindex="0" style="color:#36383b;font-family:ProximaNova, monospace;line-height:1.2;font-size:1rem"><code class="language-json" style="white-space:pre"><span class="token token punctuation">{</span><span> </span><span> </span><span class="token token property">"unit"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"units"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"integer"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"unit_reference"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"data"</span><span class="token token operator">:</span><span> </span><span class="token token punctuation">[</span><span> </span><span> </span><span class="token token punctuation">{</span><span> </span><span> </span><span class="token token property">"ts"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"count"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"integer"</span><span> </span><span> </span><span class="token token punctuation">}</span><span> </span><span> </span><span class="token token punctuation">]</span><span> </span><span></span><span class="token token punctuation">}</span></code></pre></div></div></div></div></div><div class="ApiReference_tagInfo__YVbgw"><h2 class="ApiReference_tagName__IJx2p">Organizations</h2><p class="ApiReference_tagDescription__8c1GM">Organizations are equivalent to a Bitly account. Every plan limit, group, and user is tied to an organization. </p></div><div class="MethodDetail_methodContainer__3EF7h" id="getOrganizations"><div class="MethodDetail_method__fyEiw"><div><h3 class="MethodHeader_h3__seOfC">Retrieve Organizations</h3><h4 class="MethodHeader_description__3_p_p"><div class="MethodHeader_iconStyle__x5Ow4"><svg viewbox="0 0 14 6" xmlns="http://www.w3.org/2000/svg" class="IconRest_restIcon__3pju8 get"><title>Get</title><path d="M2.587 6c.307 0 .607-.044.9-.132.295-.088.533-.217.716-.387V2.876H2.271v.825h1.027v1.145a.772.772 0 0 1-.239.1 1.4 1.4 0 0 1-.383.049 1.338 1.338 0 0 1-1.083-.52c-.135-.17-.24-.379-.316-.626a2.879 2.879 0 0 1-.113-.84c0-.352.038-.655.113-.907.076-.253.182-.46.32-.623.137-.162.3-.281.488-.358a1.783 1.783 0 0 1 .97-.082l.13.032v.915h.889V.28a3.182 3.182 0 0 0-.59-.202A3.507 3.507 0 0 0 2.676 0c-.313 0-.628.055-.946.165a2.4 2.4 0 0 0-.861.523 2.707 2.707 0 0 0-.627.92C.081 1.98 0 2.433 0 2.966c0 .506.067.946.202 1.323.135.376.318.692.55.948a2.2 2.2 0 0 0 .82.572A2.7 2.7 0 0 0 2.587 6Zm6.24-.115V4.879H6.184V3.47h2.4V2.465h-2.4V1.121h2.602V.115h-3.71v5.77h3.75Zm4.43 0v-.907h-.914V1.022h.768v.997H14V.115H9.57V2.02h.89v-.997h.776v3.956h-.922v.907h2.942Z"></path></svg></div> /v4/organizations</h4><p class="MethodHeader_description__3_p_p">Retrieve a list of organizations.</p></div></div><div class="MethodDetail_examples__8nXeM"><div><label class="CodeSyntaxSelector_header__6P_Jc CodeSyntaxSelector_headerDark__hI3A0"><span>Request</span><div class="Select_wrapper__58utF Select_dark__KPIws"><select class="Select_select__qXz_Z Select_dark__KPIws" aria-label="Select" autocomplete="off"><option value="cURL" selected="">cURL</option><option value="Node">Node</option><option value="Browser">Browser</option><option value="Go">Go</option><option value="Python">Python</option></select><svg viewbox="0 0 8 14" xmlns="http://www.w3.org/2000/svg"><path d="M6.463 7 .987 1.66a.61.61 0 0 1 0-.878.648.648 0 0 1 .9 0L7.813 6.56a.61.61 0 0 1 0 .878l-5.926 5.78a.648.648 0 0 1-.9 0 .61.61 0 0 1 0-.879L6.463 7Z"></path></svg></div></label><div class="CodeSyntaxSelector_body__hBJ7j CodeSyntaxSelector_bodyDark__cizVw" tabindex="0"><div class="CodeBlock_codeBlock__KlURa"><pre tabindex="0" style="color:#ffffff;font-family:ProximaNova, monospace;line-height:1.2;font-size:1rem"><code class="language-bash" style="white-space:pre"><span class="token token" style="color:#ee6123">curl</span><span> </span><span class="token token punctuation">\</span><span> </span><span>-H </span><span class="token token" style="color:#acda95">'Authorization: Bearer {TOKEN}'</span><span> </span><span class="token token punctuation">\</span><span> </span><span>-X GET </span><span class="token token punctuation">\</span><span> </span>https://api-ssl.bitly.com/v4/organizations</code></pre></div></div></div><div><label class="CodeSyntaxSelector_header__6P_Jc"><span>Response</span><div class="Select_wrapper__58utF"><select class="Select_select__qXz_Z" aria-label="Select" autocomplete="off"><option value="200" selected="">200 SUCCESS</option><option value="403">403 FORBIDDEN</option><option value="404">404 NOT_FOUND</option><option value="500">500 INTERNAL_ERROR</option><option value="503">503 TEMPORARILY_UNAVAILABLE</option></select><svg viewbox="0 0 8 14" xmlns="http://www.w3.org/2000/svg"><path d="M6.463 7 .987 1.66a.61.61 0 0 1 0-.878.648.648 0 0 1 .9 0L7.813 6.56a.61.61 0 0 1 0 .878l-5.926 5.78a.648.648 0 0 1-.9 0 .61.61 0 0 1 0-.879L6.463 7Z"></path></svg></div></label><div class="CodeSyntaxSelector_body__hBJ7j" tabindex="0"><div class="CodeBlock_codeBlock__KlURa"><pre tabindex="0" style="color:#36383b;font-family:ProximaNova, monospace;line-height:1.2;font-size:1rem"><code class="language-json" style="white-space:pre"><span class="token token punctuation">{</span><span> </span><span> </span><span class="token token property">"organizations"</span><span class="token token operator">:</span><span> </span><span class="token token punctuation">[</span><span> </span><span> </span><span class="token token punctuation">{</span><span> </span><span> </span><span class="token token property">"references"</span><span class="token token operator">:</span><span> </span><span class="token token punctuation">{</span><span> </span><span class="token token" style="color:#51763e">"any"</span><span> </span><span class="token token punctuation">}</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"name"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"is_active"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"boolean"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"guid"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"tier"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"tier_family"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"tier_display_name"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"role"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"created"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"modified"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"bsds"</span><span class="token token operator">:</span><span> </span><span class="token token punctuation">[</span><span> </span><span> </span><span class="token token" style="color:#51763e">"string"</span><span> </span><span> </span><span class="token token punctuation">]</span><span> </span><span> </span><span class="token token punctuation">}</span><span> </span><span> </span><span class="token token punctuation">]</span><span> </span><span></span><span class="token token punctuation">}</span></code></pre></div></div></div></div></div><div class="MethodDetail_methodContainer__3EF7h" id="getOrganization"><div class="MethodDetail_method__fyEiw"><div><h3 class="MethodHeader_h3__seOfC">Retrieve an Organization</h3><h4 class="MethodHeader_description__3_p_p"><div class="MethodHeader_iconStyle__x5Ow4"><svg viewbox="0 0 14 6" xmlns="http://www.w3.org/2000/svg" class="IconRest_restIcon__3pju8 get"><title>Get</title><path d="M2.587 6c.307 0 .607-.044.9-.132.295-.088.533-.217.716-.387V2.876H2.271v.825h1.027v1.145a.772.772 0 0 1-.239.1 1.4 1.4 0 0 1-.383.049 1.338 1.338 0 0 1-1.083-.52c-.135-.17-.24-.379-.316-.626a2.879 2.879 0 0 1-.113-.84c0-.352.038-.655.113-.907.076-.253.182-.46.32-.623.137-.162.3-.281.488-.358a1.783 1.783 0 0 1 .97-.082l.13.032v.915h.889V.28a3.182 3.182 0 0 0-.59-.202A3.507 3.507 0 0 0 2.676 0c-.313 0-.628.055-.946.165a2.4 2.4 0 0 0-.861.523 2.707 2.707 0 0 0-.627.92C.081 1.98 0 2.433 0 2.966c0 .506.067.946.202 1.323.135.376.318.692.55.948a2.2 2.2 0 0 0 .82.572A2.7 2.7 0 0 0 2.587 6Zm6.24-.115V4.879H6.184V3.47h2.4V2.465h-2.4V1.121h2.602V.115h-3.71v5.77h3.75Zm4.43 0v-.907h-.914V1.022h.768v.997H14V.115H9.57V2.02h.89v-.997h.776v3.956h-.922v.907h2.942Z"></path></svg></div> /v4/organizations/{organization_guid}</h4><p class="MethodHeader_description__3_p_p">Retrive details for the specified organization.</p></div><div><h4 class="ParameterList_h4__nH9G8 ParameterList_dividing__wRGRx">Path Parameters</h4><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">organization_guid</span><span class="Parameter_type__djM_s">string</span><span class="Parameter_required__pcK_H">Required</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">A GUID for a Bitly organization</div></div></div></div><div class="MethodDetail_examples__8nXeM"><div><label class="CodeSyntaxSelector_header__6P_Jc CodeSyntaxSelector_headerDark__hI3A0"><span>Request</span><div class="Select_wrapper__58utF Select_dark__KPIws"><select class="Select_select__qXz_Z Select_dark__KPIws" aria-label="Select" autocomplete="off"><option value="cURL" selected="">cURL</option><option value="Node">Node</option><option value="Browser">Browser</option><option value="Go">Go</option><option value="Python">Python</option></select><svg viewbox="0 0 8 14" xmlns="http://www.w3.org/2000/svg"><path d="M6.463 7 .987 1.66a.61.61 0 0 1 0-.878.648.648 0 0 1 .9 0L7.813 6.56a.61.61 0 0 1 0 .878l-5.926 5.78a.648.648 0 0 1-.9 0 .61.61 0 0 1 0-.879L6.463 7Z"></path></svg></div></label><div class="CodeSyntaxSelector_body__hBJ7j CodeSyntaxSelector_bodyDark__cizVw" tabindex="0"><div class="CodeBlock_codeBlock__KlURa"><pre tabindex="0" style="color:#ffffff;font-family:ProximaNova, monospace;line-height:1.2;font-size:1rem"><code class="language-bash" style="white-space:pre"><span class="token token" style="color:#ee6123">curl</span><span> </span><span class="token token punctuation">\</span><span> </span><span>-H </span><span class="token token" style="color:#acda95">'Authorization: Bearer {TOKEN}'</span><span> </span><span class="token token punctuation">\</span><span> </span><span>-X GET </span><span class="token token punctuation">\</span><span> </span>https://api-ssl.bitly.com/v4/organizations/Oa1bcd234eF</code></pre></div></div></div><div><label class="CodeSyntaxSelector_header__6P_Jc"><span>Response</span><div class="Select_wrapper__58utF"><select class="Select_select__qXz_Z" aria-label="Select" autocomplete="off"><option value="200" selected="">200 SUCCESS</option><option value="403">403 FORBIDDEN</option><option value="404">404 NOT_FOUND</option><option value="500">500 INTERNAL_ERROR</option><option value="503">503 TEMPORARILY_UNAVAILABLE</option></select><svg viewbox="0 0 8 14" xmlns="http://www.w3.org/2000/svg"><path d="M6.463 7 .987 1.66a.61.61 0 0 1 0-.878.648.648 0 0 1 .9 0L7.813 6.56a.61.61 0 0 1 0 .878l-5.926 5.78a.648.648 0 0 1-.9 0 .61.61 0 0 1 0-.879L6.463 7Z"></path></svg></div></label><div class="CodeSyntaxSelector_body__hBJ7j" tabindex="0"><div class="CodeBlock_codeBlock__KlURa"><pre tabindex="0" style="color:#36383b;font-family:ProximaNova, monospace;line-height:1.2;font-size:1rem"><code class="language-json" style="white-space:pre"><span class="token token punctuation">{</span><span> </span><span> </span><span class="token token property">"references"</span><span class="token token operator">:</span><span> </span><span class="token token punctuation">{</span><span> </span><span class="token token" style="color:#51763e">"any"</span><span> </span><span class="token token punctuation">}</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"name"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"is_active"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"boolean"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"guid"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"tier"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"tier_family"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"tier_display_name"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"role"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"created"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"modified"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"bsds"</span><span class="token token operator">:</span><span> </span><span class="token token punctuation">[</span><span> </span><span> </span><span class="token token" style="color:#51763e">"string"</span><span> </span><span> </span><span class="token token punctuation">]</span><span> </span><span></span><span class="token token punctuation">}</span></code></pre></div></div></div></div></div><div class="MethodDetail_methodContainer__3EF7h" id="getOrganizationShortenCounts"><div class="MethodDetail_method__fyEiw"><div><h3 class="MethodHeader_h3__seOfC">Get Shorten Counts for an Organization</h3><h4 class="MethodHeader_description__3_p_p"><div class="MethodHeader_iconStyle__x5Ow4"><svg viewbox="0 0 14 6" xmlns="http://www.w3.org/2000/svg" class="IconRest_restIcon__3pju8 get"><title>Get</title><path d="M2.587 6c.307 0 .607-.044.9-.132.295-.088.533-.217.716-.387V2.876H2.271v.825h1.027v1.145a.772.772 0 0 1-.239.1 1.4 1.4 0 0 1-.383.049 1.338 1.338 0 0 1-1.083-.52c-.135-.17-.24-.379-.316-.626a2.879 2.879 0 0 1-.113-.84c0-.352.038-.655.113-.907.076-.253.182-.46.32-.623.137-.162.3-.281.488-.358a1.783 1.783 0 0 1 .97-.082l.13.032v.915h.889V.28a3.182 3.182 0 0 0-.59-.202A3.507 3.507 0 0 0 2.676 0c-.313 0-.628.055-.946.165a2.4 2.4 0 0 0-.861.523 2.707 2.707 0 0 0-.627.92C.081 1.98 0 2.433 0 2.966c0 .506.067.946.202 1.323.135.376.318.692.55.948a2.2 2.2 0 0 0 .82.572A2.7 2.7 0 0 0 2.587 6Zm6.24-.115V4.879H6.184V3.47h2.4V2.465h-2.4V1.121h2.602V.115h-3.71v5.77h3.75Zm4.43 0v-.907h-.914V1.022h.768v.997H14V.115H9.57V2.02h.89v-.997h.776v3.956h-.922v.907h2.942Z"></path></svg></div> /v4/organizations/{organization_guid}/shorten_counts</h4><p class="MethodHeader_description__3_p_p">Returns the shorten counts for a specific organization over a specified time period.</p></div><div><h4 class="ParameterList_h4__nH9G8 ParameterList_dividing__wRGRx">Path Parameters</h4><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">organization_guid</span><span class="Parameter_type__djM_s">string</span><span class="Parameter_required__pcK_H">Required</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">A GUID for a Bitly organization</div></div></div><div><h4 class="ParameterList_h4__nH9G8 ParameterList_dividing__wRGRx">Query Parameters</h4><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">unit</span><span class="Parameter_type__djM_s">string</span><span class="Parameter_required__pcK_H">Required</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">A unit of time</div><div class="Parameter_default__HHgG0 Parameter_spacer__JKXbH">Default: <span class="Parameter_label__DUY7G">"day"</span></div><div class="Parameter_enum__csO6P Parameter_spacer__JKXbH">Enum: <span class="Parameter_label__DUY7G">"minute"</span><span class="Parameter_label__DUY7G">"hour"</span><span class="Parameter_label__DUY7G">"day"</span><span class="Parameter_label__DUY7G">"week"</span><span class="Parameter_label__DUY7G">"month"</span></div></div><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">units</span><span class="Parameter_type__djM_s">integer</span><span class="Parameter_required__pcK_H">Required</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">An integer representing the time units to query data for. pass -1 to return all units of time.</div><div class="Parameter_default__HHgG0 Parameter_spacer__JKXbH">Default: <span class="Parameter_label__DUY7G">-1</span></div></div><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">unit_reference</span><span class="Parameter_type__djM_s">string</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">An ISO-8601 timestamp, indicating the most recent time for which to pull metrics. Will default to current time. Timestamp values should be url encoded (i.e. replace '+' with '%2B' and ':' with '%3A'; 2022-02-02T15:53:02+0000 becomes 2022-02-02T15%3A53%3A02%2B0000)</div></div></div></div><div class="MethodDetail_examples__8nXeM"><div><label class="CodeSyntaxSelector_header__6P_Jc CodeSyntaxSelector_headerDark__hI3A0"><span>Request</span><div class="Select_wrapper__58utF Select_dark__KPIws"><select class="Select_select__qXz_Z Select_dark__KPIws" aria-label="Select" autocomplete="off"><option value="cURL" selected="">cURL</option><option value="Node">Node</option><option value="Browser">Browser</option><option value="Go">Go</option><option value="Python">Python</option></select><svg viewbox="0 0 8 14" xmlns="http://www.w3.org/2000/svg"><path d="M6.463 7 .987 1.66a.61.61 0 0 1 0-.878.648.648 0 0 1 .9 0L7.813 6.56a.61.61 0 0 1 0 .878l-5.926 5.78a.648.648 0 0 1-.9 0 .61.61 0 0 1 0-.879L6.463 7Z"></path></svg></div></label><div class="CodeSyntaxSelector_body__hBJ7j CodeSyntaxSelector_bodyDark__cizVw" tabindex="0"><div class="CodeBlock_codeBlock__KlURa"><pre tabindex="0" style="color:#ffffff;font-family:ProximaNova, monospace;line-height:1.2;font-size:1rem"><code class="language-bash" style="white-space:pre"><span class="token token" style="color:#ee6123">curl</span><span> </span><span class="token token punctuation">\</span><span> </span><span>-H </span><span class="token token" style="color:#acda95">'Authorization: Bearer {TOKEN}'</span><span> </span><span class="token token punctuation">\</span><span> </span><span>-X GET </span><span class="token token punctuation">\</span><span> </span><span>https://api-ssl.bitly.com/v4/organizations/Oa1bcd234eF/shorten_counts?unit</span><span class="token token operator">=</span><span>month</span><span class="token token operator">&</span><span class="token token assign-left variable">units</span><span class="token token operator">=</span><span class="token token" style="color:#a1b8f3">5</span><span class="token token operator">&</span><span class="token token assign-left variable">unit_reference</span><span class="token token operator">=</span><span class="token token" style="color:#a1b8f3">2006</span><span>-01-02T15%3A04%3A05-0700</span></code></pre></div></div></div><div><label class="CodeSyntaxSelector_header__6P_Jc"><span>Response</span><div class="Select_wrapper__58utF"><select class="Select_select__qXz_Z" aria-label="Select" autocomplete="off"><option value="200" selected="">200 SUCCESS</option><option value="403">403 FORBIDDEN</option><option value="404">404 NOT_FOUND</option><option value="500">500 INTERNAL_ERROR</option><option value="503">503 TEMPORARILY_UNAVAILABLE</option></select><svg viewbox="0 0 8 14" xmlns="http://www.w3.org/2000/svg"><path d="M6.463 7 .987 1.66a.61.61 0 0 1 0-.878.648.648 0 0 1 .9 0L7.813 6.56a.61.61 0 0 1 0 .878l-5.926 5.78a.648.648 0 0 1-.9 0 .61.61 0 0 1 0-.879L6.463 7Z"></path></svg></div></label><div class="CodeSyntaxSelector_body__hBJ7j" tabindex="0"><div class="CodeBlock_codeBlock__KlURa"><pre tabindex="0" style="color:#36383b;font-family:ProximaNova, monospace;line-height:1.2;font-size:1rem"><code class="language-json" style="white-space:pre"><span class="token token punctuation">{</span><span> </span><span> </span><span class="token token property">"unit"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"units"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"integer"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"facet"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"unit_reference"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"metrics"</span><span class="token token operator">:</span><span> </span><span class="token token punctuation">[</span><span> </span><span> </span><span class="token token punctuation">{</span><span> </span><span> </span><span class="token token property">"key"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"value"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"integer"</span><span> </span><span> </span><span class="token token punctuation">}</span><span> </span><span> </span><span class="token token punctuation">]</span><span> </span><span></span><span class="token token punctuation">}</span></code></pre></div></div></div></div></div><div class="MethodDetail_methodContainer__3EF7h" id="getPlanLimits"><div class="MethodDetail_method__fyEiw"><div><h3 class="MethodHeader_h3__seOfC">Get Plan Limits</h3><h4 class="MethodHeader_description__3_p_p"><div class="MethodHeader_iconStyle__x5Ow4"><svg viewbox="0 0 14 6" xmlns="http://www.w3.org/2000/svg" class="IconRest_restIcon__3pju8 get"><title>Get</title><path d="M2.587 6c.307 0 .607-.044.9-.132.295-.088.533-.217.716-.387V2.876H2.271v.825h1.027v1.145a.772.772 0 0 1-.239.1 1.4 1.4 0 0 1-.383.049 1.338 1.338 0 0 1-1.083-.52c-.135-.17-.24-.379-.316-.626a2.879 2.879 0 0 1-.113-.84c0-.352.038-.655.113-.907.076-.253.182-.46.32-.623.137-.162.3-.281.488-.358a1.783 1.783 0 0 1 .97-.082l.13.032v.915h.889V.28a3.182 3.182 0 0 0-.59-.202A3.507 3.507 0 0 0 2.676 0c-.313 0-.628.055-.946.165a2.4 2.4 0 0 0-.861.523 2.707 2.707 0 0 0-.627.92C.081 1.98 0 2.433 0 2.966c0 .506.067.946.202 1.323.135.376.318.692.55.948a2.2 2.2 0 0 0 .82.572A2.7 2.7 0 0 0 2.587 6Zm6.24-.115V4.879H6.184V3.47h2.4V2.465h-2.4V1.121h2.602V.115h-3.71v5.77h3.75Zm4.43 0v-.907h-.914V1.022h.768v.997H14V.115H9.57V2.02h.89v-.997h.776v3.956h-.922v.907h2.942Z"></path></svg></div> /v4/organizations/{organization_guid}/plan_limits</h4><p class="MethodHeader_description__3_p_p">Returns all plan limits and counts available for an organization.</p></div><div><h4 class="ParameterList_h4__nH9G8 ParameterList_dividing__wRGRx">Path Parameters</h4><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">organization_guid</span><span class="Parameter_type__djM_s">string</span><span class="Parameter_required__pcK_H">Required</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">A GUID for a Bitly organization</div></div></div></div><div class="MethodDetail_examples__8nXeM"><div><label class="CodeSyntaxSelector_header__6P_Jc CodeSyntaxSelector_headerDark__hI3A0"><span>Request</span><div class="Select_wrapper__58utF Select_dark__KPIws"><select class="Select_select__qXz_Z Select_dark__KPIws" aria-label="Select" autocomplete="off"><option value="cURL" selected="">cURL</option><option value="Node">Node</option><option value="Browser">Browser</option><option value="Go">Go</option><option value="Python">Python</option></select><svg viewbox="0 0 8 14" xmlns="http://www.w3.org/2000/svg"><path d="M6.463 7 .987 1.66a.61.61 0 0 1 0-.878.648.648 0 0 1 .9 0L7.813 6.56a.61.61 0 0 1 0 .878l-5.926 5.78a.648.648 0 0 1-.9 0 .61.61 0 0 1 0-.879L6.463 7Z"></path></svg></div></label><div class="CodeSyntaxSelector_body__hBJ7j CodeSyntaxSelector_bodyDark__cizVw" tabindex="0"><div class="CodeBlock_codeBlock__KlURa"><pre tabindex="0" style="color:#ffffff;font-family:ProximaNova, monospace;line-height:1.2;font-size:1rem"><code class="language-bash" style="white-space:pre"><span class="token token" style="color:#ee6123">curl</span><span> </span><span class="token token punctuation">\</span><span> </span><span>-H </span><span class="token token" style="color:#acda95">'Authorization: Bearer {TOKEN}'</span><span> </span><span class="token token punctuation">\</span><span> </span><span>-X GET </span><span class="token token punctuation">\</span><span> </span>https://api-ssl.bitly.com/v4/organizations/Oa1bcd234eF/plan_limits</code></pre></div></div></div><div><label class="CodeSyntaxSelector_header__6P_Jc"><span>Response</span><div class="Select_wrapper__58utF"><select class="Select_select__qXz_Z" aria-label="Select" autocomplete="off"><option value="200" selected="">200 SUCCESS</option><option value="403">403 FORBIDDEN</option><option value="500">500 INTERNAL_ERROR</option><option value="503">503 TEMPORARILY_UNAVAILABLE</option></select><svg viewbox="0 0 8 14" xmlns="http://www.w3.org/2000/svg"><path d="M6.463 7 .987 1.66a.61.61 0 0 1 0-.878.648.648 0 0 1 .9 0L7.813 6.56a.61.61 0 0 1 0 .878l-5.926 5.78a.648.648 0 0 1-.9 0 .61.61 0 0 1 0-.879L6.463 7Z"></path></svg></div></label><div class="CodeSyntaxSelector_body__hBJ7j" tabindex="0"><div class="CodeBlock_codeBlock__KlURa"><pre tabindex="0" style="color:#36383b;font-family:ProximaNova, monospace;line-height:1.2;font-size:1rem"><code class="language-json" style="white-space:pre"><span class="token token punctuation">{</span><span> </span><span> </span><span class="token token property">"references"</span><span class="token token operator">:</span><span> </span><span class="token token punctuation">{</span><span> </span><span class="token token" style="color:#51763e">"any"</span><span> </span><span class="token token punctuation">}</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"organization_guid"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"plan_limits"</span><span class="token token operator">:</span><span> </span><span class="token token punctuation">[</span><span> </span><span> </span><span class="token token punctuation">{</span><span> </span><span> </span><span class="token token property">"name"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"description"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"limit"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"integer"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"count"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"integer"</span><span> </span><span> </span><span class="token token punctuation">}</span><span> </span><span> </span><span class="token token punctuation">]</span><span> </span><span></span><span class="token token punctuation">}</span></code></pre></div></div></div></div></div><div class="ApiReference_tagInfo__YVbgw"><h2 class="ApiReference_tagName__IJx2p">User</h2><p class="ApiReference_tagDescription__8c1GM">Some subscription plans allow multiple users. Only one user is used for authenticating a call, and these operations apply only to the authenticated user. </p></div><div class="MethodDetail_methodContainer__3EF7h" id="updateUser"><div class="MethodDetail_method__fyEiw"><div><h3 class="MethodHeader_h3__seOfC">Update a User</h3><h4 class="MethodHeader_description__3_p_p"><div class="MethodHeader_iconStyle__x5Ow4"><svg viewbox="0 0 23 6" xmlns="http://www.w3.org/2000/svg" class="IconRest_restIcon__3pju8 patch"><title>Patch</title><path d="M1.095 5.885V3.898c.027.006.07.011.132.017a4.052 4.052 0 0 0 .372.016h.128c.277 0 .545-.037.803-.11.259-.075.49-.193.692-.355.202-.162.365-.368.487-.618.123-.25.184-.551.184-.903 0-.401-.07-.727-.212-.977a1.606 1.606 0 0 0-.547-.585 2.041 2.041 0 0 0-.756-.28 5.067 5.067 0 0 0-.835-.07c-.267 0-.534.012-.804.037C.47.095.224.13 0 .173v5.712h1.095Zm.472-2.934h-.1a2.448 2.448 0 0 1-.276-.017.853.853 0 0 1-.096-.016V1.047c.059-.011.136-.02.232-.03.096-.007.197-.012.304-.012.138 0 .274.014.408.042a.964.964 0 0 1 .355.148.801.801 0 0 1 .252.284.937.937 0 0 1 .096.45c0 .214-.033.387-.1.519a.787.787 0 0 1-.268.309 1.038 1.038 0 0 1-.38.152 2.235 2.235 0 0 1-.427.042Zm3.79 2.934.383-1.278h1.67l.4 1.278h1.152L7.163.115H6.068L4.26 5.885h1.095ZM7.194 3.7h-1.2l.56-1.929h.072l.568 1.929Zm5.668 2.184v-.907h-.903V1.022h.76v.997h.879V.115H9.218V2.02h.879v-.997h.767v3.956h-.91v.907h2.91Zm3.91.115c.276 0 .547-.036.81-.107.265-.072.482-.17.652-.297V3.948h-.88v.997c-.164.033-.335.05-.51.05-.246 0-.464-.049-.656-.145a1.383 1.383 0 0 1-.488-.408 1.881 1.881 0 0 1-.304-.63A2.973 2.973 0 0 1 15.293 3c0-.34.038-.636.112-.886.075-.25.179-.457.312-.622.133-.165.29-.287.468-.367.178-.08.371-.12.58-.12.175 0 .346.014.511.042v.94h.88V.271a2.727 2.727 0 0 0-.548-.19A3.419 3.419 0 0 0 16.796 0c-.303 0-.613.05-.927.152-.314.102-.6.27-.855.503a2.611 2.611 0 0 0-.628.923c-.163.382-.244.856-.244 1.422 0 .544.072 1.007.216 1.389.144.382.336.692.576.931.24.24.518.412.835.52.317.106.652.16 1.003.16Zm3.325-.115V3.47h1.807v2.415H23V.115h-1.095v2.35h-1.807V.114h-1.095v5.77h1.095Z"></path></svg></div> /v4/user</h4><p class="MethodHeader_description__3_p_p">Update fields in the user</p></div><div><h4 class="ParameterList_h4__nH9G8 ParameterList_dividing__wRGRx">Request Body Schema</h4><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">name</span><span class="Parameter_type__djM_s">string</span></div></div><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">default_group_guid</span><span class="Parameter_type__djM_s">string</span></div></div></div></div><div class="MethodDetail_examples__8nXeM"><div><label class="CodeSyntaxSelector_header__6P_Jc CodeSyntaxSelector_headerDark__hI3A0"><span>Request</span><div class="Select_wrapper__58utF Select_dark__KPIws"><select class="Select_select__qXz_Z Select_dark__KPIws" aria-label="Select" autocomplete="off"><option value="cURL" selected="">cURL</option><option value="Node">Node</option><option value="Browser">Browser</option><option value="Go">Go</option><option value="Python">Python</option></select><svg viewbox="0 0 8 14" xmlns="http://www.w3.org/2000/svg"><path d="M6.463 7 .987 1.66a.61.61 0 0 1 0-.878.648.648 0 0 1 .9 0L7.813 6.56a.61.61 0 0 1 0 .878l-5.926 5.78a.648.648 0 0 1-.9 0 .61.61 0 0 1 0-.879L6.463 7Z"></path></svg></div></label><div class="CodeSyntaxSelector_body__hBJ7j CodeSyntaxSelector_bodyDark__cizVw" tabindex="0"><div class="CodeBlock_codeBlock__KlURa"><pre tabindex="0" style="color:#ffffff;font-family:ProximaNova, monospace;line-height:1.2;font-size:1rem"><code class="language-bash" style="white-space:pre"><span class="token token" style="color:#ee6123">curl</span><span> </span><span class="token token punctuation">\</span><span> </span><span>-H </span><span class="token token" style="color:#acda95">'Authorization: Bearer {TOKEN}'</span><span> </span><span class="token token punctuation">\</span><span> </span><span>-H </span><span class="token token" style="color:#acda95">'Content-Type: application/json'</span><span> </span><span class="token token punctuation">\</span><span> </span><span>-X PATCH </span><span class="token token punctuation">\</span><span> </span><span>-d </span><span class="token token" style="color:#acda95">'{ </span><span class="token token" style="color:#acda95"> "name": "Chauncey McPufferson", </span><span class="token token" style="color:#acda95"> "default_group_guid": "Ba1bc23dE4F" </span><span class="token token" style="color:#acda95">}'</span><span> </span><span class="token token punctuation">\</span><span> </span>https://api-ssl.bitly.com/v4/user</code></pre></div></div></div><div><label class="CodeSyntaxSelector_header__6P_Jc"><span>Response</span><div class="Select_wrapper__58utF"><select class="Select_select__qXz_Z" aria-label="Select" autocomplete="off"><option value="200" selected="">200 SUCCESS</option><option value="400">400 BAD_REQUEST</option><option value="403">403 FORBIDDEN</option><option value="404">404 NOT_FOUND</option><option value="422">422 UNPROCESSABLE_ENTITY</option><option value="500">500 INTERNAL_ERROR</option><option value="503">503 TEMPORARILY_UNAVAILABLE</option></select><svg viewbox="0 0 8 14" xmlns="http://www.w3.org/2000/svg"><path d="M6.463 7 .987 1.66a.61.61 0 0 1 0-.878.648.648 0 0 1 .9 0L7.813 6.56a.61.61 0 0 1 0 .878l-5.926 5.78a.648.648 0 0 1-.9 0 .61.61 0 0 1 0-.879L6.463 7Z"></path></svg></div></label><div class="CodeSyntaxSelector_body__hBJ7j" tabindex="0"><div class="CodeBlock_codeBlock__KlURa"><pre tabindex="0" style="color:#36383b;font-family:ProximaNova, monospace;line-height:1.2;font-size:1rem"><code class="language-json" style="white-space:pre"><span class="token token punctuation">{</span><span> </span><span> </span><span class="token token property">"login"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"name"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"is_active"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"boolean"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"created"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"modified"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"is_sso_user"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"boolean"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"emails"</span><span class="token token operator">:</span><span> </span><span class="token token punctuation">[</span><span> </span><span> </span><span class="token token punctuation">{</span><span> </span><span> </span><span class="token token property">"email"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"is_primary"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"boolean"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"is_verified"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"boolean"</span><span> </span><span> </span><span class="token token punctuation">}</span><span> </span><span> </span><span class="token token punctuation">]</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"is_2fa_enabled"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"boolean"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"default_group_guid"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span> </span><span></span><span class="token token punctuation">}</span></code></pre></div></div></div></div></div><div class="MethodDetail_methodContainer__3EF7h" id="getUser"><div class="MethodDetail_method__fyEiw"><div><h3 class="MethodHeader_h3__seOfC">Retrieve a User</h3><h4 class="MethodHeader_description__3_p_p"><div class="MethodHeader_iconStyle__x5Ow4"><svg viewbox="0 0 14 6" xmlns="http://www.w3.org/2000/svg" class="IconRest_restIcon__3pju8 get"><title>Get</title><path d="M2.587 6c.307 0 .607-.044.9-.132.295-.088.533-.217.716-.387V2.876H2.271v.825h1.027v1.145a.772.772 0 0 1-.239.1 1.4 1.4 0 0 1-.383.049 1.338 1.338 0 0 1-1.083-.52c-.135-.17-.24-.379-.316-.626a2.879 2.879 0 0 1-.113-.84c0-.352.038-.655.113-.907.076-.253.182-.46.32-.623.137-.162.3-.281.488-.358a1.783 1.783 0 0 1 .97-.082l.13.032v.915h.889V.28a3.182 3.182 0 0 0-.59-.202A3.507 3.507 0 0 0 2.676 0c-.313 0-.628.055-.946.165a2.4 2.4 0 0 0-.861.523 2.707 2.707 0 0 0-.627.92C.081 1.98 0 2.433 0 2.966c0 .506.067.946.202 1.323.135.376.318.692.55.948a2.2 2.2 0 0 0 .82.572A2.7 2.7 0 0 0 2.587 6Zm6.24-.115V4.879H6.184V3.47h2.4V2.465h-2.4V1.121h2.602V.115h-3.71v5.77h3.75Zm4.43 0v-.907h-.914V1.022h.768v.997H14V.115H9.57V2.02h.89v-.997h.776v3.956h-.922v.907h2.942Z"></path></svg></div> /v4/user</h4><p class="MethodHeader_description__3_p_p">Returns information for the current authenticated user.</p></div></div><div class="MethodDetail_examples__8nXeM"><div><label class="CodeSyntaxSelector_header__6P_Jc CodeSyntaxSelector_headerDark__hI3A0"><span>Request</span><div class="Select_wrapper__58utF Select_dark__KPIws"><select class="Select_select__qXz_Z Select_dark__KPIws" aria-label="Select" autocomplete="off"><option value="cURL" selected="">cURL</option><option value="Node">Node</option><option value="Browser">Browser</option><option value="Go">Go</option><option value="Python">Python</option></select><svg viewbox="0 0 8 14" xmlns="http://www.w3.org/2000/svg"><path d="M6.463 7 .987 1.66a.61.61 0 0 1 0-.878.648.648 0 0 1 .9 0L7.813 6.56a.61.61 0 0 1 0 .878l-5.926 5.78a.648.648 0 0 1-.9 0 .61.61 0 0 1 0-.879L6.463 7Z"></path></svg></div></label><div class="CodeSyntaxSelector_body__hBJ7j CodeSyntaxSelector_bodyDark__cizVw" tabindex="0"><div class="CodeBlock_codeBlock__KlURa"><pre tabindex="0" style="color:#ffffff;font-family:ProximaNova, monospace;line-height:1.2;font-size:1rem"><code class="language-bash" style="white-space:pre"><span class="token token" style="color:#ee6123">curl</span><span> </span><span class="token token punctuation">\</span><span> </span><span>-H </span><span class="token token" style="color:#acda95">'Authorization: Bearer {TOKEN}'</span><span> </span><span class="token token punctuation">\</span><span> </span><span>-X GET </span><span class="token token punctuation">\</span><span> </span>https://api-ssl.bitly.com/v4/user</code></pre></div></div></div><div><label class="CodeSyntaxSelector_header__6P_Jc"><span>Response</span><div class="Select_wrapper__58utF"><select class="Select_select__qXz_Z" aria-label="Select" autocomplete="off"><option value="200" selected="">200 SUCCESS</option><option value="403">403 FORBIDDEN</option><option value="404">404 NOT_FOUND</option><option value="500">500 INTERNAL_ERROR</option><option value="503">503 TEMPORARILY_UNAVAILABLE</option></select><svg viewbox="0 0 8 14" xmlns="http://www.w3.org/2000/svg"><path d="M6.463 7 .987 1.66a.61.61 0 0 1 0-.878.648.648 0 0 1 .9 0L7.813 6.56a.61.61 0 0 1 0 .878l-5.926 5.78a.648.648 0 0 1-.9 0 .61.61 0 0 1 0-.879L6.463 7Z"></path></svg></div></label><div class="CodeSyntaxSelector_body__hBJ7j" tabindex="0"><div class="CodeBlock_codeBlock__KlURa"><pre tabindex="0" style="color:#36383b;font-family:ProximaNova, monospace;line-height:1.2;font-size:1rem"><code class="language-json" style="white-space:pre"><span class="token token punctuation">{</span><span> </span><span> </span><span class="token token property">"login"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"name"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"is_active"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"boolean"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"created"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"modified"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"is_sso_user"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"boolean"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"emails"</span><span class="token token operator">:</span><span> </span><span class="token token punctuation">[</span><span> </span><span> </span><span class="token token punctuation">{</span><span> </span><span> </span><span class="token token property">"email"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"is_primary"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"boolean"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"is_verified"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"boolean"</span><span> </span><span> </span><span class="token token punctuation">}</span><span> </span><span> </span><span class="token token punctuation">]</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"is_2fa_enabled"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"boolean"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"default_group_guid"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span> </span><span></span><span class="token token punctuation">}</span></code></pre></div></div></div></div></div><div class="MethodDetail_methodContainer__3EF7h" id="getPlatformLimits"><div class="MethodDetail_method__fyEiw"><div><h3 class="MethodHeader_h3__seOfC">Get Platform Limits</h3><h4 class="MethodHeader_description__3_p_p"><div class="MethodHeader_iconStyle__x5Ow4"><svg viewbox="0 0 14 6" xmlns="http://www.w3.org/2000/svg" class="IconRest_restIcon__3pju8 get"><title>Get</title><path d="M2.587 6c.307 0 .607-.044.9-.132.295-.088.533-.217.716-.387V2.876H2.271v.825h1.027v1.145a.772.772 0 0 1-.239.1 1.4 1.4 0 0 1-.383.049 1.338 1.338 0 0 1-1.083-.52c-.135-.17-.24-.379-.316-.626a2.879 2.879 0 0 1-.113-.84c0-.352.038-.655.113-.907.076-.253.182-.46.32-.623.137-.162.3-.281.488-.358a1.783 1.783 0 0 1 .97-.082l.13.032v.915h.889V.28a3.182 3.182 0 0 0-.59-.202A3.507 3.507 0 0 0 2.676 0c-.313 0-.628.055-.946.165a2.4 2.4 0 0 0-.861.523 2.707 2.707 0 0 0-.627.92C.081 1.98 0 2.433 0 2.966c0 .506.067.946.202 1.323.135.376.318.692.55.948a2.2 2.2 0 0 0 .82.572A2.7 2.7 0 0 0 2.587 6Zm6.24-.115V4.879H6.184V3.47h2.4V2.465h-2.4V1.121h2.602V.115h-3.71v5.77h3.75Zm4.43 0v-.907h-.914V1.022h.768v.997H14V.115H9.57V2.02h.89v-.997h.776v3.956h-.922v.907h2.942Z"></path></svg></div> /v4/user/platform_limits</h4><p class="MethodHeader_description__3_p_p">Fetch all platform limits and counts available for an organization</p></div><div><h4 class="ParameterList_h4__nH9G8 ParameterList_dividing__wRGRx">Query Parameters</h4><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">path</span><span class="Parameter_type__djM_s">string</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">The specific path for which information is requested</div></div></div></div><div class="MethodDetail_examples__8nXeM"><div><label class="CodeSyntaxSelector_header__6P_Jc CodeSyntaxSelector_headerDark__hI3A0"><span>Request</span><div class="Select_wrapper__58utF Select_dark__KPIws"><select class="Select_select__qXz_Z Select_dark__KPIws" aria-label="Select" autocomplete="off"><option value="cURL" selected="">cURL</option><option value="Node">Node</option><option value="Browser">Browser</option><option value="Go">Go</option><option value="Python">Python</option></select><svg viewbox="0 0 8 14" xmlns="http://www.w3.org/2000/svg"><path d="M6.463 7 .987 1.66a.61.61 0 0 1 0-.878.648.648 0 0 1 .9 0L7.813 6.56a.61.61 0 0 1 0 .878l-5.926 5.78a.648.648 0 0 1-.9 0 .61.61 0 0 1 0-.879L6.463 7Z"></path></svg></div></label><div class="CodeSyntaxSelector_body__hBJ7j CodeSyntaxSelector_bodyDark__cizVw" tabindex="0"><div class="CodeBlock_codeBlock__KlURa"><pre tabindex="0" style="color:#ffffff;font-family:ProximaNova, monospace;line-height:1.2;font-size:1rem"><code class="language-bash" style="white-space:pre"><span class="token token" style="color:#ee6123">curl</span><span> </span><span class="token token punctuation">\</span><span> </span><span>-H </span><span class="token token" style="color:#acda95">'Authorization: Bearer {TOKEN}'</span><span> </span><span class="token token punctuation">\</span><span> </span><span>-X GET </span><span class="token token punctuation">\</span><span> </span><span>https://api-ssl.bitly.com/v4/user/platform_limits?path</span><span class="token token operator">=</span><span>%2Forganizations%2F%7Borganization_guid%7D</span></code></pre></div></div></div><div><label class="CodeSyntaxSelector_header__6P_Jc"><span>Response</span><div class="Select_wrapper__58utF"><select class="Select_select__qXz_Z" aria-label="Select" autocomplete="off"><option value="200" selected="">200 SUCCESS</option><option value="403">403 FORBIDDEN</option><option value="404">404 NOT_FOUND</option><option value="500">500 INTERNAL_ERROR</option><option value="503">503 TEMPORARILY_UNAVAILABLE</option></select><svg viewbox="0 0 8 14" xmlns="http://www.w3.org/2000/svg"><path d="M6.463 7 .987 1.66a.61.61 0 0 1 0-.878.648.648 0 0 1 .9 0L7.813 6.56a.61.61 0 0 1 0 .878l-5.926 5.78a.648.648 0 0 1-.9 0 .61.61 0 0 1 0-.879L6.463 7Z"></path></svg></div></label><div class="CodeSyntaxSelector_body__hBJ7j" tabindex="0"><div class="CodeBlock_codeBlock__KlURa"><pre tabindex="0" style="color:#36383b;font-family:ProximaNova, monospace;line-height:1.2;font-size:1rem"><code class="language-json" style="white-space:pre"><span class="token token punctuation">{</span><span> </span><span> </span><span class="token token property">"platform_limits"</span><span class="token token operator">:</span><span> </span><span class="token token punctuation">[</span><span> </span><span> </span><span class="token token punctuation">{</span><span> </span><span> </span><span class="token token property">"endpoint"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"methods"</span><span class="token token operator">:</span><span> </span><span class="token token punctuation">[</span><span> </span><span> </span><span class="token token punctuation">{</span><span> </span><span> </span><span class="token token property">"name"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"limit"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"integer"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"count"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"integer"</span><span> </span><span> </span><span class="token token punctuation">}</span><span> </span><span> </span><span class="token token punctuation">]</span><span> </span><span> </span><span class="token token punctuation">}</span><span> </span><span> </span><span class="token token punctuation">]</span><span> </span><span></span><span class="token token punctuation">}</span></code></pre></div></div></div></div></div><div class="ApiReference_tagInfo__YVbgw"><h2 class="ApiReference_tagName__IJx2p">Webhooks</h2><p class="ApiReference_tagDescription__8c1GM">Webhooks are a method of sending information from Bitly to an application outside of Bitly. It's a way to automate actions or updates between two different systems. These endpoints are for configuring your webhooks. </p></div><div class="MethodDetail_methodContainer__3EF7h" id="getWebhooks"><div class="MethodDetail_method__fyEiw"><div><h3 class="MethodHeader_h3__seOfC">Get Webhooks</h3><h4 class="MethodHeader_description__3_p_p"><div class="MethodHeader_iconStyle__x5Ow4"><svg viewbox="0 0 14 6" xmlns="http://www.w3.org/2000/svg" class="IconRest_restIcon__3pju8 get"><title>Get</title><path d="M2.587 6c.307 0 .607-.044.9-.132.295-.088.533-.217.716-.387V2.876H2.271v.825h1.027v1.145a.772.772 0 0 1-.239.1 1.4 1.4 0 0 1-.383.049 1.338 1.338 0 0 1-1.083-.52c-.135-.17-.24-.379-.316-.626a2.879 2.879 0 0 1-.113-.84c0-.352.038-.655.113-.907.076-.253.182-.46.32-.623.137-.162.3-.281.488-.358a1.783 1.783 0 0 1 .97-.082l.13.032v.915h.889V.28a3.182 3.182 0 0 0-.59-.202A3.507 3.507 0 0 0 2.676 0c-.313 0-.628.055-.946.165a2.4 2.4 0 0 0-.861.523 2.707 2.707 0 0 0-.627.92C.081 1.98 0 2.433 0 2.966c0 .506.067.946.202 1.323.135.376.318.692.55.948a2.2 2.2 0 0 0 .82.572A2.7 2.7 0 0 0 2.587 6Zm6.24-.115V4.879H6.184V3.47h2.4V2.465h-2.4V1.121h2.602V.115h-3.71v5.77h3.75Zm4.43 0v-.907h-.914V1.022h.768v.997H14V.115H9.57V2.02h.89v-.997h.776v3.956h-.922v.907h2.942Z"></path></svg></div> /v4/organizations/{organization_guid}/webhooks</h4><p class="MethodHeader_description__3_p_p">Fetch all webhooks available for an Organization</p></div><div><h4 class="ParameterList_h4__nH9G8 ParameterList_dividing__wRGRx">Path Parameters</h4><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">organization_guid</span><span class="Parameter_type__djM_s">string</span><span class="Parameter_required__pcK_H">Required</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">A GUID for a Bitly organization</div></div></div></div><div class="MethodDetail_examples__8nXeM"><div><label class="CodeSyntaxSelector_header__6P_Jc CodeSyntaxSelector_headerDark__hI3A0"><span>Request</span><div class="Select_wrapper__58utF Select_dark__KPIws"><select class="Select_select__qXz_Z Select_dark__KPIws" aria-label="Select" autocomplete="off"><option value="cURL" selected="">cURL</option><option value="Node">Node</option><option value="Browser">Browser</option><option value="Go">Go</option><option value="Python">Python</option></select><svg viewbox="0 0 8 14" xmlns="http://www.w3.org/2000/svg"><path d="M6.463 7 .987 1.66a.61.61 0 0 1 0-.878.648.648 0 0 1 .9 0L7.813 6.56a.61.61 0 0 1 0 .878l-5.926 5.78a.648.648 0 0 1-.9 0 .61.61 0 0 1 0-.879L6.463 7Z"></path></svg></div></label><div class="CodeSyntaxSelector_body__hBJ7j CodeSyntaxSelector_bodyDark__cizVw" tabindex="0"><div class="CodeBlock_codeBlock__KlURa"><pre tabindex="0" style="color:#ffffff;font-family:ProximaNova, monospace;line-height:1.2;font-size:1rem"><code class="language-bash" style="white-space:pre"><span class="token token" style="color:#ee6123">curl</span><span> </span><span class="token token punctuation">\</span><span> </span><span>-H </span><span class="token token" style="color:#acda95">'Authorization: Bearer {TOKEN}'</span><span> </span><span class="token token punctuation">\</span><span> </span><span>-X GET </span><span class="token token punctuation">\</span><span> </span>https://api-ssl.bitly.com/v4/organizations/Oa1bcd234eF/webhooks</code></pre></div></div></div><div><label class="CodeSyntaxSelector_header__6P_Jc"><span>Response</span><div class="Select_wrapper__58utF"><select class="Select_select__qXz_Z" aria-label="Select" autocomplete="off"><option value="200" selected="">200 SUCCESS</option><option value="402">402 UPGRADE_REQUIRED</option><option value="403">403 FORBIDDEN</option><option value="404">404 NOT_FOUND</option><option value="500">500 INTERNAL_ERROR</option><option value="503">503 TEMPORARILY_UNAVAILABLE</option></select><svg viewbox="0 0 8 14" xmlns="http://www.w3.org/2000/svg"><path d="M6.463 7 .987 1.66a.61.61 0 0 1 0-.878.648.648 0 0 1 .9 0L7.813 6.56a.61.61 0 0 1 0 .878l-5.926 5.78a.648.648 0 0 1-.9 0 .61.61 0 0 1 0-.879L6.463 7Z"></path></svg></div></label><div class="CodeSyntaxSelector_body__hBJ7j" tabindex="0"><div class="CodeBlock_codeBlock__KlURa"><pre tabindex="0" style="color:#36383b;font-family:ProximaNova, monospace;line-height:1.2;font-size:1rem"><code class="language-json" style="white-space:pre"><span class="token token punctuation">{</span><span> </span><span> </span><span class="token token property">"webhooks"</span><span class="token token operator">:</span><span> </span><span class="token token punctuation">[</span><span> </span><span> </span><span class="token token punctuation">{</span><span> </span><span> </span><span class="token token property">"references"</span><span class="token token operator">:</span><span> </span><span class="token token punctuation">{</span><span> </span><span class="token token" style="color:#51763e">"any"</span><span> </span><span class="token token punctuation">}</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"guid"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"created"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"modified"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"modified_by"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"alerted"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"deactivated"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"is_active"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"boolean"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"is_alert"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"boolean"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"organization_guid"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"group_guid"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"name"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"event"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"url"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"status"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"oauth_url"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"client_id"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"client_secret"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"fetch_tags"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"boolean"</span><span> </span><span> </span><span class="token token punctuation">}</span><span> </span><span> </span><span class="token token punctuation">]</span><span> </span><span></span><span class="token token punctuation">}</span></code></pre></div></div></div></div></div><div class="MethodDetail_methodContainer__3EF7h" id="createWebhook"><div class="MethodDetail_method__fyEiw"><div><h3 class="MethodHeader_h3__seOfC">Create Webhook</h3><h4 class="MethodHeader_description__3_p_p"><div class="MethodHeader_iconStyle__x5Ow4"><svg viewbox="0 0 18 6" xmlns="http://www.w3.org/2000/svg" class="IconRest_restIcon__3pju8 post"><title>Post</title><path d="M1.072 5.885V3.898c.026.006.069.011.129.017a3.88 3.88 0 0 0 .364.016h.125c.27 0 .533-.037.786-.11.253-.075.478-.193.677-.355.198-.162.357-.368.477-.618s.18-.551.18-.903c0-.401-.07-.727-.208-.977a1.592 1.592 0 0 0-.536-.585 1.971 1.971 0 0 0-.739-.28 4.854 4.854 0 0 0-.817-.07C1.249.033.987.045.724.07.46.095.219.13 0 .173v5.712h1.072Zm.461-2.934h-.098a2.344 2.344 0 0 1-.27-.017.818.818 0 0 1-.093-.016V1.047c.057-.011.133-.02.227-.03.093-.007.193-.012.297-.012.135 0 .268.014.399.042.13.027.246.077.348.148a.796.796 0 0 1 .246.284.954.954 0 0 1 .094.45c0 .214-.032.387-.098.519a.782.782 0 0 1-.262.309c-.11.074-.233.125-.371.152a2.141 2.141 0 0 1-.419.042ZM6.47 6c.694 0 1.212-.265 1.553-.795.342-.53.513-1.265.513-2.205 0-.44-.038-.843-.114-1.212a2.872 2.872 0 0 0-.36-.947 1.78 1.78 0 0 0-.637-.618C7.163.074 6.844 0 6.469 0c-.35 0-.653.069-.911.206a1.78 1.78 0 0 0-.645.59c-.172.255-.3.57-.384.943A5.804 5.804 0 0 0 4.404 3c0 .44.037.843.11 1.212.073.368.191.684.356.947.164.264.378.47.641.618.263.149.583.223.958.223Zm0-1.005c-.203 0-.366-.053-.489-.157a.989.989 0 0 1-.281-.425 2.57 2.57 0 0 1-.133-.63A8.129 8.129 0 0 1 5.53 3c0-.66.065-1.157.195-1.492.13-.335.378-.503.743-.503.209 0 .376.054.501.161a1 1 0 0 1 .286.433c.065.181.106.393.125.635.018.241.027.497.027.766 0 .34-.014.636-.043.886-.029.25-.08.457-.152.622a.826.826 0 0 1-.29.367.803.803 0 0 1-.454.12ZM10.991 6c.297 0 .574-.037.83-.111.255-.074.476-.187.664-.338.188-.151.334-.338.438-.56.104-.223.157-.483.157-.78 0-.307-.067-.563-.2-.766a1.814 1.814 0 0 0-.493-.507 3.3 3.3 0 0 0-.641-.342 11.165 11.165 0 0 1-.642-.28 2.185 2.185 0 0 1-.493-.313.562.562 0 0 1-.199-.445c0-.176.072-.316.215-.42.144-.105.34-.157.59-.157a2.757 2.757 0 0 1 .767.107.14.14 0 0 0 .047.008v.915h.86V.338a2.45 2.45 0 0 0-.735-.247C11.85.03 11.536 0 11.218 0c-.282 0-.537.041-.767.124-.23.082-.426.197-.59.346A1.557 1.557 0 0 0 9.476 1a1.66 1.66 0 0 0-.137.68c0 .324.067.588.2.792.133.203.297.372.493.506.195.135.409.246.641.334.232.088.446.176.642.264.195.088.36.19.492.305.133.115.2.266.2.453 0 .209-.081.375-.243.499-.161.123-.388.185-.68.185-.162 0-.314-.018-.458-.053a2.256 2.256 0 0 1-.395-.136l-.047-.017v-.816h-.86V5.53c.067.039.156.085.266.14.11.055.236.107.379.157.143.05.3.09.47.124.169.033.353.049.55.049Zm6.29-.115v-.907h-.885V1.022h.744v.997H18V.115h-4.287V2.02h.86v-.997h.752v3.956h-.892v.907h2.847Z"></path></svg></div> /v4/webhooks</h4><p class="MethodHeader_description__3_p_p">Creates a webhook.</p></div><div><h4 class="ParameterList_h4__nH9G8 ParameterList_dividing__wRGRx">Request Body Schema</h4><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">is_active</span><span class="Parameter_type__djM_s">boolean</span></div></div><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">organization_guid</span><span class="Parameter_type__djM_s">string</span><span class="Parameter_required__pcK_H">Required</span></div></div><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">group_guid</span><span class="Parameter_type__djM_s">string</span></div></div><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">name</span><span class="Parameter_type__djM_s">string</span><span class="Parameter_required__pcK_H">Required</span></div></div><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">event</span><span class="Parameter_type__djM_s">string</span><span class="Parameter_required__pcK_H">Required</span></div></div><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">url</span><span class="Parameter_type__djM_s">string</span><span class="Parameter_required__pcK_H">Required</span></div></div><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">oauth_url</span><span class="Parameter_type__djM_s">string</span></div></div><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">client_id</span><span class="Parameter_type__djM_s">string</span></div></div><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">client_secret</span><span class="Parameter_type__djM_s">string</span></div></div><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">fetch_tags</span><span class="Parameter_type__djM_s">boolean</span></div></div></div></div><div class="MethodDetail_examples__8nXeM"><div><label class="CodeSyntaxSelector_header__6P_Jc CodeSyntaxSelector_headerDark__hI3A0"><span>Request</span><div class="Select_wrapper__58utF Select_dark__KPIws"><select class="Select_select__qXz_Z Select_dark__KPIws" aria-label="Select" autocomplete="off"><option value="cURL" selected="">cURL</option><option value="Node">Node</option><option value="Browser">Browser</option><option value="Go">Go</option><option value="Python">Python</option></select><svg viewbox="0 0 8 14" xmlns="http://www.w3.org/2000/svg"><path d="M6.463 7 .987 1.66a.61.61 0 0 1 0-.878.648.648 0 0 1 .9 0L7.813 6.56a.61.61 0 0 1 0 .878l-5.926 5.78a.648.648 0 0 1-.9 0 .61.61 0 0 1 0-.879L6.463 7Z"></path></svg></div></label><div class="CodeSyntaxSelector_body__hBJ7j CodeSyntaxSelector_bodyDark__cizVw" tabindex="0"><div class="CodeBlock_codeBlock__KlURa"><pre tabindex="0" style="color:#ffffff;font-family:ProximaNova, monospace;line-height:1.2;font-size:1rem"><code class="language-bash" style="white-space:pre"><span class="token token" style="color:#ee6123">curl</span><span> </span><span class="token token punctuation">\</span><span> </span><span>-H </span><span class="token token" style="color:#acda95">'Authorization: Bearer {TOKEN}'</span><span> </span><span class="token token punctuation">\</span><span> </span><span>-H </span><span class="token token" style="color:#acda95">'Content-Type: application/json'</span><span> </span><span class="token token punctuation">\</span><span> </span><span>-X POST </span><span class="token token punctuation">\</span><span> </span><span>-d </span><span class="token token" style="color:#acda95">'{ </span><span class="token token" style="color:#acda95"> "is_active": true, </span><span class="token token" style="color:#acda95"> "organization_guid": "Oa1bcd234eF", </span><span class="token token" style="color:#acda95"> "group_guid": "Ba1bc23dE4F", </span><span class="token token" style="color:#acda95"> "name": "My Webhook", </span><span class="token token" style="color:#acda95"> "event": "decodes", </span><span class="token token" style="color:#acda95"> "url": "https://bitly.com/webhooks", </span><span class="token token" style="color:#acda95"> "oauth_url": "https://fake.com/oauth", </span><span class="token token" style="color:#acda95"> "client_id": "fakeclientid123", </span><span class="token token" style="color:#acda95"> "client_secret": "itsasecreticanttellyou" </span><span class="token token" style="color:#acda95">}'</span><span> </span><span class="token token punctuation">\</span><span> </span>https://api-ssl.bitly.com/v4/webhooks</code></pre></div></div></div><div><label class="CodeSyntaxSelector_header__6P_Jc"><span>Response</span><div class="Select_wrapper__58utF"><select class="Select_select__qXz_Z" aria-label="Select" autocomplete="off"><option value="201" selected="">201 CREATED</option><option value="400">400 BAD_REQUEST</option><option value="402">402 UPGRADE_REQUIRED</option><option value="403">403 FORBIDDEN</option><option value="404">404 NOT_FOUND</option><option value="422">422 UNPROCESSABLE_ENTITY</option><option value="500">500 INTERNAL_ERROR</option><option value="503">503 TEMPORARILY_UNAVAILABLE</option></select><svg viewbox="0 0 8 14" xmlns="http://www.w3.org/2000/svg"><path d="M6.463 7 .987 1.66a.61.61 0 0 1 0-.878.648.648 0 0 1 .9 0L7.813 6.56a.61.61 0 0 1 0 .878l-5.926 5.78a.648.648 0 0 1-.9 0 .61.61 0 0 1 0-.879L6.463 7Z"></path></svg></div></label><div class="CodeSyntaxSelector_body__hBJ7j" tabindex="0"><div class="CodeBlock_codeBlock__KlURa"><pre tabindex="0" style="color:#36383b;font-family:ProximaNova, monospace;line-height:1.2;font-size:1rem"><code class="language-json" style="white-space:pre"><span class="token token punctuation">{</span><span> </span><span> </span><span class="token token property">"references"</span><span class="token token operator">:</span><span> </span><span class="token token punctuation">{</span><span> </span><span class="token token" style="color:#51763e">"any"</span><span> </span><span class="token token punctuation">}</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"guid"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"created"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"modified"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"modified_by"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"alerted"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"deactivated"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"is_active"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"boolean"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"is_alert"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"boolean"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"organization_guid"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"group_guid"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"name"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"event"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"url"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"status"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"oauth_url"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"client_id"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"client_secret"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"fetch_tags"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"boolean"</span><span> </span><span></span><span class="token token punctuation">}</span></code></pre></div></div></div></div></div><div class="MethodDetail_methodContainer__3EF7h" id="getWebhook"><div class="MethodDetail_method__fyEiw"><div><h3 class="MethodHeader_h3__seOfC">Retrieve Webhook</h3><h4 class="MethodHeader_description__3_p_p"><div class="MethodHeader_iconStyle__x5Ow4"><svg viewbox="0 0 14 6" xmlns="http://www.w3.org/2000/svg" class="IconRest_restIcon__3pju8 get"><title>Get</title><path d="M2.587 6c.307 0 .607-.044.9-.132.295-.088.533-.217.716-.387V2.876H2.271v.825h1.027v1.145a.772.772 0 0 1-.239.1 1.4 1.4 0 0 1-.383.049 1.338 1.338 0 0 1-1.083-.52c-.135-.17-.24-.379-.316-.626a2.879 2.879 0 0 1-.113-.84c0-.352.038-.655.113-.907.076-.253.182-.46.32-.623.137-.162.3-.281.488-.358a1.783 1.783 0 0 1 .97-.082l.13.032v.915h.889V.28a3.182 3.182 0 0 0-.59-.202A3.507 3.507 0 0 0 2.676 0c-.313 0-.628.055-.946.165a2.4 2.4 0 0 0-.861.523 2.707 2.707 0 0 0-.627.92C.081 1.98 0 2.433 0 2.966c0 .506.067.946.202 1.323.135.376.318.692.55.948a2.2 2.2 0 0 0 .82.572A2.7 2.7 0 0 0 2.587 6Zm6.24-.115V4.879H6.184V3.47h2.4V2.465h-2.4V1.121h2.602V.115h-3.71v5.77h3.75Zm4.43 0v-.907h-.914V1.022h.768v.997H14V.115H9.57V2.02h.89v-.997h.776v3.956h-.922v.907h2.942Z"></path></svg></div> /v4/webhooks/{webhook_guid}</h4><p class="MethodHeader_description__3_p_p">Returns a webhook.</p></div><div><h4 class="ParameterList_h4__nH9G8 ParameterList_dividing__wRGRx">Path Parameters</h4><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">webhook_guid</span><span class="Parameter_type__djM_s">string</span><span class="Parameter_required__pcK_H">Required</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">A GUID for a Bitly webhook</div></div></div></div><div class="MethodDetail_examples__8nXeM"><div><label class="CodeSyntaxSelector_header__6P_Jc CodeSyntaxSelector_headerDark__hI3A0"><span>Request</span><div class="Select_wrapper__58utF Select_dark__KPIws"><select class="Select_select__qXz_Z Select_dark__KPIws" aria-label="Select" autocomplete="off"><option value="cURL" selected="">cURL</option><option value="Node">Node</option><option value="Browser">Browser</option><option value="Go">Go</option><option value="Python">Python</option></select><svg viewbox="0 0 8 14" xmlns="http://www.w3.org/2000/svg"><path d="M6.463 7 .987 1.66a.61.61 0 0 1 0-.878.648.648 0 0 1 .9 0L7.813 6.56a.61.61 0 0 1 0 .878l-5.926 5.78a.648.648 0 0 1-.9 0 .61.61 0 0 1 0-.879L6.463 7Z"></path></svg></div></label><div class="CodeSyntaxSelector_body__hBJ7j CodeSyntaxSelector_bodyDark__cizVw" tabindex="0"><div class="CodeBlock_codeBlock__KlURa"><pre tabindex="0" style="color:#ffffff;font-family:ProximaNova, monospace;line-height:1.2;font-size:1rem"><code class="language-bash" style="white-space:pre"><span class="token token" style="color:#ee6123">curl</span><span> </span><span class="token token punctuation">\</span><span> </span><span>-H </span><span class="token token" style="color:#acda95">'Authorization: Bearer {TOKEN}'</span><span> </span><span class="token token punctuation">\</span><span> </span><span>-X GET </span><span class="token token punctuation">\</span><span> </span>https://api-ssl.bitly.com/v4/webhooks/Wa1bcDefG23</code></pre></div></div></div><div><label class="CodeSyntaxSelector_header__6P_Jc"><span>Response</span><div class="Select_wrapper__58utF"><select class="Select_select__qXz_Z" aria-label="Select" autocomplete="off"><option value="200" selected="">200 SUCCESS</option><option value="400">400 BAD_REQUEST</option><option value="402">402 UPGRADE_REQUIRED</option><option value="403">403 FORBIDDEN</option><option value="404">404 NOT_FOUND</option><option value="500">500 INTERNAL_ERROR</option><option value="503">503 TEMPORARILY_UNAVAILABLE</option></select><svg viewbox="0 0 8 14" xmlns="http://www.w3.org/2000/svg"><path d="M6.463 7 .987 1.66a.61.61 0 0 1 0-.878.648.648 0 0 1 .9 0L7.813 6.56a.61.61 0 0 1 0 .878l-5.926 5.78a.648.648 0 0 1-.9 0 .61.61 0 0 1 0-.879L6.463 7Z"></path></svg></div></label><div class="CodeSyntaxSelector_body__hBJ7j" tabindex="0"><div class="CodeBlock_codeBlock__KlURa"><pre tabindex="0" style="color:#36383b;font-family:ProximaNova, monospace;line-height:1.2;font-size:1rem"><code class="language-json" style="white-space:pre"><span class="token token punctuation">{</span><span> </span><span> </span><span class="token token property">"references"</span><span class="token token operator">:</span><span> </span><span class="token token punctuation">{</span><span> </span><span class="token token" style="color:#51763e">"any"</span><span> </span><span class="token token punctuation">}</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"guid"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"created"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"modified"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"modified_by"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"alerted"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"deactivated"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"is_active"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"boolean"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"is_alert"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"boolean"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"organization_guid"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"group_guid"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"name"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"event"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"url"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"status"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"oauth_url"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"client_id"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"client_secret"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"fetch_tags"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"boolean"</span><span> </span><span></span><span class="token token punctuation">}</span></code></pre></div></div></div></div></div><div class="MethodDetail_methodContainer__3EF7h" id="updateWebhook"><div class="MethodDetail_method__fyEiw"><div><h3 class="MethodHeader_h3__seOfC">Update Webhook</h3><h4 class="MethodHeader_description__3_p_p"><div class="MethodHeader_iconStyle__x5Ow4"><svg viewbox="0 0 23 6" xmlns="http://www.w3.org/2000/svg" class="IconRest_restIcon__3pju8 patch"><title>Patch</title><path d="M1.095 5.885V3.898c.027.006.07.011.132.017a4.052 4.052 0 0 0 .372.016h.128c.277 0 .545-.037.803-.11.259-.075.49-.193.692-.355.202-.162.365-.368.487-.618.123-.25.184-.551.184-.903 0-.401-.07-.727-.212-.977a1.606 1.606 0 0 0-.547-.585 2.041 2.041 0 0 0-.756-.28 5.067 5.067 0 0 0-.835-.07c-.267 0-.534.012-.804.037C.47.095.224.13 0 .173v5.712h1.095Zm.472-2.934h-.1a2.448 2.448 0 0 1-.276-.017.853.853 0 0 1-.096-.016V1.047c.059-.011.136-.02.232-.03.096-.007.197-.012.304-.012.138 0 .274.014.408.042a.964.964 0 0 1 .355.148.801.801 0 0 1 .252.284.937.937 0 0 1 .096.45c0 .214-.033.387-.1.519a.787.787 0 0 1-.268.309 1.038 1.038 0 0 1-.38.152 2.235 2.235 0 0 1-.427.042Zm3.79 2.934.383-1.278h1.67l.4 1.278h1.152L7.163.115H6.068L4.26 5.885h1.095ZM7.194 3.7h-1.2l.56-1.929h.072l.568 1.929Zm5.668 2.184v-.907h-.903V1.022h.76v.997h.879V.115H9.218V2.02h.879v-.997h.767v3.956h-.91v.907h2.91Zm3.91.115c.276 0 .547-.036.81-.107.265-.072.482-.17.652-.297V3.948h-.88v.997c-.164.033-.335.05-.51.05-.246 0-.464-.049-.656-.145a1.383 1.383 0 0 1-.488-.408 1.881 1.881 0 0 1-.304-.63A2.973 2.973 0 0 1 15.293 3c0-.34.038-.636.112-.886.075-.25.179-.457.312-.622.133-.165.29-.287.468-.367.178-.08.371-.12.58-.12.175 0 .346.014.511.042v.94h.88V.271a2.727 2.727 0 0 0-.548-.19A3.419 3.419 0 0 0 16.796 0c-.303 0-.613.05-.927.152-.314.102-.6.27-.855.503a2.611 2.611 0 0 0-.628.923c-.163.382-.244.856-.244 1.422 0 .544.072 1.007.216 1.389.144.382.336.692.576.931.24.24.518.412.835.52.317.106.652.16 1.003.16Zm3.325-.115V3.47h1.807v2.415H23V.115h-1.095v2.35h-1.807V.114h-1.095v5.77h1.095Z"></path></svg></div> /v4/webhooks/{webhook_guid}</h4><p class="MethodHeader_description__3_p_p">Update a webhook</p></div><div><h4 class="ParameterList_h4__nH9G8 ParameterList_dividing__wRGRx">Path Parameters</h4><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">webhook_guid</span><span class="Parameter_type__djM_s">string</span><span class="Parameter_required__pcK_H">Required</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">A GUID for a Bitly webhook</div></div></div><div><h4 class="ParameterList_h4__nH9G8 ParameterList_dividing__wRGRx">Request Body Schema</h4><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">guid</span><span class="Parameter_type__djM_s">string</span><span class="Parameter_required__pcK_H">Required</span></div></div><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">is_active</span><span class="Parameter_type__djM_s">boolean</span></div></div><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">organization_guid</span><span class="Parameter_type__djM_s">string</span></div></div><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">group_guid</span><span class="Parameter_type__djM_s">string</span></div></div><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">name</span><span class="Parameter_type__djM_s">string</span></div></div><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">event</span><span class="Parameter_type__djM_s">string</span></div></div><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">url</span><span class="Parameter_type__djM_s">string</span></div></div><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">oauth_url</span><span class="Parameter_type__djM_s">string</span></div></div><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">client_id</span><span class="Parameter_type__djM_s">string</span></div></div><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">client_secret</span><span class="Parameter_type__djM_s">string</span></div></div><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">fetch_tags</span><span class="Parameter_type__djM_s">boolean</span></div></div></div></div><div class="MethodDetail_examples__8nXeM"><div><label class="CodeSyntaxSelector_header__6P_Jc CodeSyntaxSelector_headerDark__hI3A0"><span>Request</span><div class="Select_wrapper__58utF Select_dark__KPIws"><select class="Select_select__qXz_Z Select_dark__KPIws" aria-label="Select" autocomplete="off"><option value="cURL" selected="">cURL</option><option value="Node">Node</option><option value="Browser">Browser</option><option value="Go">Go</option><option value="Python">Python</option></select><svg viewbox="0 0 8 14" xmlns="http://www.w3.org/2000/svg"><path d="M6.463 7 .987 1.66a.61.61 0 0 1 0-.878.648.648 0 0 1 .9 0L7.813 6.56a.61.61 0 0 1 0 .878l-5.926 5.78a.648.648 0 0 1-.9 0 .61.61 0 0 1 0-.879L6.463 7Z"></path></svg></div></label><div class="CodeSyntaxSelector_body__hBJ7j CodeSyntaxSelector_bodyDark__cizVw" tabindex="0"><div class="CodeBlock_codeBlock__KlURa"><pre tabindex="0" style="color:#ffffff;font-family:ProximaNova, monospace;line-height:1.2;font-size:1rem"><code class="language-bash" style="white-space:pre"><span class="token token" style="color:#ee6123">curl</span><span> </span><span class="token token punctuation">\</span><span> </span><span>-H </span><span class="token token" style="color:#acda95">'Authorization: Bearer {TOKEN}'</span><span> </span><span class="token token punctuation">\</span><span> </span><span>-H </span><span class="token token" style="color:#acda95">'Content-Type: application/json'</span><span> </span><span class="token token punctuation">\</span><span> </span><span>-X PATCH </span><span class="token token punctuation">\</span><span> </span><span>-d </span><span class="token token" style="color:#acda95">'{ </span><span class="token token" style="color:#acda95"> "guid": "Wa1bcDefG23", </span><span class="token token" style="color:#acda95"> "is_active": true, </span><span class="token token" style="color:#acda95"> "organization_guid": "Oa1bcd234eF", </span><span class="token token" style="color:#acda95"> "group_guid": "Ba1bc23dE4F", </span><span class="token token" style="color:#acda95"> "name": "My Webhook", </span><span class="token token" style="color:#acda95"> "event": "decodes", </span><span class="token token" style="color:#acda95"> "url": "https://bitly.com/webhooks", </span><span class="token token" style="color:#acda95"> "oauth_url": "https://fake.com/oauth", </span><span class="token token" style="color:#acda95"> "client_id": "fakeclientid123", </span><span class="token token" style="color:#acda95"> "client_secret": "itsasecreticanttellyou" </span><span class="token token" style="color:#acda95">}'</span><span> </span><span class="token token punctuation">\</span><span> </span>https://api-ssl.bitly.com/v4/webhooks/Wa1bcDefG23</code></pre></div></div></div><div><label class="CodeSyntaxSelector_header__6P_Jc"><span>Response</span><div class="Select_wrapper__58utF"><select class="Select_select__qXz_Z" aria-label="Select" autocomplete="off"><option value="200" selected="">200 SUCCESS</option><option value="400">400 BAD_REQUEST</option><option value="402">402 UPGRADE_REQUIRED</option><option value="403">403 FORBIDDEN</option><option value="404">404 NOT_FOUND</option><option value="422">422 UNPROCESSABLE_ENTITY</option><option value="500">500 INTERNAL_ERROR</option><option value="503">503 TEMPORARILY_UNAVAILABLE</option></select><svg viewbox="0 0 8 14" xmlns="http://www.w3.org/2000/svg"><path d="M6.463 7 .987 1.66a.61.61 0 0 1 0-.878.648.648 0 0 1 .9 0L7.813 6.56a.61.61 0 0 1 0 .878l-5.926 5.78a.648.648 0 0 1-.9 0 .61.61 0 0 1 0-.879L6.463 7Z"></path></svg></div></label><div class="CodeSyntaxSelector_body__hBJ7j" tabindex="0"><div class="CodeBlock_codeBlock__KlURa"><pre tabindex="0" style="color:#36383b;font-family:ProximaNova, monospace;line-height:1.2;font-size:1rem"><code class="language-json" style="white-space:pre"><span class="token token punctuation">{</span><span> </span><span> </span><span class="token token property">"references"</span><span class="token token operator">:</span><span> </span><span class="token token punctuation">{</span><span> </span><span class="token token" style="color:#51763e">"any"</span><span> </span><span class="token token punctuation">}</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"guid"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"created"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"modified"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"modified_by"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"alerted"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"deactivated"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"is_active"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"boolean"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"is_alert"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"boolean"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"organization_guid"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"group_guid"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"name"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"event"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"url"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"status"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"oauth_url"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"client_id"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"client_secret"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"fetch_tags"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"boolean"</span><span> </span><span></span><span class="token token punctuation">}</span></code></pre></div></div></div></div></div><div class="MethodDetail_methodContainer__3EF7h" id="deleteWebhook"><div class="MethodDetail_method__fyEiw"><div><h3 class="MethodHeader_h3__seOfC">Delete Webhook</h3><h4 class="MethodHeader_description__3_p_p"><div class="MethodHeader_iconStyle__x5Ow4"><svg viewbox="0 0 28 6" xmlns="http://www.w3.org/2000/svg" class="IconRest_restIcon__3pju8 delete"><title>Delete</title><path d="M1.439 6c.54 0 .984-.087 1.33-.262.345-.175.616-.405.811-.69.196-.287.331-.612.406-.979.075-.366.113-.74.113-1.123 0-.422-.038-.811-.113-1.17a2.419 2.419 0 0 0-.398-.931 1.918 1.918 0 0 0-.775-.62C2.486.075 2.073 0 1.575 0c-.128 0-.274.003-.438.008C.974.014.816.021.663.03A11.118 11.118 0 0 0 0 .083v5.834c.07.01.169.02.297.029L.7 5.97c.14.008.276.015.41.02.134.006.244.009.33.009Zm.128-1.015c-.027 0-.061-.002-.104-.004a35.064 35.064 0 0 0-.133-.009l-.067-.004-.066-.004a.56.56 0 0 1-.096-.013V1.05c.048-.006.12-.013.217-.021.096-.009.196-.013.297-.013.306 0 .547.061.724.183.176.122.31.278.398.466.088.189.144.397.168.624a6.241 6.241 0 0 1-.004 1.39 2.07 2.07 0 0 1-.177.658c-.09.194-.229.35-.413.47-.185.12-.433.179-.744.179Zm7.145.923V4.893H6.084V3.47H8.47V2.455H6.084V1.098h2.588V.083h-3.69v5.825h3.73Zm4.854 0V3.537h-.997v1.356H10.97V.083h-1.1v5.825h3.696Zm4.79 0V4.893h-2.628V3.47h2.387V2.455h-2.387V1.098h2.588V.083h-3.69v5.825h3.73Zm4.404 0v-.915h-.908V1h.763v1.007h.884V.083h-4.404v1.923h.884V.999h.772v3.994h-.916v.915h2.925Zm5.24 0V4.893h-2.628V3.47h2.387V2.455h-2.387V1.098h2.588V.083H24.27v5.825H28Z"></path></svg></div> /v4/webhooks/{webhook_guid}</h4><p class="MethodHeader_description__3_p_p">Deletes a webhook.</p></div><div><h4 class="ParameterList_h4__nH9G8 ParameterList_dividing__wRGRx">Path Parameters</h4><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">webhook_guid</span><span class="Parameter_type__djM_s">string</span><span class="Parameter_required__pcK_H">Required</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">A GUID for a Bitly webhook</div></div></div></div><div class="MethodDetail_examples__8nXeM"><div><label class="CodeSyntaxSelector_header__6P_Jc CodeSyntaxSelector_headerDark__hI3A0"><span>Request</span><div class="Select_wrapper__58utF Select_dark__KPIws"><select class="Select_select__qXz_Z Select_dark__KPIws" aria-label="Select" autocomplete="off"><option value="cURL" selected="">cURL</option><option value="Node">Node</option><option value="Browser">Browser</option><option value="Go">Go</option><option value="Python">Python</option></select><svg viewbox="0 0 8 14" xmlns="http://www.w3.org/2000/svg"><path d="M6.463 7 .987 1.66a.61.61 0 0 1 0-.878.648.648 0 0 1 .9 0L7.813 6.56a.61.61 0 0 1 0 .878l-5.926 5.78a.648.648 0 0 1-.9 0 .61.61 0 0 1 0-.879L6.463 7Z"></path></svg></div></label><div class="CodeSyntaxSelector_body__hBJ7j CodeSyntaxSelector_bodyDark__cizVw" tabindex="0"><div class="CodeBlock_codeBlock__KlURa"><pre tabindex="0" style="color:#ffffff;font-family:ProximaNova, monospace;line-height:1.2;font-size:1rem"><code class="language-bash" style="white-space:pre"><span class="token token" style="color:#ee6123">curl</span><span> </span><span class="token token punctuation">\</span><span> </span><span>-H </span><span class="token token" style="color:#acda95">'Authorization: Bearer {TOKEN}'</span><span> </span><span class="token token punctuation">\</span><span> </span><span>-X DELETE </span><span class="token token punctuation">\</span><span> </span>https://api-ssl.bitly.com/v4/webhooks/Wa1bcDefG23</code></pre></div></div></div><div><label class="CodeSyntaxSelector_header__6P_Jc"><span>Response</span><div class="Select_wrapper__58utF"><select class="Select_select__qXz_Z" aria-label="Select" autocomplete="off"><option value="204" selected="">204 SUCCESS</option><option value="400">400 BAD_REQUEST</option><option value="402">402 UPGRADE_REQUIRED</option><option value="403">403 FORBIDDEN</option><option value="404">404 NOT_FOUND</option><option value="500">500 INTERNAL_ERROR</option><option value="503">503 TEMPORARILY_UNAVAILABLE</option></select><svg viewbox="0 0 8 14" xmlns="http://www.w3.org/2000/svg"><path d="M6.463 7 .987 1.66a.61.61 0 0 1 0-.878.648.648 0 0 1 .9 0L7.813 6.56a.61.61 0 0 1 0 .878l-5.926 5.78a.648.648 0 0 1-.9 0 .61.61 0 0 1 0-.879L6.463 7Z"></path></svg></div></label><div class="CodeSyntaxSelector_body__hBJ7j" tabindex="0"></div></div></div></div><div class="MethodDetail_methodContainer__3EF7h" id="verifyWebhook"><div class="MethodDetail_method__fyEiw"><div><h3 class="MethodHeader_h3__seOfC">Verify Webhook</h3><h4 class="MethodHeader_description__3_p_p"><div class="MethodHeader_iconStyle__x5Ow4"><svg viewbox="0 0 18 6" xmlns="http://www.w3.org/2000/svg" class="IconRest_restIcon__3pju8 post"><title>Post</title><path d="M1.072 5.885V3.898c.026.006.069.011.129.017a3.88 3.88 0 0 0 .364.016h.125c.27 0 .533-.037.786-.11.253-.075.478-.193.677-.355.198-.162.357-.368.477-.618s.18-.551.18-.903c0-.401-.07-.727-.208-.977a1.592 1.592 0 0 0-.536-.585 1.971 1.971 0 0 0-.739-.28 4.854 4.854 0 0 0-.817-.07C1.249.033.987.045.724.07.46.095.219.13 0 .173v5.712h1.072Zm.461-2.934h-.098a2.344 2.344 0 0 1-.27-.017.818.818 0 0 1-.093-.016V1.047c.057-.011.133-.02.227-.03.093-.007.193-.012.297-.012.135 0 .268.014.399.042.13.027.246.077.348.148a.796.796 0 0 1 .246.284.954.954 0 0 1 .094.45c0 .214-.032.387-.098.519a.782.782 0 0 1-.262.309c-.11.074-.233.125-.371.152a2.141 2.141 0 0 1-.419.042ZM6.47 6c.694 0 1.212-.265 1.553-.795.342-.53.513-1.265.513-2.205 0-.44-.038-.843-.114-1.212a2.872 2.872 0 0 0-.36-.947 1.78 1.78 0 0 0-.637-.618C7.163.074 6.844 0 6.469 0c-.35 0-.653.069-.911.206a1.78 1.78 0 0 0-.645.59c-.172.255-.3.57-.384.943A5.804 5.804 0 0 0 4.404 3c0 .44.037.843.11 1.212.073.368.191.684.356.947.164.264.378.47.641.618.263.149.583.223.958.223Zm0-1.005c-.203 0-.366-.053-.489-.157a.989.989 0 0 1-.281-.425 2.57 2.57 0 0 1-.133-.63A8.129 8.129 0 0 1 5.53 3c0-.66.065-1.157.195-1.492.13-.335.378-.503.743-.503.209 0 .376.054.501.161a1 1 0 0 1 .286.433c.065.181.106.393.125.635.018.241.027.497.027.766 0 .34-.014.636-.043.886-.029.25-.08.457-.152.622a.826.826 0 0 1-.29.367.803.803 0 0 1-.454.12ZM10.991 6c.297 0 .574-.037.83-.111.255-.074.476-.187.664-.338.188-.151.334-.338.438-.56.104-.223.157-.483.157-.78 0-.307-.067-.563-.2-.766a1.814 1.814 0 0 0-.493-.507 3.3 3.3 0 0 0-.641-.342 11.165 11.165 0 0 1-.642-.28 2.185 2.185 0 0 1-.493-.313.562.562 0 0 1-.199-.445c0-.176.072-.316.215-.42.144-.105.34-.157.59-.157a2.757 2.757 0 0 1 .767.107.14.14 0 0 0 .047.008v.915h.86V.338a2.45 2.45 0 0 0-.735-.247C11.85.03 11.536 0 11.218 0c-.282 0-.537.041-.767.124-.23.082-.426.197-.59.346A1.557 1.557 0 0 0 9.476 1a1.66 1.66 0 0 0-.137.68c0 .324.067.588.2.792.133.203.297.372.493.506.195.135.409.246.641.334.232.088.446.176.642.264.195.088.36.19.492.305.133.115.2.266.2.453 0 .209-.081.375-.243.499-.161.123-.388.185-.68.185-.162 0-.314-.018-.458-.053a2.256 2.256 0 0 1-.395-.136l-.047-.017v-.816h-.86V5.53c.067.039.156.085.266.14.11.055.236.107.379.157.143.05.3.09.47.124.169.033.353.049.55.049Zm6.29-.115v-.907h-.885V1.022h.744v.997H18V.115h-4.287V2.02h.86v-.997h.752v3.956h-.892v.907h2.847Z"></path></svg></div> /v4/webhooks/{webhook_guid}/verify</h4><p class="MethodHeader_description__3_p_p">Sends ping event to test webhook configuration.</p></div><div><h4 class="ParameterList_h4__nH9G8 ParameterList_dividing__wRGRx">Path Parameters</h4><div class="Parameter_parameter__J0LgW"><div><span class="Parameter_name___UYgz">webhook_guid</span><span class="Parameter_type__djM_s">string</span><span class="Parameter_required__pcK_H">Required</span></div><div class="Parameter_description__tZj_3 Parameter_spacer__JKXbH">A GUID for a Bitly webhook</div></div></div></div><div class="MethodDetail_examples__8nXeM"><div><label class="CodeSyntaxSelector_header__6P_Jc CodeSyntaxSelector_headerDark__hI3A0"><span>Request</span><div class="Select_wrapper__58utF Select_dark__KPIws"><select class="Select_select__qXz_Z Select_dark__KPIws" aria-label="Select" autocomplete="off"><option value="cURL" selected="">cURL</option><option value="Node">Node</option><option value="Browser">Browser</option><option value="Go">Go</option><option value="Python">Python</option></select><svg viewbox="0 0 8 14" xmlns="http://www.w3.org/2000/svg"><path d="M6.463 7 .987 1.66a.61.61 0 0 1 0-.878.648.648 0 0 1 .9 0L7.813 6.56a.61.61 0 0 1 0 .878l-5.926 5.78a.648.648 0 0 1-.9 0 .61.61 0 0 1 0-.879L6.463 7Z"></path></svg></div></label><div class="CodeSyntaxSelector_body__hBJ7j CodeSyntaxSelector_bodyDark__cizVw" tabindex="0"><div class="CodeBlock_codeBlock__KlURa"><pre tabindex="0" style="color:#ffffff;font-family:ProximaNova, monospace;line-height:1.2;font-size:1rem"><code class="language-bash" style="white-space:pre"><span class="token token" style="color:#ee6123">curl</span><span> </span><span class="token token punctuation">\</span><span> </span><span>-H </span><span class="token token" style="color:#acda95">'Authorization: Bearer {TOKEN}'</span><span> </span><span class="token token punctuation">\</span><span> </span><span>-X POST </span><span class="token token punctuation">\</span><span> </span>https://api-ssl.bitly.com/v4/webhooks/Wa1bcDefG23/verify</code></pre></div></div></div><div><label class="CodeSyntaxSelector_header__6P_Jc"><span>Response</span><div class="Select_wrapper__58utF"><select class="Select_select__qXz_Z" aria-label="Select" autocomplete="off"><option value="200" selected="">200 SUCCESS</option><option value="400">400 BAD_REQUEST</option><option value="402">402 UPGRADE_REQUIRED</option><option value="403">403 FORBIDDEN</option><option value="404">404 NOT_FOUND</option><option value="500">500 INTERNAL_ERROR</option><option value="503">503 TEMPORARILY_UNAVAILABLE</option></select><svg viewbox="0 0 8 14" xmlns="http://www.w3.org/2000/svg"><path d="M6.463 7 .987 1.66a.61.61 0 0 1 0-.878.648.648 0 0 1 .9 0L7.813 6.56a.61.61 0 0 1 0 .878l-5.926 5.78a.648.648 0 0 1-.9 0 .61.61 0 0 1 0-.879L6.463 7Z"></path></svg></div></label><div class="CodeSyntaxSelector_body__hBJ7j" tabindex="0"><div class="CodeBlock_codeBlock__KlURa"><pre tabindex="0" style="color:#36383b;font-family:ProximaNova, monospace;line-height:1.2;font-size:1rem"><code class="language-json" style="white-space:pre"><span class="token token punctuation">{</span><span> </span><span> </span><span class="token token property">"references"</span><span class="token token operator">:</span><span> </span><span class="token token punctuation">{</span><span> </span><span class="token token" style="color:#51763e">"any"</span><span> </span><span class="token token punctuation">}</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"guid"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"created"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"modified"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"modified_by"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"alerted"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"deactivated"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"is_active"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"boolean"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"is_alert"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"boolean"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"organization_guid"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"group_guid"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"name"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"event"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"url"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"status"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"oauth_url"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"client_id"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"client_secret"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"string"</span><span class="token token punctuation">,</span><span> </span><span> </span><span class="token token property">"fetch_tags"</span><span class="token token operator">:</span><span> </span><span class="token token" style="color:#51763e">"boolean"</span><span> </span><span></span><span class="token token punctuation">}</span></code></pre></div></div></div></div></div></div><footer><div class="Footer_footer__7PvU2"><div class="Footer_row__1ruA0"><div class="Footer_title__Ct_v_">Resources</div><a target="_blank" rel="noopener noreferrer" href="https://web.archive.org/web/20221001011007/https://bitly.com/blog/" class="Footer_link__V8hyW">Blog</a><a target="_blank" rel="noopener noreferrer" href="https://web.archive.org/web/20221001011007/https://bitly.com/pages/resources/" class="Footer_link__V8hyW">Webinar and Ebooks</a></div><div class="Footer_row__1ruA0"><div class="Footer_title__Ct_v_">Legal</div><a target="_blank" rel="noopener noreferrer" href="https://web.archive.org/web/20221001011007/https://bitly.com/pages/privacy/" class="Footer_link__V8hyW">Privacy Policy</a><a target="_blank" rel="noopener noreferrer" href="https://web.archive.org/web/20221001011007/https://bitly.com/pages/terms-of-service/" class="Footer_link__V8hyW">Terms of Service</a></div><div class="Footer_row__1ruA0"><div class="Footer_title__Ct_v_">Company</div><a target="_blank" rel="noopener noreferrer" href="https://web.archive.org/web/20221001011007/https://bitly.com/pages/careers/" class="Footer_link__V8hyW">Careers</a><a target="_blank" rel="noopener noreferrer" href="https://web.archive.org/web/20221001011007/mailto:api@bit.ly" class="Footer_link__V8hyW">Contact</a></div><div class="Footer_row__1ruA0"><svg xmlns="http://www.w3.org/2000/svg" viewbox="-1376 546.6 90 45" xml:space="preserve"><title>Bitly</title><path d="M-1329.1 577c-4.5 0-7-2.7-7-6 0-1.3.1-11.4.1-11.4-1.5 0-2.2-.8-2.2-1.7 0-1 .8-1.9 2-1.9v-4.7c0-1.6 1.2-2.9 2.8-2.9 1.6 0 2.8 1.3 2.8 2.9 0 1.2-.1 2.8-.1 4.7h2.9c1.5 0 2.2.8 2.2 1.9 0 1.1-.8 1.8-1.9 1.8h-3.2c-.1 3.2-.2 7.1-.2 10.1 0 1.1.8 2.4 2.6 2.4 4.3 0 5.5-4.3 5.5-12.4 0-1.1.9-1.9 1.9-1.9 1.1 0 1.9.8 1.9 1.9.1 10.7-2.5 17.2-10.1 17.2"></path><path d="M-1310.9 560.5s1.8-1.2 2.9-1.2c1.1 0 .9.2.9 1.3 0 11.6-2.1 16.5-9.6 16.5-3.3 0-6.3-2.4-6.3-5.4 0-1.2.2-3.5.2-4.6 0-11.2-.2-13.5-.2-16.8 0-1.6 1.3-3 2.9-3 1.6 0 2.8 1.3 2.8 2.9 0 3.3-.4 8-.5 20.4 0 1 .5 1.8 1.8 1.8 4.3-.2 4.9-5.1 5.1-11.9"></path><path d="M-1297.3 575s-1.6 2.1-5.6 2c-5.3-.1-7.7-4.3-8-8.6-.2-3.3-.1-5.1-.1-7.3 0-1.6 1.1-2.9 2.6-2.9 1.6 0 2.5 1.3 2.5 2.9 0 2.1-.1 3.5-.2 5.9 0 2.8.9 5.3 3.2 5.2 2.2 0 4.7-.9 4.7-5.7v-5.4c0-1.6 1.1-2.9 2.7-2.9s2.7 1.3 2.7 2.9c0 2.1-.2 3.8-.2 7.1 0 0-.1 6.6.1 8.1.7-.2 1.8-1 2.9-2.7.7-1 2-1.3 2.7-.8 1.1.6 1.1 1.9.6 2.8-1.1 2.3-2.4 3.8-5.9 5 0 4-.3 9.8-7.6 10.9-6.3.9-9.1-2.7-9.1-5.8 0-4.9 4.9-6.3 11.9-8.1l.1-2.6zm.6 6.4c-3.6.8-8 1.9-8 4.1 0 2.1 2.2 2.4 4 2.1 3.7-.8 4.1-3 4-6.2zM-1347.6 571.6c0-1.3-.2-12.2-.2-12.2 0-1.6 1-2.9 2.6-2.9s2.6 1.4 2.6 2.9c-.2 5.1-.3 8.4-.3 10.2 0 1 .6 2.6 2.2 2.6 3.8 0 4.6-3.5 4.6-12.1 0-1.1 1.1-1.9 2.2-1.9s1.9.8 1.9 1.9c0 13-2.3 16.9-9.6 16.9-2.8 0-6-1.9-6-5.4"></path><path d="M-1345.8 557.5c-1.1 0-1.1.2-1.8 1.3 0 4.8-1.2 10.7-6.6 12.9 3.8-8-.1-15.3-6.4-15.3-3 0-4.9 1.1-6.1 2.1 0-2.3.1-6.4.1-6.4 0-2.9-1-5.1-4.5-5.2-2 0-3.5.9-4.5 3-.3.8-.2 1.6.5 2 .6.3 1.5.1 1.9-.5.3-.4.5-.5.7-.4.4 0 .4.7.5 1.2 0 .3.3 5.1.2 17.7 0 3.5 2.7 7.5 9.3 7.5 13 0 18.6-4.8 18.6-17.7-.3-1.2-.9-2.2-1.9-2.2zm-16.9 14.9c-2.5 0-4.2-.7-4.3-2.9v-2.2c.2-3.1 2.4-5.4 4.6-5.8 2.7-.5 4.5.7 4.5 4.2-.1 2.4-.8 6.6-4.8 6.7zM-1345.1 548.4c1.6 0 2.9 1.3 2.9 2.9s-1.3 2.9-2.9 2.9c-1.6 0-2.9-1.3-2.9-2.9s1.3-2.9 2.9-2.9"></path></svg><div class="Footer_description__eC8la">漏 2022 Bitly</div><div class="Footer_description__eC8la">Handmade in NYC, San Francisco, Denver, and all over the world.</div><div class="Footer_socialIcons__dFxBT"><a href="https://web.archive.org/web/20221001011007/https://twitter.com/bitly" target="_blank" rel="noopener noreferrer"><svg width="24" height="20" xmlns="http://www.w3.org/2000/svg"><title>Twitter</title><path d="M23.953 2.382c-.885.399-1.83.67-2.825.794A5.063 5.063 0 0 0 23.291.384a10.01 10.01 0 0 1-3.127 1.214A4.844 4.844 0 0 0 16.574 0c-2.718 0-4.92 2.259-4.92 5.041 0 .4.045.785.127 1.153C7.69 5.996 4.066 3.982 1.64.938a5.04 5.04 0 0 0-.666 2.538 5.08 5.08 0 0 0 2.188 4.2 4.812 4.812 0 0 1-2.228-.632v.062c0 2.445 1.693 4.485 3.946 4.95a4.88 4.88 0 0 1-2.212.086c.63 2.003 2.445 3.463 4.604 3.504A9.714 9.714 0 0 1 0 17.736 13.745 13.745 0 0 0 7.557 20c9.053 0 13.998-7.685 13.998-14.34 0-.214 0-.43-.015-.645.961-.707 1.8-1.6 2.46-2.613l-.047-.02Z" fill="#121314"></path></svg></a><a href="https://web.archive.org/web/20221001011007/https://www.instagram.com/bitly/" target="_blank" rel="noopener noreferrer"><svg width="24" height="24" xmlns="http://www.w3.org/2000/svg"><title>Instagram</title><path d="M12 0C8.74 0 8.333.015 7.053.072 5.775.132 4.905.333 4.14.63a5.876 5.876 0 0 0-2.126 1.384A5.855 5.855 0 0 0 .63 4.14C.333 4.905.131 5.775.072 7.053.012 8.333 0 8.74 0 12s.015 3.667.072 4.947c.06 1.277.261 2.148.558 2.913a5.885 5.885 0 0 0 1.384 2.126A5.868 5.868 0 0 0 4.14 23.37c.766.296 1.636.499 2.913.558C8.333 23.988 8.74 24 12 24s3.667-.015 4.947-.072c1.277-.06 2.148-.262 2.913-.558a5.898 5.898 0 0 0 2.126-1.384 5.86 5.86 0 0 0 1.384-2.126c.296-.765.499-1.636.558-2.913.06-1.28.072-1.687.072-4.947s-.015-3.667-.072-4.947c-.06-1.277-.262-2.149-.558-2.913a5.89 5.89 0 0 0-1.384-2.126A5.847 5.847 0 0 0 19.86.63c-.765-.297-1.636-.499-2.913-.558C15.667.012 15.26 0 12 0Zm0 2.16c3.203 0 3.585.016 4.85.071 1.17.055 1.805.249 2.227.415.562.217.96.477 1.382.896.419.42.679.819.896 1.381.164.422.36 1.057.413 2.227.057 1.266.07 1.646.07 4.85 0 3.204-.015 3.585-.074 4.85-.061 1.17-.256 1.805-.421 2.227a3.81 3.81 0 0 1-.899 1.382 3.744 3.744 0 0 1-1.38.896c-.42.164-1.065.36-2.235.413-1.274.057-1.649.07-4.859.07-3.211 0-3.586-.015-4.859-.074-1.171-.061-1.816-.256-2.236-.421a3.716 3.716 0 0 1-1.379-.899 3.644 3.644 0 0 1-.9-1.38c-.165-.42-.359-1.065-.42-2.235-.045-1.26-.061-1.649-.061-4.844 0-3.196.016-3.586.061-4.861.061-1.17.255-1.814.42-2.234.21-.57.479-.96.9-1.381.419-.419.81-.689 1.379-.898.42-.166 1.051-.361 2.221-.421 1.275-.045 1.65-.06 4.859-.06l.045.03Zm0 3.678a6.162 6.162 0 1 0 0 12.324 6.162 6.162 0 1 0 0-12.324ZM12 16c-2.21 0-4-1.79-4-4s1.79-4 4-4 4 1.79 4 4-1.79 4-4 4Zm7.846-10.405a1.441 1.441 0 0 1-2.88 0 1.44 1.44 0 0 1 2.88 0Z" fill="#121314"></path></svg></a><a href="https://web.archive.org/web/20221001011007/https://www.linkedin.com/company/552285/admin/" target="_blank" rel="noopener noreferrer"><svg width="24" height="24" xmlns="http://www.w3.org/2000/svg"><title>LinkedIn</title><path d="M20.447 20.452h-3.554v-5.569c0-1.328-.027-3.037-1.852-3.037-1.853 0-2.136 1.445-2.136 2.939v5.667H9.351V9h3.414v1.561h.046c.477-.9 1.637-1.85 3.37-1.85 3.601 0 4.267 2.37 4.267 5.455v6.286h-.001ZM5.337 7.433a2.062 2.062 0 0 1-2.063-2.065 2.064 2.064 0 1 1 2.063 2.065Zm1.782 13.019H3.555V9h3.564v11.452ZM22.225 0H1.771C.792 0 0 .774 0 1.729v20.542C0 23.227.792 24 1.771 24h20.451C23.2 24 24 23.227 24 22.271V1.729C24 .774 23.2 0 22.222 0h.003Z" fill="#121314"></path></svg></a><a href="https://web.archive.org/web/20221001011007/https://www.facebook.com/bitly" target="_blank" rel="noopener noreferrer"><svg width="24" height="24" xmlns="http://www.w3.org/2000/svg"><title>Facebook</title><path d="M22.676 0H1.324C.593 0 0 .593 0 1.324v21.352C0 23.408.593 24 1.324 24h11.494v-9.294H9.689v-3.621h3.129V8.41c0-3.099 1.894-4.785 4.659-4.785 1.325 0 2.464.097 2.796.141v3.24h-1.921c-1.5 0-1.792.721-1.792 1.771v2.311h3.584l-.465 3.63H16.56V24h6.115c.733 0 1.325-.592 1.325-1.324V1.324C24 .593 23.408 0 22.676 0" fill="#121314"></path></svg></a></div></div></div></footer></main></div></div></div><script id="__NEXT_DATA__" type="application/json">