Introduction

Request an instruction line from a production order

Instruction lines are part of a production or traffic order, a Traffic Order can have an unlimited amount of instruction lines. The instruction line contains information about a spot that needs to run for an Account, such as the run dates, the due date of any production elements, what audio to run and what the script is. It also contains additional traffic information, such as whether or not it is rotating with any other instruction lines, what the length should be, and what Contract it is linked to.

❗️

Instruction lines are not Contracts

An instruction line instructs Traffic, Creative & Production to run a spot to fullfill the Contract. You are not booking spots using this endpoint, just instructing a certain spot to run.

The response contains a complete instruction line, here is an example of how the instruction line is structured.

{
    "status": 200,
    "data": {
        "instructions": [
            {
              "isReady": false,
              "accountId": 223781,
              "advertiserName": "Royal Canadian Legion Branch 1",
              "spotTitle": "RCL Br 1 Veteran Service Recognition SCRIPT Reqd",
              "dubStatus": 0,
              "mediaId": 0,
              "mediaIntro": 0,
              "mediaEom": 0,
              "mediaLength": 0,
              "instructionId": 113966,
              "bankId": 108978,
              "dubbedOn": [

              ],
              "cartNumber": "",
              "spotStatus": {
                "coreId": 55066,
                "descriptor": "Needs Voicing"
              },
              "startDate": "1970-01-01",
              "endDate": "2019-02-18",
              "spotLength": 30,
              "stations": [
                {
                  "coreId": 624,
                  "callLetters": "VOCM",
                  "band": "AM"
                }
              ],
              "errors": [
                "missing-cart-id",
                "no-media"
              ]
            },
            {
              "isReady": false,
              "accountId": 194840,
              "advertiserName": "Avalon Industrial & Marine Supply Ltd.",
              "spotTitle": "Avalon 7am News Intro",
              "dubStatus": 1,
              "mediaId": 0,
              "mediaIntro": 0,
              "mediaEom": 0,
              "mediaLength": 0,
              "instructionId": 90483,
              "bankId": 87022,
              "dubbedOn": [
                625
              ],
              "cartNumber": "A0695",
              "spotStatus": {
                "coreId": 45871,
                "descriptor": "Audio Approved"
              },
              "startDate": "2017-05-15",
              "endDate": "2019-02-24",
              "spotLength": 10,
              "stations": [
                {
                  "coreId": 625,
                  "callLetters": "CHVO",
                  "band": "FM"
                }
              ],
              "errors": [
                "no-media"
              ]
            },
            {
              "isReady": false,
              "accountId": 195816,
              "advertiserName": "Dominion Recycling",
              "spotTitle": "5pm News Cast",
              "dubStatus": 1,
              "mediaId": 0,
              "mediaIntro": 0,
              "mediaEom": 0,
              "mediaLength": 0,
              "instructionId": 105703,
              "bankId": 101006,
              "dubbedOn": [
                624
              ],
              "availableDownloads": [

              ],
              "cartNumber": "A0914",
              "spotStatus": {
                "coreId": 45871,
                "descriptor": "Audio Approved"
              },
              "startDate": "2017-12-16",
              "endDate": "2019-03-31",
              "spotLength": 30,
              "stations": [
                {
                  "coreId": 624,
                  "callLetters": "VOCM",
                  "band": "AM"
                }
              ],
              "errors": [
                "no-media"
              ]
            },
            {
              "isReady": false,
              "accountId": 195816,
              "advertiserName": "Dominion Recycling",
              "spotTitle": "VOCM 5pm News BB",
              "dubStatus": 1,
              "mediaId": 0,
              "mediaIntro": 0,
              "mediaEom": 0,
              "mediaLength": 0,
              "instructionId": 105718,
              "bankId": 101019,
              "dubbedOn": [
                624
              ],
              "cartNumber": "A1094",
              "spotStatus": {
                "coreId": 45871,
                "descriptor": "Audio Approved"
              },
              "startDate": "2017-12-16",
              "endDate": "2019-03-31",
              "spotLength": 10,
              "stations": [
                {
                  "coreId": 624,
                  "callLetters": "VOCM",
                  "band": "AM"
                }
              ],
              "errors": [
                "no-media"
              ]
            },
            {
              "isReady": true,
              "accountId": 193311,
              "advertiserName": "Ambrotek Printing",
              "spotTitle": "Ambrotek Morning Traffic Report Q1 2018 - 3",
              "dubStatus": 1,
              "mediaId": 21080,
              "mediaIntro": 0,
              "mediaEom": 0,
              "mediaLength": 17.8524,
              "instructionId": 74485,
              "bankId": 72020,
              "dubbedOn": [
                590
              ],
              "cartNumber": "5214",
              "spotStatus": {
                "coreId": 45871,
                "descriptor": "Audio Approved"
              },
              "startDate": "2018-01-01",
              "endDate": "2018-12-28",
              "spotLength": 15,
              "stations": [
                {
                  "coreId": 590,
                  "callLetters": "CILV",
                  "band": "FM"
                }
              ]
            }
        ]
    }
}