ETERA API Documentation

Get offers that are applicable to specific items. This checks:

Offers with scopeType “ALL” (applicable to all items of the dataType)
Offers with scopeType “LIMITED” where the item IDs are in the scopeList
Optionally filter by city

Use Case: When displaying a restaurant/experience/hotel, use this endpoint to show applicable offers that users can apply to their order/booking.

Get offers that are applicable to specific items. This checks: - Offers with scopeType "ALL" (applicable to all items of the dataType) - Offers with scopeType "LIMITED" where the item IDs are in the scopeList - Optionally filter by city **Use Case:** When displaying a restaurant/experience/hotel, use this endpoint to show applicable offers that users can apply to their order/booking.

Request

This endpoint expects an object.

itemIdslist of stringsRequired

Array of item IDs to check for applicable offers

dataType"RESTAURANT" or "EXPERIENCE" or "HOTEL"Required

Vertical type

cityIdstringOptional

Optional city ID for city-specific offers

Response

This endpoint returns an object.

object

1	const url = 'https://api.etera.dev/context/offers/applicable';
2	const options = {
3	method: 'POST',
4	headers: {'Content-Type': 'application/json'},
5	body: '{"itemIds":["restaurant-001","restaurant-002"],"dataType":"RESTAURANT"}'
6	};
7
8	try {
9	const response = await fetch(url, options);
10	const data = await response.json();
11	console.log(data);
12	} catch (error) {
13	console.error(error);
14	}

1	{
2	"success": true,
3	"data": {
4	"offers": [
5	null
6	]
7	}
8	}