---
title: "POST /p2p-delivery/occupancy/candidate-shipping-windows"
method: POST
path: "/p2p-delivery/occupancy/candidate-shipping-windows"
tags: ["p2p-delivery"]
---

# POST /p2p-delivery/occupancy/candidate-shipping-windows

`POST /p2p-delivery/occupancy/candidate-shipping-windows`

## Request

- Base URL: `https://api.ganje.net/v1.1`
- URL: `https://api.ganje.net/v1.1/p2p-delivery/occupancy/candidate-shipping-windows`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/ganje/apis/ganje-external-api/docs/p2p-delivery/occupancy/candidate-shipping-windows/post.ts> (a function with typed inputs; its response is checked against the schema)

## Request body

- object
  - `origin_station` string, uuid
  - `origin_address` object
    - `city_id` integer, required
    - `full_address` string, required
    - `latitude` number
    - `longitude` number
  - `sender_person` object
    - `firstname` string, required
    - `lastname` string, required
    - `phone_number` string, required
  - `recipient_person` object, required
    - `firstname` string, required
    - `lastname` string, required
    - `phone_number` string, required
  - `destination_address` object, required
    - `city_id` integer, required
    - `full_address` string, required
    - `latitude` number
    - `longitude` number
  - `logistic_company` string, uuid, required
  - `parcels` object[], required
    - `dimension` object, required
      - `width` number, required: In meter
      - `height` number, required: In meter
      - `length` number, required: In meter
    - `weight` integer, nullable, required: Parcel Weight - unit: Gram
    - `value` number, nullable, required: Parcel Value for Using in Insurance - unit: Rial
    - `submitter_id` string
    - `packaging_type` 'box' | 'packet'
    - `characteristics` 'gold' | 'normal'
  - `pod` string
  - `ready_time` string, date-time
  - `off_day_dates` string[]

## Response `201`

Created

- object
  - `origin_station` string, uuid
  - `origin_address` object
    - `city_id` integer, required
    - `full_address` string, required
    - `latitude` number
    - `longitude` number
  - `sender_person` object
    - `firstname` string, required
    - `lastname` string, required
    - `phone_number` string, required
  - `recipient_person` object, required
    - `firstname` string, required
    - `lastname` string, required
    - `phone_number` string, required
  - `destination_address` object, required
    - `city_id` integer, required
    - `full_address` string, required
    - `latitude` number
    - `longitude` number
  - `logistic_company` string, uuid, required
  - `parcels` object[], required
    - `dimension` object, required
      - `width` number, required: In meter
      - `height` number, required: In meter
      - `length` number, required: In meter
    - `weight` integer, nullable, required: Parcel Weight - unit: Gram
    - `value` number, nullable, required: Parcel Value for Using in Insurance - unit: Rial
    - `submitter_id` string
    - `packaging_type` 'box' | 'packet'
    - `characteristics` 'gold' | 'normal'
  - `pod` string
  - `ready_time` string, date-time
  - `off_day_dates` string[]

---

[API](https://skmtc.dev/ganje/apis/ganje-external-api.md) - [All operations](https://skmtc.dev/ganje/apis/ganje-external-api/llms.txt) - [OpenAPI document](https://skmtc.dev/ganje/apis/ganje-external-api/revisions/709eb3fdf716?raw)