
# 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

<Table
  data={[
    {
      parameter: <code>base</code>,
      type: <code>string</code>,
      description: "Base URL for the playback URL.",
    },
    {
      parameter: <code>ingest</code>,
      type: <code>string</code>,
      description:
        "Base URL used to to configure the broadcast software. Pair it with a stream object streamKey.",
    },
    {
      parameter: <code>playback</code>,
      type: <code>string</code>,
      description:
        "Base URL for HLS playback. Append a stream object playbackId to create the full playback URL.",
    },
  ]}
/>


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.