---
updatedAt: 2026-07-30T09:25:46.000Z
agentTools:
  siteIndex: https://developer.bitmovin.com/llms.txt
  projectIndex: https://developer.bitmovin.com/encoding/llms.txt
---

# Get Concatenation Input Stream details

# OpenAPI definition

```json
{
  "openapi": "3.0.1",
  "info": {
    "title": "VOD Encoding API",
    "description": "Bitmovins API Reference Description",
    "version": "3.0",
    "termsOfService": "https://bitmovin.com",
    "contact": {
      "name": "Bitmovin Inc",
      "url": "https://bitmovin.com",
      "email": "support@bitmovin.com"
    }
  },
  "servers": [
    {
      "url": "https://api.bitmovin.com/v1",
      "description": "Bitmovin Server",
      "variables": {}
    }
  ],
  "security": [
    {
      "ApiKeyAuth": []
    },
    {
      "ApiKeyAuth": [],
      "TenantOrgId": []
    }
  ],
  "paths": {
    "/encoding/encodings/{encoding_id}/input-streams/concatenation/{input_stream_id}": {
      "get": {
        "tags": [
          "Concatenation Input Stream"
        ],
        "summary": "Get Concatenation Input Stream details",
        "operationId": "GetEncodingEncodingsInputStreamsConcatenationByEncodingIdAndConcatenationInputStreamId",
        "x-bitmovin": {
          "product": "vod"
        },
        "parameters": [
          {
            "name": "encoding_id",
            "in": "path",
            "description": "Id of the encoding.",
            "style": "simple",
            "required": true,
            "schema": {
              "type": "string",
              "example": "f3177c2e-0000-4ba6-bd20-1dee353d8a72"
            }
          },
          {
            "name": "input_stream_id",
            "in": "path",
            "description": "Id of the concatenation input stream.",
            "style": "simple",
            "required": true,
            "schema": {
              "type": "string",
              "example": "a6336204-c929-4a61-b7a0-2cd6665114e9"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/ResponseEnvelope"
                    },
                    {
                      "properties": {
                        "data": {
                          "properties": {
                            "result": {
                              "allOf": [
                                {
                                  "$ref": "#/components/schemas/ConcatenationInputStream"
                                },
                                {
                                  "description": "Stream"
                                }
                              ]
                            }
                          }
                        }
                      }
                    }
                  ]
                }
              }
            }
          },
          "default": {
            "description": "Error response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseError"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "securitySchemes": {
      "ApiKeyAuth": {
        "type": "apiKey",
        "description": "Your Bitmovin API key",
        "name": "X-Api-Key",
        "in": "header"
      },
      "TenantOrgId": {
        "type": "apiKey",
        "description": "Your Bitmovin account organization",
        "name": "X-Tenant-Org-Id",
        "in": "header"
      }
    },
    "schemas": {
      "BitmovinResource": {
        "title": "BitmovinResource",
        "allOf": [
          {
            "$ref": "#/components/schemas/BitmovinResponse"
          },
          {
            "properties": {
              "name": {
                "type": "string",
                "description": "Name of the resource. Can be freely chosen by the user.",
                "example": "Name of the resource"
              },
              "description": {
                "type": "string",
                "description": "Description of the resource. Can be freely chosen by the user.",
                "example": "Description of the resource"
              },
              "createdAt": {
                "type": "string",
                "format": "date-time",
                "readOnly": true,
                "description": "Creation timestamp, returned as UTC expressed in ISO 8601 format: YYYY-MM-DDThh:mm:ssZ",
                "example": "2016-06-25T20:09:23.69Z"
              },
              "modifiedAt": {
                "type": "string",
                "format": "date-time",
                "readOnly": true,
                "description": "Modified timestamp, returned as UTC expressed in ISO 8601 format: YYYY-MM-DDThh:mm:ssZ",
                "example": "2016-06-25T20:09:23.69Z"
              },
              "customData": {
                "type": "string",
                "writeOnly": true,
                "description": "User-specific meta data. This can hold anything.",
                "additionalProperties": {
                  "type": "object"
                }
              }
            }
          }
        ]
      },
      "BitmovinResponse": {
        "title": "BitmovinResponse",
        "required": [
          "id"
        ],
        "properties": {
          "id": {
            "type": "string",
            "readOnly": true,
            "description": "Id of the resource",
            "example": "cb90b80c-8867-4e3b-8479-174aa2843f62"
          }
        }
      },
      "AspectMode": {
        "title": "AspectMode",
        "type": "string",
        "default": "PAD",
        "enum": [
          "PAD",
          "CROP",
          "STRETCH"
        ],
        "x-enum-elements": [
          {
            "name": "PAD",
            "description": "Specifies that the Padding aspect mode is used when adapting to the main input stream's aspect ratio (Adding black boxes on the bottom/top or left/right)."
          },
          {
            "name": "CROP",
            "description": "Specifies that the Cropping aspect mode is used when adapting to the main input stream's aspect ratio (Cropping on the left/right or bottom/top)."
          },
          {
            "name": "STRETCH",
            "description": "Specifies that the Stretching aspect mode is used when adapting to the main input stream's aspect ratio (Stretching vertically or horizontally)."
          }
        ]
      },
      "ConcatenationInputConfiguration": {
        "title": "ConcatenationInputConfiguration",
        "required": [
          "inputStreamId",
          "position"
        ],
        "properties": {
          "inputStreamId": {
            "type": "string",
            "description": "The ID of the input stream to be concatenated. This can be an ingest input stream or a trimming input stream",
            "example": "8f850c5a-9e76-417f-962b-79fc5f9aa8c3"
          },
          "isMain": {
            "type": "boolean",
            "description": "Exactly one input stream of a concatenation must have this set to true, which will be used as reference for scaling, aspect ratio, FPS, sample rate, etc. ",
            "default": false,
            "example": true
          },
          "position": {
            "type": "integer",
            "format": "int32",
            "description": "A unique integer value that determines concatenation order",
            "minimum": 0,
            "example": 0
          },
          "paddingBefore": {
            "description": "Inserts a padding sequence (black frames and/or silent audio) before the input stream.",
            "allOf": [
              {
                "$ref": "#/components/schemas/PaddingSequence"
              }
            ]
          },
          "paddingAfter": {
            "description": "Inserts a padding sequence (black frames and/or silent audio) after the input stream.",
            "allOf": [
              {
                "$ref": "#/components/schemas/PaddingSequence"
              }
            ]
          },
          "aspectMode": {
            "description": "Specifies the aspect mode that is used when adapting to the main input stream's aspect ratio",
            "allOf": [
              {
                "$ref": "#/components/schemas/AspectMode"
              }
            ]
          }
        }
      },
      "ConcatenationInputStream": {
        "title": "ConcatenationInputStream",
        "allOf": [
          {
            "$ref": "#/components/schemas/InputStream"
          },
          {
            "properties": {
              "concatenation": {
                "description": "Concatenation configuration for the output of this stream",
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/ConcatenationInputConfiguration"
                }
              }
            }
          }
        ]
      },
      "InputStream": {
        "title": "InputStream",
        "allOf": [
          {
            "$ref": "#/components/schemas/BitmovinResource"
          }
        ]
      },
      "Link": {
        "title": "Link",
        "required": [
          "href"
        ],
        "properties": {
          "href": {
            "type": "string",
            "description": "webpage target URL",
            "example": "https://bitmovin.com/encoding-documentation/bitmovin-api/#/reference/encoding/manifests/add-period"
          },
          "title": {
            "type": "string",
            "description": "Short description of the linked page",
            "example": "how to add a period to a manifest"
          }
        }
      },
      "Message": {
        "title": "Message",
        "required": [
          "type",
          "text"
        ],
        "allOf": [
          {
            "$ref": "#/components/schemas/BitmovinResponse"
          },
          {
            "properties": {
              "type": {
                "description": "Message type giving a hint on the importance of the message (log level)",
                "allOf": [
                  {
                    "$ref": "#/components/schemas/MessageType"
                  }
                ]
              },
              "text": {
                "type": "string",
                "description": "Message text",
                "example": "field must not be empty"
              },
              "field": {
                "type": "string",
                "description": "Name of the field to which the message is referring to",
                "example": "manifestId"
              },
              "links": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/Link"
                },
                "description": "collection of links to webpages containing further information on the topic"
              },
              "more": {
                "type": "object",
                "description": "Service-specific information"
              },
              "date": {
                "type": "string",
                "format": "date-time",
                "description": "Timestamp when the message occurred",
                "example": "2016-06-25T20:09:23.69Z"
              }
            }
          }
        ]
      },
      "MessageType": {
        "title": "MessageType",
        "type": "string",
        "enum": [
          "ERROR",
          "WARNING",
          "INFO",
          "DEBUG",
          "TRACE"
        ]
      },
      "PaddingSequence": {
        "title": "PaddingSequence",
        "required": [
          "duration"
        ],
        "properties": {
          "duration": {
            "type": "number",
            "format": "double",
            "minimum": 0,
            "exclusiveMinimum": true,
            "description": "Duration of the padding sequence, given in the unit specified by the `unit` property. The maximum duration is 300 frames or 10 seconds. If the unit is `FRAMES`, this needs to be an integer value and will be interpreted based on the input frame rate of the main part of the ConcatenationInputStream that is used by your video output stream(s). `FRAMES` is not allowed if the encoding does not contain a video output stream.\n",
            "example": 8.5
          },
          "unit": {
            "description": "The unit of the `duration` property",
            "example": "SECONDS",
            "allOf": [
              {
                "$ref": "#/components/schemas/PaddingDurationUnit"
              }
            ]
          }
        }
      },
      "PaddingDurationUnit": {
        "title": "PaddingDurationUnit",
        "type": "string",
        "default": "SECONDS",
        "enum": [
          "SECONDS",
          "FRAMES"
        ],
        "x-enum-elements": [
          {
            "name": "SECONDS",
            "description": "Duration will be specified in seconds"
          },
          {
            "name": "FRAMES",
            "description": "Duration will be specified in number of frames"
          }
        ]
      },
      "ResponseEnvelope": {
        "title": "ResponseEnvelope",
        "required": [
          "requestId",
          "status",
          "data"
        ],
        "properties": {
          "requestId": {
            "type": "string",
            "readOnly": true,
            "description": "Unique correlation id",
            "example": "6d84e126-d10c-4e52-bbfb-bd4c92bc8333"
          },
          "status": {
            "description": "Response status information",
            "readOnly": true,
            "example": "SUCCESS",
            "allOf": [
              {
                "$ref": "#/components/schemas/ResponseStatus"
              }
            ]
          },
          "data": {
            "description": "Response information",
            "readOnly": true,
            "allOf": [
              {
                "$ref": "#/components/schemas/ResultWrapper"
              }
            ]
          },
          "more": {
            "type": "object",
            "description": "Additional endpoint specific information"
          }
        }
      },
      "ResponseError": {
        "title": "ResponseError",
        "required": [
          "requestId",
          "status",
          "data"
        ],
        "properties": {
          "requestId": {
            "type": "string",
            "readOnly": true,
            "description": "Unique correlation id",
            "example": "6d84e126-d10c-4e52-bbfb-bd4c92bc8333"
          },
          "status": {
            "description": "Response status information",
            "readOnly": true,
            "example": "ERROR",
            "allOf": [
              {
                "$ref": "#/components/schemas/ResponseStatus"
              }
            ]
          },
          "data": {
            "description": "Response information",
            "readOnly": true,
            "allOf": [
              {
                "$ref": "#/components/schemas/ResponseErrorData"
              }
            ]
          }
        }
      },
      "ResponseErrorData": {
        "title": "ResponseErrorData",
        "required": [
          "code",
          "message",
          "developerMessage"
        ],
        "properties": {
          "code": {
            "type": "integer",
            "format": "int32",
            "readOnly": true,
            "description": "Contains an error code as defined in https://bitmovin.com/encoding-documentation/bitmovin-api/#/introduction/api-error-codes\n",
            "example": 1005
          },
          "message": {
            "type": "string",
            "readOnly": true,
            "description": "General error message"
          },
          "developerMessage": {
            "type": "string",
            "readOnly": true,
            "description": "More detailed message meant for developers"
          },
          "links": {
            "type": "array",
            "readOnly": true,
            "items": {
              "$ref": "#/components/schemas/Link"
            },
            "description": "collection of links to webpages containing further information on the topic"
          },
          "details": {
            "type": "array",
            "readOnly": true,
            "items": {
              "$ref": "#/components/schemas/Message"
            },
            "description": "collection of messages containing more detailed information on the cause of the error"
          }
        }
      },
      "ResponseStatus": {
        "title": "ResponseStatus",
        "type": "string",
        "enum": [
          "SUCCESS",
          "ERROR"
        ]
      },
      "ResultWrapper": {
        "title": "ResultWrapper",
        "properties": {
          "result": {
            "type": "object",
            "readOnly": true
          }
        }
      }
    }
  },
  "tags": [
    {
      "name": "Concatenation Input Stream"
    }
  ]
}
```