## Why List Flights For Advertiser

Sometimes you may wish to list all flights associated with a particular advertiser. This can be helpful when working with an advertiser to determine what changes, if any, should be made to improve/optimize the performance of the flights for an advertiser.

For details of the `filter` query parameter, see [List Flights](https://dev.kevel.com/reference/list-flights).

> ### Caution
> If a flight contains ads, only the first 200 ads in the flight will be listed in the response. To view all the ads in a flight, use the [List Ads For Flight](https://dev.adzerk.com/reference/creative-flight-map#list-ads) endpoint.

## API Syntax

When using the _List Flights for Advertiser_ API call, 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/advertiser/{AdvertiserID}/flight`

Where:

- `GET` - the type of API request being made.
- `https://api.kevel.co` - the URL for the request.
- `v1` - the API version.
- `advertiser` - the API endpoint being called.
- `AdvertiserID` - the ID for the advertiser.
- `flight` - the value to return in the request.

### AdvertiserId

- **Type:** int32  
- **Required:** ID of the Advertiser

### filter

- **Type:** string  
- **Enum:** Constrains the set of flights returned. Omission is equivalent to specifying `not-archived`. For details see [List Flights](https://dev.kevel.com/reference/list-flights).

**Allowed:**
- `active`
- `inactive`
- `archived`
- `not-archived`

### excludeAds

- **Type:** boolean  
- **Defaults to:** false  
- **Description:** If true, the endpoint returns only the flight data without ad objects

### Response

#### Status Code 200

```json
{
    "items": [
        {
            "Id": 12345,
            "NoEndDate": null,
            "Price": 0.000,
            "Impressions": 100,
            "IsNoDuplicates": true,
            "DuplicateMode": 4,
            "Keywords": "",
            "Name": "The Great API Flight",
            "WeightOverride": null,
            "IsFreqCap": null,
            "IsCompanion": false,
            "CampaignId": 1234,
            "PriorityId": 1234,
            "IsDeleted": false,
            "IsActive": true,
            "GeoTargeting": null,
            "SiteZoneTargeting": null,
            "CustomTargeting": "",
            "GoalType": 2,
            "RateType": 1,
            "IsECPMOptimized": null,
            "ECPMOptimizePeriod": null,
            "ECPMMultiplier": null,
            "FloorECPM": null,
            "CeilingECPM": null,
            "DefaultECPM": null,
            "ECPMBurnInImpressions": null,
            "EffectiveCPMOverride": null,
            "DatePartingStartTimeISO": null,
            "DatePartingEndTimeISO": null,
            "IsSunday": true,
            "IsMonday": true,
            "IsTuesday": true,
            "IsWednesday": true,
            "IsThursday": true,
            "IsFriday": true,
            "IsSaturday": true,
            "FreqCap": 0,
            "FreqCapDuration": 0,
            "FreqCapType": 0,
            "CapType": 1,
            "DailyCapAmount": null,
            "LifetimeCapAmount": null,
            "DeliveryStatus": 1,
            "CustomFieldsJson": null,
            "BehavioralTargeting": null,
            "IsTargetingOptimization": null,
            "TargetingOptimizationType": null,
            "TargetingOptimizationTargetType": null,
            "TargetingOptimizationTarget": null,
            "TargetingOptimizationBurnIn": null,
            "TargetingOptimizationCanMiss": null,
            "IsArchived": null,
            "CanPassback": true,
            "PassbackSortOrder": 1,
            "StartDateISO": "2017-06-08T00:00:00.0000000",
            "EndDateISO": "2017-12-08T00:00:00.0000000",
            "Created": "2022-03-08T12:34:56.123Z",
            "LastModified": "2022-03-08T12:34:56.123Z",
            "Version": 4
        }
    ],
    "page": 1
}
```