---
title: "GetClosedFlights | Bulk Availability | پرواز | مستندات وب سرویس سپهر"
---
# bulk-availability



## متد GetClosedFlights

این متد برای بدست آوردن پروازهای عدم موجود و Close شده یک تامین کننده استفاده می شود.

استفاده از این متد اختیاری می باشد.

کاربر این متد برای زمانی است که شما می خواهید پروازهای Close شده را به مسافر خود نمایش دهید.

<br>

API Endpoint

```http
POST https://{SupplierWebsiteUrl}/api/Partners/Flight/BulkAvailability/V18/GetClosedFlights
```

<br>

## Request Parameters

- `Username`

  string

  required

  نام کاربری

  در صورتی که شما یک موتور جستجو هستید و قصد فروش نداشته و فقط می خواهید اطلاعات پروازهای عمومی را بدست آورید، نام کاربری را public ارسال نمایید.

- `Password`

  string

  required

  رمز عبور به صورت MD5 شده

- `FromDate`

  string

  required

  تاریخ شروع برای فیلتر کردن پروازها با فرمت yyyy-MM-dd میلادی.

- `ToDate`

  string

  required

  تاریخ پایان برای فیلتر کردن پروازها با فرمت yyyy-MM-dd میلادی.

- `FlightSource`

  string enum

  required

  این فیلد تعیین می‌کند که درخواست شما چه نوع پروازهایی را برگرداند. مقدار این فیلد می‌تواند یکی از گزینه‌های زیر باشد:

  All

  تمامی پروازهای موجود (چه متعلق به تأمین‌کننده مورد درخواست و چه دریافت‌شده از سایر تأمین‌کنندگان).

  OwnedFlight

  فقط پروازهایی که تأمین‌کننده‌ای که به آن درخواست ارسال کرده‌اید مالک نرخ و ظرفیت آن‌هاست.

  ThirdPartyFlight

  فقط پروازهایی که تأمین‌کننده مورد درخواست، مالک نرخ و ظرفیت آن‌ها نیست و آن‌ها را از طریق وب‌سرویس از تأمین‌کننده دیگری دریافت کرده است (پروازهای وب سرویسی یا واسطه‌ای).

  در زمان استفاده از سپهرهاب، مقدار این فیلد باید All یا ThirdPartyFlight ارسال شود.

- `Culture`

  string enum

  required

  مشخص‌کننده زبان متن‌های بازگشتی در پاسخ سرویس. مقادیر پذیرفته شده عبارتند از: fa-IR ، en-US و ar-IQ

<br>

## Sample Request

```curl
curl -X POST https://SepehrApiTest.ir/api/Partners/Flight/BulkAvailability/V18/GetClosedFlights \
  -H "Content-Type: application/json; charset=utf-8" \
  -H "Accept: application/json" \
  -H "Accept-Encoding: gzip, deflate" \
  -d '{
    "UserName": "testdev1",
    "Password": "25f9e794323b453885f5181f1b624d0b",
    "FromDate": "2026-05-26",
    "ToDate": "2027-05-29",
    "FlightSource": "All",
    "Culture": "fa-IR"
}'
```

<br>

## Response Parameters

- `ClosedFlightList`

  List of ClosedFlight

  لیستی از پروازهای Close

  - `ClosedFlightList.FlightNumber`

    string

    شماره پرواز

  - `ClosedFlightList.DepartureDateTime`

    string

    تاریخ پرواز با فرمت yyyy-MM-dd HH:mm به زمان محلی مبدا

  - `ClosedFlightList.Origin`

    Complex type

    کد یاتای سه حرفی فرودگاه مبدا

  - `ClosedFlightList.Destination`

    Complex type

    کد یاتای سه حرفی فرودگاه مقصد

  - `ClosedFlightList.Aircraft`

    string

    کد یاتای نوع هواپیما.

    جهت مشاهده کد یاتا انواع هواپیما [اینجا کلیک نمایید](https://en.wikipedia.org/wiki/List_of_aircraft_type_designators)

  - `ClosedFlightList.ArrivalDateTime`

    string

    زمان رسیدن پرواز به مقصد با فرمت yyyy-MM-dd HH:mm به زمان محلی مقصد

  - `ClosedFlightList.Duration`

    number

    طول مدت پرواز بر حسب دقیقه

    در صورتی که در سیستم خود طول مدت پرواز را نمایش می دهید، بهتر است به جای بدست آوردن تفاوت بین DepartureDateTime و ArrivalDateTime، از مقدار این فیلد استفاده نمایید. زیرا بدست آوردن تفاوت بر اساس DepartureDateTime و ArrivalDateTime نیازمند در نظر گرفتن ناحیه زمانی مبدا و مقصد بوده و یا حتی در مواردی که مبدا و مقصد یکسان بوده ولی ساعت ها تغییر کنند (مانند اول فروردین یا اول مهرماه) بدست آوردن این تفاوت، نیازمند عملیات پیچیده است. بنابراین بهتر است از مقدار این فیلد استفاده نمایید.

  - `ClosedFlightList.Airline`

    string

    کد یاتا ایرلاین

  - `ClosedFlightList.Remarks`

    string

    اگر تامین کننده توضیحاتی در خصوص این پرواز ثبت کرده باشد، این توضیحات به صورت متن در این فیلد خروجی داده می شود.

    عموما شما نیازی به استفاده از این فیلد نخواهید داشت و می توانید آن را نادیده بگیرید.

  - `ClosedFlightList.Source`

    string enum

    این فیلد نشان می‌دهد پروازِ برگردانده‌شده از چه نوع منبعی تأمین شده است (از نظر مالکیت نرخ و ظرفیت). مقدار این فیلد یکی از گزینه‌های زیر است:

    Owned

    تأمین‌کننده‌ای که به آن درخواست داده‌اید، مالک مستقیمِ نرخ و ظرفیت این پرواز است؛ یعنی یا خودِ ایرلاین است که پرواز را در سیستم رزرواسیون سپهر ایجاد کرده، یا چارترکننده اصلی.

    ThirdParty

    تأمین‌کننده‌ای که به آن درخواست داده‌اید، مالک نرخ و ظرفیت این پرواز نیست و صرفاً نقش واسط دارد؛ یعنی پرواز را از طریق وب‌سرویس از تأمین‌کننده دیگری دریافت کرده و ارائه می‌کند.

  - `ClosedFlightList.Stop1`

    Complex type

    در صورتی که پرواز دارای Stop باشد، اطلاعات اولین توقف در این فیلد خروجی داده خواهد شد.

    در پروازهای Stop دار، در زمان توقف، مسافر از هواپیما پیاده نشده و همچنین نیازی به جابجایی بار نیست. معمولا این گونه توقف ها بابت پیاده یا سوار کردن مسافران جدید یا سوخت گیری انجام می پذیرد. و در هر صورتی مسافران قبلی در زمان توقف در هواپیما باقی مانده و نیازی به ترک هواپیما نمی باشد.

    - `ClosedFlightList.Stop1.AirportIataCode`

      string

      کد یاتا فرودگاه محل توقف

    - `ClosedFlightList.Stop1.FlightDurationUntilThisStopInMinute`

      number

      طول مدت پرواز تا رسیدن به فرودگاه محل توقف.

      مقدار این فیلد بر اساس دقیقه می باشد.

    - `ClosedFlightList.Stop1.StopDurationInMinute`

      number

      طول مدت توقف در فرودگاه

      مقدار این فیلد بر اساس دقیقه می باشد.

    - `ClosedFlightList.Stop1.ArrivalDateTime`

      string

      زمان ورود به فرودگاه محل توقف

      بر اساس زمان محلی و با فرمت yyyy-MM-dd HH:mm

    - `ClosedFlightList.Stop1.DepartureDateTime`

      string

      زمان خروج از فرودگاه محل توقف

      بر اساس زمان محلی و با فرمت yyyy-MM-dd HH:mm

  - `ClosedFlightList.Stop2`

    Complex type

    در صورتی که پرواز دارای بیش از یک Stop باشد، اطلاعات مربوط به توقف دوم توسط این فیلد خروجی داده می شود.

    ساختار فرمت آن مشابه فیلد Stop1 می باشد.

<br>

## Sample Response

```json
{
    "ClosedFlightList": [{
            "FlightNumber": "111",
            "DepartureDateTime": "2026-05-26 12:00",
            "Origin": "MHD",
            "Destination": "THR",
            "Aircraft": "100",
            "ArrivalDateTime": "2026-05-26 13:10",
            "Duration": 70,
            "Airline": "QB",
            "Remarks": "",
            "Source": "Owned",
            "Stop1": null,
            "Stop2": null
        }, {
            "FlightNumber": "513",
            "DepartureDateTime": "2026-05-26 01:30",
            "Origin": "SAW",
            "Destination": "IKA",
            "Aircraft": "M80",
            "ArrivalDateTime": "2026-05-26 05:40",
            "Duration": 220,
            "Airline": "W5",
            "Remarks": "",
            "Source": "Owned",
            "Stop1": null,
            "Stop2": null
        },
        // ... بیشتر پروازها
    ]
}
```

<br>