[{"data":1,"prerenderedAt":734},["ShallowReactive",2],{"docs-\u002Fdocs\u002Fdatasets\u002Fdownloading":3,"_apollo:default":730,"_apollo:stationEditor":731,"_apollo:feedManagement":732,"_apollo:transferAnalyst":733},{"id":4,"title":5,"body":6,"description":723,"extension":724,"meta":725,"navigation":589,"path":726,"seo":727,"stem":728,"__hash__":729},"content\u002Fdocs\u002Fdatasets\u002Fdownloading.md","Downloading Transitland Datasets",{"type":7,"value":8,"toc":712},"minimark",[9,14,18,51,62,71,75,78,83,94,100,106,111,133,138,340,345,386,390,397,402,407,435,440,444,456,460,468,472,479,483,487,498,503,507,519,523,528,532,535,551,555,559,563,568,658,662,667,705,708],[10,11,13],"h2",{"id":12},"downloading-via-transitland-website","Downloading via Transitland Website",[15,16,17],"p",{},"To download free Transitland Datasets for non-commercial use:",[19,20,21,32,40,48],"ol",{},[22,23,24,31],"li",{},[25,26,30],"a",{"href":27,"rel":28},"https:\u002F\u002Fapp.interline.io\u002Fusers\u002Fme",[29],"nofollow","Sign into"," your Interline account",[22,33,34,39],{},[25,35,38],{"href":36,"rel":37},"https:\u002F\u002Fapp.interline.io\u002Fproducts\u002Ftransitland_datasets\u002Forders\u002Fnew",[29],"Order"," a free Transitland Datasets subscription",[22,41,42,43,47],{},"Navigate to the ",[25,44,46],{"href":45},"\u002Fdatasets","Download Transitland Datasets"," section",[22,49,50],{},"Select your desired Dataset package and click to download",[52,53,56,57],"div",{"className":54},[55],"screenshot","\n  ",[58,59],"img",{"src":60,"alt":61},"\u002Fimages\u002Ftransitland-datasets-download-page.png","screenshot of Transitland Datasets page listing available downloads after user has signed in",[63,64,65,66,70],"info",{},"\nFor commercial use, please \n",[25,67,69],{"href":68},"https:\u002F\u002Fapp.interline.io\u002Fcontact_forms\u002Fdatasets","\ncontact Interline\n","\n for a quote.\n",[10,72,74],{"id":73},"downloading-via-api","Downloading via API",[15,76,77],{},"Transitland Datasets can also be downloaded programmatically. The API provides three endpoints:",[79,80,82],"h3",{"id":81},"list-available-datasets","List Available Datasets",[15,84,85,89,90],{},[86,87,88],"strong",{},"Endpoint:"," ",[91,92,93],"code",{},"GET https:\u002F\u002Fapp.interline.io\u002Ftransitland_datasets",[15,95,96,99],{},[86,97,98],{},"Authentication:"," None required",[15,101,102,105],{},[86,103,104],{},"Description:"," Lists all available Transitland Datasets with their metadata.",[15,107,108],{},[86,109,110],{},"Example Request:",[112,113,118],"pre",{"className":114,"code":115,"language":116,"meta":117,"style":117},"language-bash shiki shiki-themes github-light github-dark","curl https:\u002F\u002Fapp.interline.io\u002Ftransitland_datasets\n","bash","",[91,119,120],{"__ignoreMap":117},[121,122,125,129],"span",{"class":123,"line":124},"line",1,[121,126,128],{"class":127},"sScJk","curl",[121,130,132],{"class":131},"sZZnC"," https:\u002F\u002Fapp.interline.io\u002Ftransitland_datasets\n",[15,134,135],{},[86,136,137],{},"Example Response:",[112,139,143],{"className":140,"code":141,"language":142,"meta":117,"style":117},"language-json shiki shiki-themes github-light github-dark","{\n  \"data\": [\n    {\n      \"attributes\": {\n        \"bucket_key\": \"US\u002Fstops-routes-with-schedule\u002Ftl-dataset-US-2025-07-27T04:00:30.zip\",\n        \"bucket_name\": \"transitland-datasets\",\n        \"bucket_provider\": \"azure\",\n        \"created_at\": \"2025-07-28T12:52:54.466Z\",\n        \"dataset_type\": \"stops-routes-with-schedule\",\n        \"geography\": \"US\",\n        \"updated_at\": \"2025-07-28T12:52:54.466Z\"\n      },\n      \"id\": \"22\",\n      \"type\": \"transitland_dataset\"\n    }\n  ],\n  \"jsonapi\": {\n    \"version\": \"1.0\"\n  }\n}\n","json",[91,144,145,151,161,167,176,191,204,217,230,243,256,267,273,286,297,303,309,317,328,334],{"__ignoreMap":117},[121,146,147],{"class":123,"line":124},[121,148,150],{"class":149},"sVt8B","{\n",[121,152,154,158],{"class":123,"line":153},2,[121,155,157],{"class":156},"sj4cs","  \"data\"",[121,159,160],{"class":149},": [\n",[121,162,164],{"class":123,"line":163},3,[121,165,166],{"class":149},"    {\n",[121,168,170,173],{"class":123,"line":169},4,[121,171,172],{"class":156},"      \"attributes\"",[121,174,175],{"class":149},": {\n",[121,177,179,182,185,188],{"class":123,"line":178},5,[121,180,181],{"class":156},"        \"bucket_key\"",[121,183,184],{"class":149},": ",[121,186,187],{"class":131},"\"US\u002Fstops-routes-with-schedule\u002Ftl-dataset-US-2025-07-27T04:00:30.zip\"",[121,189,190],{"class":149},",\n",[121,192,194,197,199,202],{"class":123,"line":193},6,[121,195,196],{"class":156},"        \"bucket_name\"",[121,198,184],{"class":149},[121,200,201],{"class":131},"\"transitland-datasets\"",[121,203,190],{"class":149},[121,205,207,210,212,215],{"class":123,"line":206},7,[121,208,209],{"class":156},"        \"bucket_provider\"",[121,211,184],{"class":149},[121,213,214],{"class":131},"\"azure\"",[121,216,190],{"class":149},[121,218,220,223,225,228],{"class":123,"line":219},8,[121,221,222],{"class":156},"        \"created_at\"",[121,224,184],{"class":149},[121,226,227],{"class":131},"\"2025-07-28T12:52:54.466Z\"",[121,229,190],{"class":149},[121,231,233,236,238,241],{"class":123,"line":232},9,[121,234,235],{"class":156},"        \"dataset_type\"",[121,237,184],{"class":149},[121,239,240],{"class":131},"\"stops-routes-with-schedule\"",[121,242,190],{"class":149},[121,244,246,249,251,254],{"class":123,"line":245},10,[121,247,248],{"class":156},"        \"geography\"",[121,250,184],{"class":149},[121,252,253],{"class":131},"\"US\"",[121,255,190],{"class":149},[121,257,259,262,264],{"class":123,"line":258},11,[121,260,261],{"class":156},"        \"updated_at\"",[121,263,184],{"class":149},[121,265,266],{"class":131},"\"2025-07-28T12:52:54.466Z\"\n",[121,268,270],{"class":123,"line":269},12,[121,271,272],{"class":149},"      },\n",[121,274,276,279,281,284],{"class":123,"line":275},13,[121,277,278],{"class":156},"      \"id\"",[121,280,184],{"class":149},[121,282,283],{"class":131},"\"22\"",[121,285,190],{"class":149},[121,287,289,292,294],{"class":123,"line":288},14,[121,290,291],{"class":156},"      \"type\"",[121,293,184],{"class":149},[121,295,296],{"class":131},"\"transitland_dataset\"\n",[121,298,300],{"class":123,"line":299},15,[121,301,302],{"class":149},"    }\n",[121,304,306],{"class":123,"line":305},16,[121,307,308],{"class":149},"  ],\n",[121,310,312,315],{"class":123,"line":311},17,[121,313,314],{"class":156},"  \"jsonapi\"",[121,316,175],{"class":149},[121,318,320,323,325],{"class":123,"line":319},18,[121,321,322],{"class":156},"    \"version\"",[121,324,184],{"class":149},[121,326,327],{"class":131},"\"1.0\"\n",[121,329,331],{"class":123,"line":330},19,[121,332,333],{"class":149},"  }\n",[121,335,337],{"class":123,"line":336},20,[121,338,339],{"class":149},"}\n",[15,341,342],{},[86,343,344],{},"Response Fields:",[346,347,348,354,360,366,372],"ul",{},[22,349,350,353],{},[91,351,352],{},"id",": Unique identifier for the dataset",[22,355,356,359],{},[91,357,358],{},"geography",": Country code (US, CA)",[22,361,362,365],{},[91,363,364],{},"dataset_type",": Type of dataset (currently only \"stops-routes-with-schedule\")",[22,367,368,371],{},[91,369,370],{},"created_at",": When the dataset was created",[22,373,374,377,378,381,382,385],{},[91,375,376],{},"bucket_key",", ",[91,379,380],{},"bucket_name",", and ",[91,383,384],{},"bucket_provider",": Internal storage information; outside users cannot download from this source directly",[79,387,389],{"id":388},"download-dataset","Download Dataset",[15,391,392,89,394],{},[86,393,88],{},[91,395,396],{},"GET https:\u002F\u002Fapp.interline.io\u002Ftransitland_datasets\u002Fdownload_latest",[15,398,399,401],{},[86,400,98],{}," Required - Transitland Datasets API token",[15,403,404],{},[86,405,406],{},"Parameters:",[346,408,409,421,429],{},[22,410,411,413,414,417,418],{},[91,412,358],{}," (required): Country code - ",[91,415,416],{},"US"," or ",[91,419,420],{},"CA",[22,422,423,425,426],{},[91,424,364],{}," (required): Dataset type - ",[91,427,428],{},"stops-routes-with-schedule",[22,430,431,434],{},[91,432,433],{},"api_token"," (required): Your Transitland Datasets API token",[15,436,437,439],{},[86,438,104],{}," Downloads the latest version of a specific dataset. Returns a 302 redirect to the actual file download.",[15,441,442],{},[86,443,110],{},[112,445,447],{"className":114,"code":446,"language":116,"meta":117,"style":117},"curl \"https:\u002F\u002Fapp.interline.io\u002Ftransitland_datasets\u002Fdownload_latest?geography=US&dataset_type=stops-routes-with-schedule&api_token=YOUR_API_TOKEN\"\n",[91,448,449],{"__ignoreMap":117},[121,450,451,453],{"class":123,"line":124},[121,452,128],{"class":127},[121,454,455],{"class":131}," \"https:\u002F\u002Fapp.interline.io\u002Ftransitland_datasets\u002Fdownload_latest?geography=US&dataset_type=stops-routes-with-schedule&api_token=YOUR_API_TOKEN\"\n",[15,457,458],{},[86,459,137],{},[112,461,466],{"className":462,"code":464,"language":465},[463],"language-text","HTTP\u002F1.1 302 Found\nLocation: https:\u002F\u002Finterline.blob.core.windows.net\u002Ftransitland-datasets\u002FUS\u002Fstops-routes-with-schedule\u002Ftl-dataset-US-2025-07-27T04:00:30.zip?sp=r&sv=2018-11-09&sr=b\n","text",[91,467,464],{"__ignoreMap":117},[79,469,471],{"id":470},"download-specific-dataset","Download Specific Dataset",[15,473,474,89,476],{},[86,475,88],{},[91,477,478],{},"GET https:\u002F\u002Fapp.interline.io\u002Ftransitland_datasets\u002F{id}\u002Fdownload",[15,480,481,401],{},[86,482,98],{},[15,484,485],{},[86,486,406],{},[346,488,489,494],{},[22,490,491,493],{},[91,492,352],{}," (required): Dataset ID from the list endpoint",[22,495,496,434],{},[91,497,433],{},[15,499,500,502],{},[86,501,104],{}," Downloads a specific dataset by its ID. Useful for downloading historical versions or specific releases.",[15,504,505],{},[86,506,110],{},[112,508,510],{"className":114,"code":509,"language":116,"meta":117,"style":117},"curl \"https:\u002F\u002Fapp.interline.io\u002Ftransitland_datasets\u002F22\u002Fdownload?api_token=YOUR_API_TOKEN\"\n",[91,511,512],{"__ignoreMap":117},[121,513,514,516],{"class":123,"line":124},[121,515,128],{"class":127},[121,517,518],{"class":131}," \"https:\u002F\u002Fapp.interline.io\u002Ftransitland_datasets\u002F22\u002Fdownload?api_token=YOUR_API_TOKEN\"\n",[15,520,521],{},[86,522,137],{},[112,524,526],{"className":525,"code":464,"language":465},[463],[91,527,464],{"__ignoreMap":117},[79,529,531],{"id":530},"getting-your-api-token","Getting Your API Token",[15,533,534],{},"To obtain a Transitland Datasets API token:",[19,536,537,542,548],{},[22,538,539,31],{},[25,540,30],{"href":27,"rel":541},[29],[22,543,544,547],{},[25,545,38],{"href":36,"rel":546},[29]," a Transitland Datasets subscription",[22,549,550],{},"Under the Subscriptions and API keys tab, find your Transitland Datasets order. It will list your API key",[552,553,554],"warning",{},"\n  Transitland Datasets API tokens are different from Transitland REST API keys. Make sure you're using the correct type for your use case.\n",[63,556,65,557,70],{},[25,558,69],{"href":68},[79,560,562],{"id":561},"programmatic-download-examples","Programmatic Download Examples",[15,564,565],{},[86,566,567],{},"Using curl:",[112,569,571],{"className":114,"code":570,"language":116,"meta":117,"style":117},"# List available datasets\ncurl https:\u002F\u002Fapp.interline.io\u002Ftransitland_datasets\n\n# Download latest US dataset\ncurl -L \"https:\u002F\u002Fapp.interline.io\u002Ftransitland_datasets\u002Fdownload_latest?geography=US&dataset_type=stops-routes-with-schedule&api_token=YOUR_API_TOKEN\" -o us-dataset.zip\n\n# Download latest Canada dataset\ncurl -L \"https:\u002F\u002Fapp.interline.io\u002Ftransitland_datasets\u002Fdownload_latest?geography=CA&dataset_type=stops-routes-with-schedule&api_token=YOUR_API_TOKEN\" -o ca-dataset.zip\n\n# Download specific dataset by ID\ncurl -L \"https:\u002F\u002Fapp.interline.io\u002Ftransitland_datasets\u002F22\u002Fdownload?api_token=YOUR_API_TOKEN\" -o specific-dataset.zip\n",[91,572,573,579,585,591,596,612,616,621,635,639,644],{"__ignoreMap":117},[121,574,575],{"class":123,"line":124},[121,576,578],{"class":577},"sJ8bj","# List available datasets\n",[121,580,581,583],{"class":123,"line":153},[121,582,128],{"class":127},[121,584,132],{"class":131},[121,586,587],{"class":123,"line":163},[121,588,590],{"emptyLinePlaceholder":589},true,"\n",[121,592,593],{"class":123,"line":169},[121,594,595],{"class":577},"# Download latest US dataset\n",[121,597,598,600,603,606,609],{"class":123,"line":178},[121,599,128],{"class":127},[121,601,602],{"class":156}," -L",[121,604,605],{"class":131}," \"https:\u002F\u002Fapp.interline.io\u002Ftransitland_datasets\u002Fdownload_latest?geography=US&dataset_type=stops-routes-with-schedule&api_token=YOUR_API_TOKEN\"",[121,607,608],{"class":156}," -o",[121,610,611],{"class":131}," us-dataset.zip\n",[121,613,614],{"class":123,"line":193},[121,615,590],{"emptyLinePlaceholder":589},[121,617,618],{"class":123,"line":206},[121,619,620],{"class":577},"# Download latest Canada dataset\n",[121,622,623,625,627,630,632],{"class":123,"line":219},[121,624,128],{"class":127},[121,626,602],{"class":156},[121,628,629],{"class":131}," \"https:\u002F\u002Fapp.interline.io\u002Ftransitland_datasets\u002Fdownload_latest?geography=CA&dataset_type=stops-routes-with-schedule&api_token=YOUR_API_TOKEN\"",[121,631,608],{"class":156},[121,633,634],{"class":131}," ca-dataset.zip\n",[121,636,637],{"class":123,"line":232},[121,638,590],{"emptyLinePlaceholder":589},[121,640,641],{"class":123,"line":245},[121,642,643],{"class":577},"# Download specific dataset by ID\n",[121,645,646,648,650,653,655],{"class":123,"line":258},[121,647,128],{"class":127},[121,649,602],{"class":156},[121,651,652],{"class":131}," \"https:\u002F\u002Fapp.interline.io\u002Ftransitland_datasets\u002F22\u002Fdownload?api_token=YOUR_API_TOKEN\"",[121,654,608],{"class":156},[121,656,657],{"class":131}," specific-dataset.zip\n",[79,659,661],{"id":660},"error-handling","Error Handling",[15,663,664],{},[86,665,666],{},"Common HTTP Status Codes:",[346,668,669,675,681,687,693,699],{},[22,670,671,674],{},[91,672,673],{},"200 OK",": Success (for list endpoint)",[22,676,677,680],{},[91,678,679],{},"302 Found",": Success (for download endpoint - redirects to file)",[22,682,683,686],{},[91,684,685],{},"401 Unauthorized",": Invalid or missing API token",[22,688,689,692],{},[91,690,691],{},"403 Forbidden",": No active subscription for Transitland Datasets",[22,694,695,698],{},[91,696,697],{},"404 Not Found",": Invalid geography or dataset type",[22,700,701,704],{},[91,702,703],{},"500 Internal Server Error",": Server error",[63,706,707],{},"\n The download endpoint returns a 302 redirect to the actual file location. Most HTTP clients will automatically follow redirects, but some may require explicit handling.\n",[709,710,711],"style",{},"html pre.shiki code .sVt8B, html code.shiki .sVt8B{--shiki-default:#24292E;--shiki-dark:#E1E4E8}html pre.shiki code .sj4cs, html code.shiki .sj4cs{--shiki-default:#005CC5;--shiki-dark:#79B8FF}html pre.shiki code .sZZnC, html code.shiki .sZZnC{--shiki-default:#032F62;--shiki-dark:#9ECBFF}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .sScJk, html code.shiki .sScJk{--shiki-default:#6F42C1;--shiki-dark:#B392F0}html pre.shiki code .sJ8bj, html code.shiki .sJ8bj{--shiki-default:#6A737D;--shiki-dark:#6A737D}",{"title":117,"searchDepth":153,"depth":153,"links":713},[714,715],{"id":12,"depth":153,"text":13},{"id":73,"depth":153,"text":74,"children":716},[717,718,719,720,721,722],{"id":81,"depth":163,"text":82},{"id":388,"depth":163,"text":389},{"id":470,"depth":163,"text":471},{"id":530,"depth":163,"text":531},{"id":561,"depth":163,"text":562},{"id":660,"depth":163,"text":661},"Download Transitland Datasets for the US and Canada from the website or the API, with endpoints, API token setup, curl examples, and error handling.","md",{},"\u002Fdocs\u002Fdatasets\u002Fdownloading",{"title":5,"description":723},"docs\u002Fdatasets\u002Fdownloading","ro1cdqBqSvbQ6t_C27ORC8lqKx75Tq5x0grNWZTDdRM",{},{},{},{},1791115795576]