# Pull Streams By Video ID

> Part of the [SpatialGen API documentation](/index.md). [HTML version of this page](/api/03_streams_by_id/).

Fetch the streams for a video by its ID

## API context

-   API requests use `https://spatialgen.com` with the `/api` path prefix, included once.
-   Authenticate requests to SpatialGen API endpoints with the `X-SPATIALGEN-APPKEY` HTTP header.
-   Use a key from the workspace that owns the requested resources. Follow the roles and scopes specified for each endpoint below.
-   Keep `admin` and `upload` keys on a trusted backend. `readonly` keys may be used in client apps for permitted read operations.
-   Presigned upload URLs have their own authorization. Do not send your SpatialGen API key to those URLs.

See the [API key guide](/guides/get-started.md) for roles, key creation, expiration, revocation, and rotation.

* * *

**GET** `/videos/[id]/streams`

Pull the library information and created streams for a video by its ID.

Allowed API Key Roles

`admin`, `readonly`

### Query Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `visibility` | string | No | Filter streams by visibility. Accepted values: `public` or `drm`. |

### Example request to pull a video’s information by ID

getVideoInfo.js

```js
fetch('https://spatialgen.com/api/videos/<yourvideoid>/streams', {
    method: 'GET',
    headers: {
        'X-SPATIALGEN-APPKEY': apiKey,
    }
})
```

### Example request filtered by visibility

getVideoInfoFiltered.js

```js
fetch('https://spatialgen.com/api/videos/<yourvideoid>/streams?visibility=drm', {
    method: 'GET',
    headers: {
        'X-SPATIALGEN-APPKEY': apiKey,
    }
})
```

### Example Response

response.json

```json
{
    "streams": [
        {
            "createdAt": string,              // Date in string format
            "status": string,                 // Stream status
            "streamName": string,             // Name of the stream
            "streamUrl": string,              // URL for the stream
            "visibility": string,             // Visibility of the stream
            "highestResolutionUrl": string,   // URL to the highest resolution converted video
            "highestResolutionBytes": number,  // The number of bytes in the highest resolution converted video
            "jobId": number                   // The job ID corresponding to the stream
        },
        ...
    ]
    "library": {
        "createdAt": string,            // Date in string format
        "description": string,          // Description of the video
        "fileFormat3D": string,         // Format of the 3D file
        "folderName": string,           // Name of the folder
        "id": number,                   // ID of the video
        "is3D": boolean,                // If the video is in 3D
        "isStreaming": boolean,         // If the video is streaming
        "perspective": number,          // Perspective
        "thumbnailUrl": string,         // Thumbnail URL
        "videoLength": number,          // Length of the video in seconds
        "videoHeight": number,          // Height of the video
        "videoName": string             // Name of the video
    }
}
```