## API Syntax

When using the Get Asset API, it is important to understand the syntax required to make the request. Because the Kevel API is a RESTful API, there is a specific request format that must be followed to ensure the endpoint can process the request. The format is:

```GET https://api.kevel.co/v1/asset/{AssetID}```

Where:

- `GET` - the type of API request being made.
- `https://api.kevel.co` - the URL for the request.
- `v1` - the API version.
- `asset` - the API endpoint being called.
- `AssetID` - the asset ID.

### AssetID

- **Type**: int32  
  **Required**: Yes  
  **Description**: ID of the Asset
  
### Responses
#### ``200``

- **Type**: object
- **Fields**:  
  - **Type**: string  
  - **ContentURL**: string  
  - **IsDeleted**: boolean  
  - **Status**: string  
  - **AdvertiserId**: integer  
  - **Metadata**: object  
      - **Height**: integer  
      - **Width**: integer  
      - **FileExtension**: string  
      - **AspectRatio**: string  
      - **Duration**: number  
      - **PlaybackId**: string  
  - **Name**: string  
  - **Id**: integer

#### ``400``

```shell
curl --request GET \
     --url https://api.kevel.co/v1/asset/AssetID \
     --header 'accept: application/json'
```

#### Example Response

```json
{
    "Type": "video",
    "ContentURL": "https://stream.video-assets.kevel.com/F02sQ4e4VovltQ3xxxAMv008RpJufiNY.m3u8",
    "IsDeleted": false,
    "Status": "ready",
    "AdvertiserId": 45678,
    "Metadata": {
        "Height": 360,
        "Width": 640,
        "FileExtension": ".m3u8",
        "AspectRatio": "16:9",
        "Duration": 15.006633,
        "PlaybackId": "F02sQ4e4VovltQ3xxxAMv008RpJufiNY"
    },
    "Name": "Example Video Asset",
    "Id": 1234
}
```
