
# Ingest

The Livepeer.com API `ingest` endpoint references stream ingest data centers on
the Livepeer network. In the JSON response, each data center region is three
letters, the airport code of the server location.

Use `/ingest` to discover which ingest data center is closest. Ingest and playback URLs for each livestream session must be
from the same region.
```bash
curl "https://livepeer.com/api/ingest"`
```

Use `/ingest` with `?first=false` appended to discover all available ingest and
playback URL pairs. 
```bash
`curl "https://livepeer.com/api/ingest?first=false"`
```

200 OK
```bash
[
  {
    ingest: "rtmp://<reg>-rtmp.livepeer.com/live",
    playback: "https://<reg>-cdn.livepeer.com/hls",
    base:"https://<reg>-cdn.livepeer.com/"
  }
]
```

## Attributes

| JSON parameter | Type   | Description                                                                                       |
| ---------- | ------ | ------------------------------------------------------------------------------------------------- |
| `base`     | string | Base URL for the playback URL.                                                                    |
| `ingest`   | string | Base URL used to to configure the broadcast software. Pair it with a `stream` object `streamKey`. |
| `playback` | string | Base URL for HLS playback. Append a `stream` object `playbackId` to create the full playback URL. |

#Ingest

#Attributes

JSON parameter	Type	Description
`base`	string	Base URL for the playback URL.
`ingest`	string	Base URL used to to configure the broadcast software. Pair it with a `stream` object `streamKey`.
`playback`	string	Base URL for HLS playback. Append a `stream` object `playbackId` to create the full playback URL.