> This is the Markdown version of the page. For the complete Lattice Developers documentation index, fetch https://developer.anduril.com/llms.txt. Append .md to any page URL for its clean Markdown.

# Get egress stream

GET https://example.developer.anduril.com/api/v1/video/egress_streams/{egressId}

Retrieves an egress stream object and its associated metadata.

Reference: https://developer.anduril.com/reference/rest/video/get-egress-stream

## Authentication

- `Authorization` header (bearer token, required) — Bearer authentication of the form `Bearer <token>`, where token is your auth token.

## Request

### Path parameters

- `egressId` (string, required) — Identifier of the egress stream to retrieve.

## Response

### 200

OK

- `egressStream` (EgressStream, optional) — The egress stream corresponding to the requested `egressId`.

## Errors

### 400 Bad Request Error

The request was malformed or violated a precondition. Possible causes include missing required fields, an unsupported value, an `oneof` with zero or more than one variant set, a malformed URL, or a state-based precondition such as the source ingress stream not being live.

- `code` (integer, optional) — The status code, which should be an enum value of [google.rpc.Code][google.rpc.Code].
- `message` (string, optional) — A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the [google.rpc.Status.details][google.rpc.Status.details] field, or localized by the client.
- `details` (list of google.protobuf.Any, optional) — A list of messages that carry the error details. There is a common set of message types for APIs to use.

### 401 Unauthorized Error

The request was rejected because the bearer token was missing, malformed, or could not be resolved to a user identity.

- `code` (integer, optional) — The status code, which should be an enum value of [google.rpc.Code][google.rpc.Code].
- `message` (string, optional) — A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the [google.rpc.Status.details][google.rpc.Status.details] field, or localized by the client.
- `details` (list of google.protobuf.Any, optional) — A list of messages that carry the error details. There is a common set of message types for APIs to use.

### 403 Forbidden Error

The caller is authenticated but lacks permission for the requested resource.

- `code` (integer, optional) — The status code, which should be an enum value of [google.rpc.Code][google.rpc.Code].
- `message` (string, optional) — A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the [google.rpc.Status.details][google.rpc.Status.details] field, or localized by the client.
- `details` (list of google.protobuf.Any, optional) — A list of messages that carry the error details. There is a common set of message types for APIs to use.

### 404 Not Found Error

The specified ingress or egress stream was not found.

- `code` (integer, optional) — The status code, which should be an enum value of [google.rpc.Code][google.rpc.Code].
- `message` (string, optional) — A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the [google.rpc.Status.details][google.rpc.Status.details] field, or localized by the client.
- `details` (list of google.protobuf.Any, optional) — A list of messages that carry the error details. There is a common set of message types for APIs to use.

### 503 Service Unavailable Error

The service is temporarily unable to handle the request, such as during startup or when a backend dependency is shutting down. The response carries a RetryInfo hint (typically around 2 seconds); clients should retry per that hint.

- `code` (integer, optional) — The status code, which should be an enum value of [google.rpc.Code][google.rpc.Code].
- `message` (string, optional) — A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the [google.rpc.Status.details][google.rpc.Status.details] field, or localized by the client.
- `details` (list of google.protobuf.Any, optional) — A list of messages that carry the error details. There is a common set of message types for APIs to use.

## Types

### EgressStream

An egress stream publishes a single stream to a downstream consumer over a chosen transport.

- `egressId` (string, optional) — Service-generated identifier for the egress stream.
- `ingressId` (string, optional) — Identifier of the ingress stream this egress stream publishes.
- `rtsp` (RtspEgress, optional) — RTSP egress connection details.
- `srt` (SrtEgress, optional) — SRT egress connection details.

### google.protobuf.Any

Contains an arbitrary serialized message along with a @type that describes the type of the serialized message.

- `@type` (string, optional) — The type of the serialized message.

### RtspEgress

RTSP egress connection details.

- `url` (string, optional) — The RTSP URL the downstream consumer should pull from.

### SrtEgress

SRT egress connection details.

- `url` (string, optional) — The URL on which Lattice listens. The downstream consumer pulls from this URL.
- `sessionId` (string, optional) — Unique session identifier the consumer must supply on the SRT connection.

## Examples

**Response**

```json
{
  "egressStream": {
    "egressId": "string",
    "ingressId": "string",
    "rtsp": {
      "url": "string"
    },
    "srt": {
      "url": "string",
      "sessionId": "string"
    }
  }
}
```