# Collection Suspended/Dropped

When a match gets suspended (in this case there was a technical issue with the stream), here is the process logic across the Websockets and APIs.

### **`Actions Websocket`**

* "fixtureActionType":"Status Updated",
* "collectionStatus":"CollectionSuspended",
* "collectionStatusReason":"no signal",

<details>

<summary>CollectionSuspended</summary>

```json
{
   "traceId":"2da87bad41bb49040ca5674297e9b898",
   "version":3,
   "finished":false,
   "fixtureAction":{
      "period":0,
      "actionId":"e66e0b7c-b3ca-4b7e-9048-230b9e511cf3",
      "metadata":{
         "coverageLevel":3,
         "fixtureStatus":1,
         "collectionStatus":3,
         "collectionStatusReason":"no signal",
         "collectionStatusReasonCode":1
      },
      "sendType":"Confirmed",
      "clockTime":"00:00",
      "fixtureId":"aa65a5ac-d4e0-4bc8-829b-12d0b14c7f42",
      "timestamp":"2023-08-09T11:29:45.818447Z",
      "sendTypeId":5,
      "fixtureSeqNum":91,
      "timelineSequence":0.0000000000000091,
      "fixtureActionType":"Status Updated",
      "fixtureActionTypeId":22,
      "relatedFixtureActionIds":[
         
      ]
   },
   "fixtureSummary":{
      "isTied":true,
      "periods":[
         {
            "id":1,
            "end":null,
            "type":"Regular",
            "label":"1st half",
            "start":"2023-08-09T11:01:07",
            "awayTeamScore":0,
            "homeTeamScore":0,
            "awayTeamPeriodScore":0,
            "homeTeamPeriodScore":0
         }
      ],
      "finished":false,
      "awayTeamScore":0,
      "currentPeriod":1,
      "currentStatus":"Live",
      "homeTeamScore":0,
      "collectionStatus":"CollectionSuspended",
      "currentClockTime":"28:38",
      "isHomeTeamInPossesion":false
   }
}
```

</details>

THEN

* "fixtureActionType":"Status Updated",
* "collectionStatus":"CollectionDropped",
* "collectionStatusReason":"This collection was dropped due to technical issues related to stream",

<details>

<summary>CollectionDropped</summary>

```json
{
   "traceId":"4f0dda9412dc853b3f253560c1be866d",
   "version":3,
   "finished":true,
   "fixtureAction":{
      "period":0,
      "actionId":"a0d0d982-166e-4410-9fba-8d1e1e92051f",
      "metadata":{
         "coverageLevel":3,
         "fixtureStatus":7,
         "collectionStatus":4,
         "collectionStatusReason":"This collection was dropped due to technical issues related to stream",
         "fixtureStatusReasonCode":0,
         "collectionStatusReasonCode":1
      },
      "sendType":"Confirmed",
      "clockTime":"00:00",
      "fixtureId":"aa65a5ac-d4e0-4bc8-829b-12d0b14c7f42",
      "timestamp":"2023-08-09T11:35:13.830593Z",
      "sendTypeId":5,
      "fixtureSeqNum":92,
      "timelineSequence":0.0000000000000092,
      "fixtureActionType":"Status Updated",
      "fixtureActionTypeId":22,
      "relatedFixtureActionIds":[
         
      ]
   },
   "fixtureSummary":{
      "isTied":true,
      "periods":[
         {
            "id":1,
            "end":null,
            "type":"Regular",
            "label":"1st half",
            "start":"2023-08-09T11:01:07",
            "awayTeamScore":0,
            "homeTeamScore":0,
            "awayTeamPeriodScore":0,
            "homeTeamPeriodScore":0
         }
      ],
      "finished":true,
      "awayTeamScore":0,
      "currentPeriod":1,
      "currentStatus":"Unverified",
      "homeTeamScore":0,
      "collectionStatus":"CollectionDropped",
      "currentClockTime":"34:06",
      "isHomeTeamInPossesion":false
   }
}
```

</details>

### **`Fixtures API`**

* "collectionStatus": "CollectionDropped",
* "type": "Official",
* "coverageLevel": "Standard stream",

<details>

<summary>CollectionDropped</summary>

<pre class="language-json"><code class="lang-json"><strong>{
</strong>    "id": "aa65a5ac-d4e0-4bc8-829b-12d0b14c7f42",
    "name": "Ulytau v Qyzyljar Petropavlovsk 2",
    "status": "Completed",
    "collectionStatus": "CollectionDropped",
    "type": "Official",
    "coverageLevel": "Standard stream",
    "startDateUTC": "2023-08-09T11:00:00",
    "teams": [
        {
            "id": "54a5c198-8996-4977-a8e2-cab4f42aa57f",
            "name": "Ulytau",
            "club": {
                "id": "d92baf3b-ef52-4b5c-8164-a5154b54d576",
                "name": "ULYTAU"
            },
            "category": {
                "id": 1,
                "name": "Men"
            },
            "homeTeam": true
        },
        {
            "id": "bfbffbce-7933-4a25-844e-b83f167cea0f",
            "name": "Qyzyljar Petropavlovsk 2",
            "club": {
                "id": "57bc7d84-1c31-482e-9292-6f29ab4efc73",
                "name": "QYZYLJAR PETROPAVLOVSK"
            },
            "category": {
                "id": 1,
                "name": "Men"
            },
            "homeTeam": false
        }
    ],
    "stage": {
        "id": "67542d08-59e9-4ecf-b394-75475e815adf",
        "name": "Regular Round",
        "season": {
            "id": "015556d8-06b4-4b3f-b577-1c912c877aaf",
            "name": "2023",
            "startDateUTC": "2023-04-18T12:00:00",
            "endDateUTC": "2023-10-31T12:00:00",
            "competition": {
                "id": "a82f546f-dba2-4485-ba3f-59632bf1158e",
                "name": "Kazakhstan 2nd Division",
                "type": "Official",
                "category": {
                    "id": 1,
                    "name": "Men"
                },
                "tour": {
                    "id": 67,
                    "name": "European Leagues"
                },
                "location": {
                    "name": "Kazakhstan",
                    "country": {},
                    "continent": {
                        "name": "Asia"
                    }
                },
                "latestComment": "COVERAGE LEVEL CHANGE - Soccer - Kazakhstan 2nd Division - 24/08/2023, 11:00 UTC - Ulytau v Shakhtar Karagandy 2 - CL1 to CL3 (d6a8948a-9d83-4ed9-b646-77b6903891c8).",
                "commentCount": 103
            }
        },
        "startDateUTC": "2023-04-18T12:00:00",
        "endDateUTC": "2023-10-31T12:00:00"
    },
    "group": {
        "id": "7ba09936-9f9f-442c-8c3a-cc52745f103a",
        "name": "NORTH EAST",
        "stageId": "67542d08-59e9-4ecf-b394-75475e815adf"
    },
    "venue": {
        "id": "9d8af49b-5abb-4c77-810d-0233e26addfc",
        "name": "Futbolniy Manezh",
        "location": {
            "name": "Satbayev",
            "country": {
                "name": "Kazakhstan"
            },
            "continent": {
                "name": "Asia"
            }
        }
    },
    "fixtureSummary": {
        "isTied": true,
        "periods": [
            {
                "id": 1,
                "end": null,
                "type": "Regular",
                "label": "1st half",
                "start": "2023-08-09T11:01:07",
                "awayTeamScore": 0,
                "homeTeamScore": 0,
                "awayTeamPeriodScore": 0,
                "homeTeamPeriodScore": 0
            }
        ],
        "finished": true,
        "awayTeamScore": 0,
        "currentPeriod": 1,
        "currentStatus": "Unverified",
        "homeTeamScore": 0,
        "collectionStatus": "CollectionDropped",
        "currentClockTime": "34:06",
        "isHomeTeamInPossesion": false
    },
    "usages": [
        "Fastpath"
    ]
}
```
</code></pre>

</details>

| **Coverage Levels**         | **Fixture Status** | Fixture status definition                                                                                       | **Collection Status**    | Collection status definition                                                                                                                                                                                                           |
| --------------------------- | ------------------ | --------------------------------------------------------------------------------------------------------------- | ------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 0 No coverage               | 0. Scheduled       | fixture is scheduled to be played (default for new fixtures)                                                    | 0. Collection Scheduled  | fixture was scheduled for data collection (default for new fixtures)                                                                                                                                                                   |
| 1 In venue (live)           | 1. Live            | fixture is currently being played                                                                               | 1. Collecting Live       | a scorer is currently collecting this fixture as it is happening                                                                                                                                                                       |
| 2 Low latency stream (live) | 2. Completed       | fixture has finished                                                                                            | 2. Collecting Post Match | a scorer is currently collecting data from video footage of the fixture. The fixture is most probably finished.                                                                                                                        |
| 3 Standard stream (live)    | 3. Postponed       | fixture will start later than it was originally scheduled                                                       | 3. Collection Suspended  | data collection has been suspended but will be resumed. The reason for suspension may be either a technical issue on site (rest of the data will be collected post-match) or the fixture was suspended and will be resumed in future.  |
| 4 Video (post match)        | 4. Abandoned       | fixture has started but was not finished, it will be replayed again from the start                              | 4. Collection Dropped    | there will be no more data collected for this fixture. This can happen either before the fixture starts (e.g., no scorer available to go to that match) or during the fixture (e.g., technical issues on site that cannot be resolved) |
|                             | 5. Cancelled       | fixture will now not take place at all                                                                          | 5. Collection Completed  | data collection for this fixture is completed but it has not been verified yet. Some changes may still be made.                                                                                                                        |
|                             | 6. Suspended       | fixture was suspended but will be continued later from the point it was stopped (due to darkness, weather etc.) | 6. Post Match Checked    | data has been verified for this fixture and the PostMatchCheckCompleted action has been sent by the supervisor.                                                                                                                        |
|                             | 7. Unverified      | Fixture time is not yet confirmed or we have no data source to tell us if it is live or when it completes       |                          |                                                                                                                                                                                                                                        |
