---
title: "SUUMO API: Lines | Perceptlayer"
description: "Lines from SUUMO as JSON. 1 credit per successful call."
url: https://perceptlayer.com/apis/suumo/lines
---

[APIs](https://perceptlayer.com/apis) / [SUUMO](https://perceptlayer.com/apis/suumo) / Lines

# SUUMO: Lines

Lines from SUUMO as JSON. 1 credit per successful call.

GET `/v1/suumo/lines`

## Parameters

Send parameters in the query string.

| Parameter | Type | Required | Allowed values |
| --- | --- | --- | --- |
| `prefecture` | string | Required | hokkaido, aomori, iwate, miyagi, akita, yamagata, fukushima, ibaraki, tochigi, gunma, saitama, chiba, tokyo, kanagawa, niigata, toyama, ishikawa, fukui, yamanashi, nagano, gifu, shizuoka, aichi, mie, shiga, kyoto, osaka, hyogo, nara, wakayama, tottori, shimane, okayama, hiroshima, yamaguchi, tokushima, kagawa, ehime, kochi, fukuoka, saga, nagasaki, kumamoto, oita, miyazaki, kagoshima, okinawa |
| `line` | string | Optional | Any |
| `line_group` | string | Optional | Any |
| `area_code` | string | Optional | Any |

## Example request

cURL shell 

```
curl "https://api.perceptlayer.com/v1/suumo/lines?prefecture=tokyo" \
  -H "X-API-Key: $API_KEY"
```

[Run this endpoint in the playground](https://perceptlayer.com/apis/suumo?try=lines#playground) with your own parameters. 1 credit per successful call; failed calls are free.