Skip to main content
POST
Recalculate Hotel Stays

Recalculate Hotel Stays

Enqueue EF-config recalculation for a set of hotel stays. The endpoint returns 202 Accepted immediately and creates one ProcessingJob per requested activity category.
All hotel stay IDs must belong to the caller’s organization. IDs that don’t match are silently dropped.

Request

Headers

string
required
Your API key for authenticationExample: sk_live_1234567890abcdef
string
required
Your organization UUIDExample: ff4adcc7-8172-45fe-9cf1-e90a6de53aa9

Body Parameters

array of strings
required
One or more hotel stay UUIDs to recalculate. Must be non-empty. Maximum 5000 IDs.Example: ["a1b2c3d4-...", "e5f6g7h8-..."]
array of strings
required
Activity categories to recalculate. Must be non-empty. Duplicates are silently deduplicated.Allowed values:
  • hotel_stays — Scope 3 hotel stay emissions
Example: ["hotel_stays"]

Response

array of strings
UUIDs of the hotel stays that were enqueued (after organization scoping).
integer
Number of hotel stays enqueued.
array of strings
One ProcessingJob UUID per dispatched activity category.

Example

Successful Response

Common Errors

401 Unauthorized

Cause: Missing or invalid API key

403 Forbidden

Cause: The authenticated user is not a member of the organization

422 Unprocessable Entity

Cause: Invalid activity category

List Hotel Stays

Retrieve hotel stays to find IDs for recalculation

Impact Calculation

View the emission calculation breakdown