# Availability for specific delivery date

This endpoint provides available stock quantities over facilities for items on a specific delivery date. This information can be used to determine the availability of certain products for a delivery day selected by the customer.

{% hint style="info" %}
More API information can be found here: [REST API documentation – checkoutoptions/delivery/timepoint](https://fulfillmenttools.github.io/fulfillmenttools-api-reference-ui/#post-/api/promises/checkoutoptions/delivery/timepoint)
{% endhint %}

## Request and response

### **Request**

* **`desiredDeliveryDate:`** Date when the items should arrive at the customer.
* **`tenantArticleIds`:** Contains all `tenantArticleIds` that the customer is interested in buying.
* **`facilityRef`:** Contains facilities that should be considered for the delivery.
* **`latestPickingStart`:** This is the point in time at which the picking for the delivery must be started in order to be delivered to the customer on time. If the latest possible picking start for a certain delivery date in a facility is not known, it can be requested via the [Checkout Options endpoint](https://fulfillmenttools.github.io/fulfillmenttools-api-reference-ui/#post-/api/promises/checkoutoptions). Systems then calculate the [latest picking start](https://docs.fulfillmenttools.com/documentation/by-pillar/store-operations/picking/latest-picking-start) based on [cut-off time](https://docs.fulfillmenttools.com/documentation/by-pillar/availability-and-promising/broken-reference) of carriers and [fulfillment process buffer](https://docs.fulfillmenttools.com/documentation/getting-started/facilities#managed-facilities)​.

### **Response**

The response lists the available quantity for all requested items and facilities. Facility / item combinations with zero availability are included.

{% hint style="info" %}
[Expected stocks](https://docs.fulfillmenttools.com/documentation/by-pillar/global-inventory-hub/stock/expected-stock-in-availability) that were announced via [purchase order](https://docs.fulfillmenttools.com/documentation/by-pillar/global-inventory-hub/inbound-process/purchase-order) are also considered in the response. Only purchase orders with `requestedDate.type` "ASAP" are not considered as these deliveries are expected to arrive as soon as possible and there is no exact date that can be used to check the potential availability of these stocks for incoming orders.
{% endhint %}

**Example response**

```json
{
    "items": [
        {
            "facilityRef": "cgn-01",
            "tenantArticleId": "0631",
            "available": 300
        },
        {
            "facilityRef": "cgn-01",
            "tenantArticleId": "2027",
            "available": 200
        },
        {
            "facilityRef": "dus-01",
            "tenantArticleId": "06031",
            "available": 4
        },
        {
            "facilityRef": "dus-01",
            "tenantArticleId": "2027",
            "available": 0
        }
    ]
}
```

## Get delivery timepoint

> This endpoint is to be used to get information about the possible delivery of items.

```json
{"openapi":"3.0.1","info":{"title":"fulfillmenttools","version":"VERSIONLESS"},"tags":[{"description":"Endpoints used by shops to get the current available pickup stores and available service levels like Same-Day delivery.","name":"Checkout Options (DOMS)"}],"servers":[{"url":"https://{tenant}.api.fulfillmenttools.com","variables":{"tenant":{"default":"your-tenant-name"}}}],"security":[{"BearerToken":[]}],"components":{"securitySchemes":{"BearerToken":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"CheckoutOptionsDeliveryTimePointRequest":{"properties":{"desiredDeliveryDate":{"description":"Desired delivery date-time","format":"date-time","type":"string"},"facilities":{"description":"Facilities with latest picking start constraints","items":{"$ref":"#/components/schemas/FacilityRefLatestPickingStartPair"},"type":"array"},"tenantArticleIds":{"description":"Tenant article IDs","items":{"type":"string"},"type":"array"}},"required":["desiredDeliveryDate","tenantArticleIds","facilities"],"title":"CheckoutOptionsDeliveryTimePointRequest","type":"object","description":"CheckoutOptionsDeliveryTimePointRequest"},"FacilityRefLatestPickingStartPair":{"properties":{"facilityRef":{"description":"Facility reference","type":"string"},"latestPickingStart":{"description":"Latest picking start date-time","format":"date-time","type":"string"}},"required":["facilityRef","latestPickingStart"],"title":"FacilityRefLatestPickingStartPair","type":"object","description":"FacilityRefLatestPickingStartPair"},"CheckoutOptionsDeliveryTimePointResponse":{"properties":{"items":{"description":"Availability per article and facility","items":{"$ref":"#/components/schemas/CheckoutOptionsDeliveryTimePointResponseItem"},"type":"array"}},"required":["items"],"title":"CheckoutOptionsDeliveryTimePointResponse","type":"object","description":"CheckoutOptionsDeliveryTimePointResponse"},"CheckoutOptionsDeliveryTimePointResponseItem":{"properties":{"available":{"description":"Available quantity","type":"number"},"facilityRef":{"description":"Facility reference","type":"string"},"latestPickingStart":{"description":"Latest picking start date-time","format":"date-time","type":"string"},"tenantArticleId":{"description":"Tenant article ID","type":"string"}},"required":["tenantArticleId","available","facilityRef"],"title":"CheckoutOptionsDeliveryTimePointResponseItem","type":"object","description":"CheckoutOptionsDeliveryTimePointResponseItem"},"ApiError":{"items":{"$ref":"#/components/schemas/ErrorInner"},"type":"array","xml":{"name":"ApiError"},"title":"ApiError","description":"ApiError"},"ErrorInner":{"properties":{"description":{"type":"string"},"requestVersion":{"description":"The version provided within an invalid request.","format":"int64","type":"integer"},"summary":{"type":"string"},"version":{"format":"int64","type":"integer"}},"required":["summary"],"type":"object","title":"ErrorInner","description":"ErrorInner"}}},"paths":{"/api/promises/checkoutoptions/delivery/timepoint":{"post":{"deprecated":false,"description":"This endpoint is to be used to get information about the possible delivery of items.","operationId":"checkoutOptionsTimepoint","parameters":[],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CheckoutOptionsDeliveryTimePointRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CheckoutOptionsDeliveryTimePointResponse"}}},"description":"The request could be evaluated"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"description":"Invalid input. See response for details."},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"description":"Your user is not allowed to operate against this API instance"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"description":"Your user, although recognized, is not authorized to use this"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"description":"The requested entity was not found"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"description":"A version conflict occurred."}},"summary":"Get delivery timepoint","tags":["Checkout Options (DOMS)"]}}}}
```