Fetch a program's estimate
GET/parts/:partId/programs/:programId/estimate
Returns the cost-and-time estimate for a concrete program on the URL part. Returns a 202 with a ProcessingResponse envelope while the engine is still computing, a 200 with a PublicEstimate envelope once the estimate is ready, or 422 if the engine reported an error. Returns 404 if the part or program does not exist, belongs to a different team, or the program is not on that part.
The optional timings query param selects the estimate variant:
fast(default): the heuristic estimate, always available once the program is ready.refined: the simulation-based estimate, which may still be processing afterfastis ready.
Request
Responses
- 200
- 202
- 400
- 401
- 404
- 422
- 429
- 500
Estimate is ready
Estimate is still being computed by the Engine
Invalid request
Missing or invalid bearer token
Resource not found
The request was well-formed but could not be processed (e.g. the engine could not compute an estimate).
Rate limit exceeded
Response Headers
Seconds to wait before retrying. Guaranteed on application-limited responses (POST /parts and POST /parts/{partId}/programs); may be absent on infrastructure-level 429s from other endpoints.
Unexpected server error