# Fightcards Schedule Endpoint

This endpoint returns information on the schedule of a particular fightcard. Information returned includes: Detailed information on the fighters of each team, Estimated start time, Fighter Records & Weight class.

## **Endpoint URLs**

| `https://dde-api.data.imgarena.com/mma/fightcards/{id}/schedule` |
| ---------------------------------------------------------------- |

## **Required Headers**

| Key           | Value                                           |
| ------------- | ----------------------------------------------- |
| Accept        | application/vnd.imgarena.dde.api+json;version=1 |
| Content-Type  | application/json                                |
| Authorization | Bearer eyvhaoudfgpdfgo\*                        |

### **Request Parameters**

This endpoint takes no parameters

## **Response Model:**

### **Fightcard Schedule Object**

| Field Name    | Type    | Description                                                                                                                                                                                                 |
| ------------- | ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| startTime     | object  | an object containing “status” – the status of the start time, e.g. EstimatedStart, and “time”, the estimated start time, in local + UTC offset format                                                       |
| weightClass   | object  | An object containing information on the weight class                                                                                                                                                        |
| referee       | object  | Contains ID, First and last name of the referee for the fight.                                                                                                                                              |
| startTimeText | string  | Text description of the start time. Note that the start time object contains detailed information about the start and is likely to be more useful than this field. Main values; Starts At, Follows Previous |
| fightOrder    | integer | The fight’s order on the card. Fight number 1 is the main event, 2 is the co-main event and so on, so that the first fight of the night has the highest number. The main event is always 1                  |
| fightcardId   | integer | the ID of the fightcard in which the fight is in                                                                                                                                                            |
| accolades     | object  | An object containing information on the belt & the name of the belt title                                                                                                                                   |
| fightSeq      | integer | The fight sequence on the overall fightcard. 1 if first, 2 if second etc.                                                                                                                                   |
| redTeam       | object  | An object containing information on the fighter of the red team                                                                                                                                             |
| Date          | string  | the date of the fight                                                                                                                                                                                       |
| blueTeam      | object  | An object containing information on the fighter of the blue team                                                                                                                                            |
| status        | string  | the status of the fight. Possible values; “Not Started”, “In Progress” or “Finished”                                                                                                                        |
| cardSegment   | string  | The segment of the card that this fight belongs to. Options; main, prelims1, prelims2                                                                                                                       |
| fightId       | string  | The ID number of the fight                                                                                                                                                                                  |
| fightType     | object  | Contains information on the type of fight, total number of possible rounds                                                                                                                                  |
| bookingStatus | object  | information on whether or not a fight is booked                                                                                                                                                             |

### **startTime Object**

| Field Name | Type   | Description                                            |
| ---------- | ------ | ------------------------------------------------------ |
| status     | string | Status of the current start time e.g. "EstimatedStart" |
| time       | string | The start time of the fight + UTC offset format        |

### **Weightclass Object**

| Field Name   | Type    | Description                                                             |
| ------------ | ------- | ----------------------------------------------------------------------- |
| weight       | string  | the weight range, in lb, of the weightclass                             |
| description  | string  | description of the weightclass                                          |
| id           | integer | ID of the weightclass                                                   |
| obsolete     | Boolean | Details whether the weightclass is still active within the organisation |
| abbreviation | string  | abbreviated description of the weightclass                              |

### **Referee Object**

| Field Name | Type    | Description                   |
| ---------- | ------- | ----------------------------- |
| id         | integer | the ID of the referee         |
| firstName  | string  | the first name of the referee |
| lastName   | string  | the last name of the referee  |

### **Accolades Object**

| Field Name | Type   | Description           |
| ---------- | ------ | --------------------- |
| belt       | string | the type of belt      |
| name       | string | the title of the belt |

### **Red Team Object**

| Field Name | Type   | Description                                                               |
| ---------- | ------ | ------------------------------------------------------------------------- |
| fighter1   | object | detailed information on the fighter under the red team                    |
| rank       | string | the fighters current rank. (may appear null if the fighter is not ranked) |
| accolades  | object | -                                                                         |

### **fighter1 Object**

| Field Name    | Type    | Description                                                                                            |
| ------------- | ------- | ------------------------------------------------------------------------------------------------------ |
| reach         | decimal | the reach, in inches, of the fighter. Will be null if unknown.                                         |
| dob           | date    | the date of birth of the fighter                                                                       |
| fightsOutOf   | string  | the city, state, country, country code of where the fighter currently fights out of                    |
| height        | integer | the height, in inches, of the fighter. Will be null if unknown.                                        |
| country       | string  | country code of the fighter                                                                            |
| age           | integer | the age of the fighter                                                                                 |
| weighInWeight | float   | the weigh in weight, in lb, of the fighter. Will be null if unknown.                                   |
| lastName      | string  | the last name of the fighter                                                                           |
| stance        | string  | the stance of the fighter. Possible values; Orthodox, Southpaw, Switch, Open. Will be null if unknown. |
| firstName     | string  | the first name of the fighter                                                                          |
| nickName      | string  | the nickname of the fighter                                                                            |
| id            | integer | the id of the fighter                                                                                  |
| born          | string  | the city, state, country, country code of where the fighter was born                                   |
| record        | object  | win/loss/draw/no contest record of the fighter                                                         |
| accolades     | string  | will be null unless a title holder. If not null, will explain what title the fighter holds.            |

### Record Object

| Field Name | Type    | Description                                                         |
| ---------- | ------- | ------------------------------------------------------------------- |
| wins       | integer | the amount of professional wins a fighter has                       |
| losses     | integer | the amount of professional losses a fighter has                     |
| draws      | integer | the amount of professional draws a fighter has                      |
| noContest  | integer | the number of professional contests the fighter has participated in |

### **Blue Team Object**

| Field Name | Type   | Description                                                               |
| ---------- | ------ | ------------------------------------------------------------------------- |
| fighter1   | object | detailed information on the fighter under the blue team                   |
| rank       | string | the fighters current rank. (may appear null if the fighter is not ranked) |
| accolades  | object | appears to be null- even for champions                                    |

### **fightType Object**

| Field Name     | Type    | Description                         |
| -------------- | ------- | ----------------------------------- |
| possibleRounds | integer | the number of possible rounds       |
| description    | string  | description on the number of rounds |

### bookingStatus Object

| Field Name | Type   | Description |
| ---------- | ------ | ----------- |
| status     | string | -           |

## Sample Response

```
    {
        "startTime": {
            "status": "EstimatedStart",
            "time": "04:00Z"
        },
        "weightClass": {
            "weight": "156-170",
            "description": "Welterweight",
            "id": 16,
            "obsolete": false,
            "abbreviation": "WW"
        },
        "referee": null,
        "startTimeText": "Follows Previous",
        "fightOrder": 1,
        "fightcardId": 758,
        "accolades": null,
        "fightSeq": 13,
        "redTeam": {
            "fighter1": {
                "reach": 75.0,
                "dob": "1994-05-01",
                "fightsOutOf": "Chechnya, RUS",
                "height": 74,
                "country": "RUS",
                "age": 28,
                "weighInWeight": null,
                "lastName": "Chimaev",
                "stance": "ORTHODOX",
                "firstName": "Khamzat",
                "nickName": "Borz",
                "id": 3457,
                "born": "Benoy-Yurt, Chechnya, RUS",
                "record": {
                    "wins": 11,
                    "losses": 0,
                    "draws": 0,
                    "noContests": 0
                }
            },
            "rank": 3,
            "accolades": null
        },
        "date": "2022-09-10",
        "blueTeam": {
            "fighter1": {
                "reach": 76.0,
                "dob": "1985-04-16",
                "fightsOutOf": "Stockton, California, USA",
                "height": 72,
                "country": "USA",
                "age": 37,
                "weighInWeight": null,
                "lastName": "Diaz",
                "stance": "SOUTHPAW",
                "firstName": "Nate",
                "nickName": null,
                "id": 274,
                "born": "Stockton, California, USA",
                "record": {
                    "wins": 21,
                    "losses": 13,
                    "draws": 0,
                    "noContests": 0
                }
            },
            "rank": null,
            "accolades": null
        },
        "status": "Upcoming",
        "cardSegment": "main",
        "fightId": 7399,
        "fightType": {
            "possibleRounds": 5,
            "description": "5 Rnd (5-5-5-5-5)"
        },
        "bookingStatus": {
            "status": "AutoBooked"
        }
    },
```
