{"openapi":"3.1.0","info":{"title":"A Natural Endeavor API","version":"1.0.0","description":"Read-only, source-traceable US supplement label facts and deterministic quantity comparison. This API does not provide medical advice."},"servers":[{"url":"https://anaturalendeavor.com"}],"paths":{"/api/v1/supplement-labels":{"get":{"operationId":"search_supplement_labels","summary":"Search published US supplement label snapshots","description":"Search label candidates by product or brand name. Use when a caller needs stable candidate IDs before reading or comparing labels. Do not use it to infer that an unmatched product does not exist, to search non-US markets, or to obtain medical advice. Returns actual published US snapshot candidates, source references, match fields, and ambiguity status. Anonymous quota: one record unit per request; limit 50 candidates.","tags":["Supplement label intelligence"],"security":[{},{"bearerApiKey":[]}],"parameters":[{"name":"query","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":120}},{"name":"market","in":"query","schema":{"type":"string","default":"US"}},{"name":"brand","in":"query","schema":{"type":"string","maxLength":120}},{"name":"market_status","in":"query","schema":{"type":"string","enum":["on_market","off_market","all"],"default":"all"}},{"name":"cursor","in":"query","schema":{"type":"string","maxLength":256}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":50,"default":10}}],"responses":{"200":{"description":"Successful read","content":{"application/json":{"schema":{"type":"object","required":["success","schema_version","request_id","result","sources","coverage","freshness","cache","limitations","next_actions","generated_at"],"properties":{"success":{"const":true},"schema_version":{"type":"string","example":"1.0.0"},"request_id":{"type":"string","format":"uuid"},"result":{"type":"object","additionalProperties":true},"sources":{"type":"array","items":{"type":"object","additionalProperties":true}},"coverage":{"anyOf":[{"type":"object","additionalProperties":true},{"type":"null"}]},"freshness":{"type":"object","additionalProperties":true},"cache":{"type":"object","additionalProperties":true},"limitations":{"type":"array","items":{"type":"string"}},"next_actions":{"type":"array","maxItems":3,"items":{"type":"object","additionalProperties":true}},"generated_at":{"type":"string","format":"date-time"}}}}}},"400":{"description":"Invalid request syntax","content":{"application/json":{"schema":{"type":"object","required":["success","schema_version","error","generated_at"],"properties":{"success":{"const":false},"schema_version":{"type":"string"},"error":{"type":"object","required":["code","message","details","retryable","retry_after_seconds","request_id"],"properties":{"code":{"type":"string","enum":["INVALID_INPUT","UNSUPPORTED_MARKET","AMBIGUOUS_PRODUCT","LABEL_NOT_FOUND","INCOMPARABLE_BASIS","INSUFFICIENT_LABEL_INFORMATION","SOURCE_UNAVAILABLE","RIGHTS_NOT_APPROVED","RATE_LIMITED","AUTHENTICATION_FAILED","AUTHORIZATION_FAILED","INTERNAL_ERROR"]},"message":{"type":"string"},"details":{},"retryable":{"type":"boolean"},"retry_after_seconds":{"type":["integer","null"]},"request_id":{"type":"string","format":"uuid"}}},"generated_at":{"type":"string","format":"date-time"}}}}}},"401":{"description":"Invalid or expired Bearer API key","content":{"application/json":{"schema":{"type":"object","required":["success","schema_version","error","generated_at"],"properties":{"success":{"const":false},"schema_version":{"type":"string"},"error":{"type":"object","required":["code","message","details","retryable","retry_after_seconds","request_id"],"properties":{"code":{"type":"string","enum":["INVALID_INPUT","UNSUPPORTED_MARKET","AMBIGUOUS_PRODUCT","LABEL_NOT_FOUND","INCOMPARABLE_BASIS","INSUFFICIENT_LABEL_INFORMATION","SOURCE_UNAVAILABLE","RIGHTS_NOT_APPROVED","RATE_LIMITED","AUTHENTICATION_FAILED","AUTHORIZATION_FAILED","INTERNAL_ERROR"]},"message":{"type":"string"},"details":{},"retryable":{"type":"boolean"},"retry_after_seconds":{"type":["integer","null"]},"request_id":{"type":"string","format":"uuid"}}},"generated_at":{"type":"string","format":"date-time"}}}}}},"403":{"description":"Authenticated identity lacks the required scope","content":{"application/json":{"schema":{"type":"object","required":["success","schema_version","error","generated_at"],"properties":{"success":{"const":false},"schema_version":{"type":"string"},"error":{"type":"object","required":["code","message","details","retryable","retry_after_seconds","request_id"],"properties":{"code":{"type":"string","enum":["INVALID_INPUT","UNSUPPORTED_MARKET","AMBIGUOUS_PRODUCT","LABEL_NOT_FOUND","INCOMPARABLE_BASIS","INSUFFICIENT_LABEL_INFORMATION","SOURCE_UNAVAILABLE","RIGHTS_NOT_APPROVED","RATE_LIMITED","AUTHENTICATION_FAILED","AUTHORIZATION_FAILED","INTERNAL_ERROR"]},"message":{"type":"string"},"details":{},"retryable":{"type":"boolean"},"retry_after_seconds":{"type":["integer","null"]},"request_id":{"type":"string","format":"uuid"}}},"generated_at":{"type":"string","format":"date-time"}}}}}},"404":{"description":"Published resource not found","content":{"application/json":{"schema":{"type":"object","required":["success","schema_version","error","generated_at"],"properties":{"success":{"const":false},"schema_version":{"type":"string"},"error":{"type":"object","required":["code","message","details","retryable","retry_after_seconds","request_id"],"properties":{"code":{"type":"string","enum":["INVALID_INPUT","UNSUPPORTED_MARKET","AMBIGUOUS_PRODUCT","LABEL_NOT_FOUND","INCOMPARABLE_BASIS","INSUFFICIENT_LABEL_INFORMATION","SOURCE_UNAVAILABLE","RIGHTS_NOT_APPROVED","RATE_LIMITED","AUTHENTICATION_FAILED","AUTHORIZATION_FAILED","INTERNAL_ERROR"]},"message":{"type":"string"},"details":{},"retryable":{"type":"boolean"},"retry_after_seconds":{"type":["integer","null"]},"request_id":{"type":"string","format":"uuid"}}},"generated_at":{"type":"string","format":"date-time"}}}}}},"422":{"description":"Unsupported market, basis, or incomparable data","content":{"application/json":{"schema":{"type":"object","required":["success","schema_version","error","generated_at"],"properties":{"success":{"const":false},"schema_version":{"type":"string"},"error":{"type":"object","required":["code","message","details","retryable","retry_after_seconds","request_id"],"properties":{"code":{"type":"string","enum":["INVALID_INPUT","UNSUPPORTED_MARKET","AMBIGUOUS_PRODUCT","LABEL_NOT_FOUND","INCOMPARABLE_BASIS","INSUFFICIENT_LABEL_INFORMATION","SOURCE_UNAVAILABLE","RIGHTS_NOT_APPROVED","RATE_LIMITED","AUTHENTICATION_FAILED","AUTHORIZATION_FAILED","INTERNAL_ERROR"]},"message":{"type":"string"},"details":{},"retryable":{"type":"boolean"},"retry_after_seconds":{"type":["integer","null"]},"request_id":{"type":"string","format":"uuid"}}},"generated_at":{"type":"string","format":"date-time"}}}}}},"429":{"description":"Rate limit exceeded","headers":{"Retry-After":{"schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["success","schema_version","error","generated_at"],"properties":{"success":{"const":false},"schema_version":{"type":"string"},"error":{"type":"object","required":["code","message","details","retryable","retry_after_seconds","request_id"],"properties":{"code":{"type":"string","enum":["INVALID_INPUT","UNSUPPORTED_MARKET","AMBIGUOUS_PRODUCT","LABEL_NOT_FOUND","INCOMPARABLE_BASIS","INSUFFICIENT_LABEL_INFORMATION","SOURCE_UNAVAILABLE","RIGHTS_NOT_APPROVED","RATE_LIMITED","AUTHENTICATION_FAILED","AUTHORIZATION_FAILED","INTERNAL_ERROR"]},"message":{"type":"string"},"details":{},"retryable":{"type":"boolean"},"retry_after_seconds":{"type":["integer","null"]},"request_id":{"type":"string","format":"uuid"}}},"generated_at":{"type":"string","format":"date-time"}}}}}},"503":{"description":"Data dependency not ready","content":{"application/json":{"schema":{"type":"object","required":["success","schema_version","error","generated_at"],"properties":{"success":{"const":false},"schema_version":{"type":"string"},"error":{"type":"object","required":["code","message","details","retryable","retry_after_seconds","request_id"],"properties":{"code":{"type":"string","enum":["INVALID_INPUT","UNSUPPORTED_MARKET","AMBIGUOUS_PRODUCT","LABEL_NOT_FOUND","INCOMPARABLE_BASIS","INSUFFICIENT_LABEL_INFORMATION","SOURCE_UNAVAILABLE","RIGHTS_NOT_APPROVED","RATE_LIMITED","AUTHENTICATION_FAILED","AUTHORIZATION_FAILED","INTERNAL_ERROR"]},"message":{"type":"string"},"details":{},"retryable":{"type":"boolean"},"retry_after_seconds":{"type":["integer","null"]},"request_id":{"type":"string","format":"uuid"}}},"generated_at":{"type":"string","format":"date-time"}}}}}}},"x-record-unit":"One successful search request, independent of candidate count up to the documented limit.","x-read-only":true,"x-market-coverage":["US"]}},"/api/v1/supplement-labels/{label_id}":{"get":{"operationId":"get_supplement_label","summary":"Read one traceable supplement label snapshot","description":"Retrieve raw label facts plus deterministic normalization for one stable label ID. Use after candidate selection. Do not use label quantities as personalized dosing, treatment, safety, or clinical-equivalence advice. US coverage only; source freshness reflects the stored snapshot, not live inventory. Anonymous quota: one record unit.","tags":["Supplement label intelligence"],"security":[{},{"bearerApiKey":[]}],"parameters":[{"name":"label_id","in":"path","required":true,"schema":{"type":"string","maxLength":120}},{"name":"basis","in":"query","schema":{"type":"string","enum":["as_labeled","per_serving","per_capsule","per_tablet"],"default":"as_labeled"}}],"responses":{"200":{"description":"Successful read","content":{"application/json":{"schema":{"type":"object","required":["success","schema_version","request_id","result","sources","coverage","freshness","cache","limitations","next_actions","generated_at"],"properties":{"success":{"const":true},"schema_version":{"type":"string","example":"1.0.0"},"request_id":{"type":"string","format":"uuid"},"result":{"type":"object","additionalProperties":true},"sources":{"type":"array","items":{"type":"object","additionalProperties":true}},"coverage":{"anyOf":[{"type":"object","additionalProperties":true},{"type":"null"}]},"freshness":{"type":"object","additionalProperties":true},"cache":{"type":"object","additionalProperties":true},"limitations":{"type":"array","items":{"type":"string"}},"next_actions":{"type":"array","maxItems":3,"items":{"type":"object","additionalProperties":true}},"generated_at":{"type":"string","format":"date-time"}}}}}},"400":{"description":"Invalid request syntax","content":{"application/json":{"schema":{"type":"object","required":["success","schema_version","error","generated_at"],"properties":{"success":{"const":false},"schema_version":{"type":"string"},"error":{"type":"object","required":["code","message","details","retryable","retry_after_seconds","request_id"],"properties":{"code":{"type":"string","enum":["INVALID_INPUT","UNSUPPORTED_MARKET","AMBIGUOUS_PRODUCT","LABEL_NOT_FOUND","INCOMPARABLE_BASIS","INSUFFICIENT_LABEL_INFORMATION","SOURCE_UNAVAILABLE","RIGHTS_NOT_APPROVED","RATE_LIMITED","AUTHENTICATION_FAILED","AUTHORIZATION_FAILED","INTERNAL_ERROR"]},"message":{"type":"string"},"details":{},"retryable":{"type":"boolean"},"retry_after_seconds":{"type":["integer","null"]},"request_id":{"type":"string","format":"uuid"}}},"generated_at":{"type":"string","format":"date-time"}}}}}},"401":{"description":"Invalid or expired Bearer API key","content":{"application/json":{"schema":{"type":"object","required":["success","schema_version","error","generated_at"],"properties":{"success":{"const":false},"schema_version":{"type":"string"},"error":{"type":"object","required":["code","message","details","retryable","retry_after_seconds","request_id"],"properties":{"code":{"type":"string","enum":["INVALID_INPUT","UNSUPPORTED_MARKET","AMBIGUOUS_PRODUCT","LABEL_NOT_FOUND","INCOMPARABLE_BASIS","INSUFFICIENT_LABEL_INFORMATION","SOURCE_UNAVAILABLE","RIGHTS_NOT_APPROVED","RATE_LIMITED","AUTHENTICATION_FAILED","AUTHORIZATION_FAILED","INTERNAL_ERROR"]},"message":{"type":"string"},"details":{},"retryable":{"type":"boolean"},"retry_after_seconds":{"type":["integer","null"]},"request_id":{"type":"string","format":"uuid"}}},"generated_at":{"type":"string","format":"date-time"}}}}}},"403":{"description":"Authenticated identity lacks the required scope","content":{"application/json":{"schema":{"type":"object","required":["success","schema_version","error","generated_at"],"properties":{"success":{"const":false},"schema_version":{"type":"string"},"error":{"type":"object","required":["code","message","details","retryable","retry_after_seconds","request_id"],"properties":{"code":{"type":"string","enum":["INVALID_INPUT","UNSUPPORTED_MARKET","AMBIGUOUS_PRODUCT","LABEL_NOT_FOUND","INCOMPARABLE_BASIS","INSUFFICIENT_LABEL_INFORMATION","SOURCE_UNAVAILABLE","RIGHTS_NOT_APPROVED","RATE_LIMITED","AUTHENTICATION_FAILED","AUTHORIZATION_FAILED","INTERNAL_ERROR"]},"message":{"type":"string"},"details":{},"retryable":{"type":"boolean"},"retry_after_seconds":{"type":["integer","null"]},"request_id":{"type":"string","format":"uuid"}}},"generated_at":{"type":"string","format":"date-time"}}}}}},"404":{"description":"Published resource not found","content":{"application/json":{"schema":{"type":"object","required":["success","schema_version","error","generated_at"],"properties":{"success":{"const":false},"schema_version":{"type":"string"},"error":{"type":"object","required":["code","message","details","retryable","retry_after_seconds","request_id"],"properties":{"code":{"type":"string","enum":["INVALID_INPUT","UNSUPPORTED_MARKET","AMBIGUOUS_PRODUCT","LABEL_NOT_FOUND","INCOMPARABLE_BASIS","INSUFFICIENT_LABEL_INFORMATION","SOURCE_UNAVAILABLE","RIGHTS_NOT_APPROVED","RATE_LIMITED","AUTHENTICATION_FAILED","AUTHORIZATION_FAILED","INTERNAL_ERROR"]},"message":{"type":"string"},"details":{},"retryable":{"type":"boolean"},"retry_after_seconds":{"type":["integer","null"]},"request_id":{"type":"string","format":"uuid"}}},"generated_at":{"type":"string","format":"date-time"}}}}}},"422":{"description":"Unsupported market, basis, or incomparable data","content":{"application/json":{"schema":{"type":"object","required":["success","schema_version","error","generated_at"],"properties":{"success":{"const":false},"schema_version":{"type":"string"},"error":{"type":"object","required":["code","message","details","retryable","retry_after_seconds","request_id"],"properties":{"code":{"type":"string","enum":["INVALID_INPUT","UNSUPPORTED_MARKET","AMBIGUOUS_PRODUCT","LABEL_NOT_FOUND","INCOMPARABLE_BASIS","INSUFFICIENT_LABEL_INFORMATION","SOURCE_UNAVAILABLE","RIGHTS_NOT_APPROVED","RATE_LIMITED","AUTHENTICATION_FAILED","AUTHORIZATION_FAILED","INTERNAL_ERROR"]},"message":{"type":"string"},"details":{},"retryable":{"type":"boolean"},"retry_after_seconds":{"type":["integer","null"]},"request_id":{"type":"string","format":"uuid"}}},"generated_at":{"type":"string","format":"date-time"}}}}}},"429":{"description":"Rate limit exceeded","headers":{"Retry-After":{"schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["success","schema_version","error","generated_at"],"properties":{"success":{"const":false},"schema_version":{"type":"string"},"error":{"type":"object","required":["code","message","details","retryable","retry_after_seconds","request_id"],"properties":{"code":{"type":"string","enum":["INVALID_INPUT","UNSUPPORTED_MARKET","AMBIGUOUS_PRODUCT","LABEL_NOT_FOUND","INCOMPARABLE_BASIS","INSUFFICIENT_LABEL_INFORMATION","SOURCE_UNAVAILABLE","RIGHTS_NOT_APPROVED","RATE_LIMITED","AUTHENTICATION_FAILED","AUTHORIZATION_FAILED","INTERNAL_ERROR"]},"message":{"type":"string"},"details":{},"retryable":{"type":"boolean"},"retry_after_seconds":{"type":["integer","null"]},"request_id":{"type":"string","format":"uuid"}}},"generated_at":{"type":"string","format":"date-time"}}}}}},"503":{"description":"Data dependency not ready","content":{"application/json":{"schema":{"type":"object","required":["success","schema_version","error","generated_at"],"properties":{"success":{"const":false},"schema_version":{"type":"string"},"error":{"type":"object","required":["code","message","details","retryable","retry_after_seconds","request_id"],"properties":{"code":{"type":"string","enum":["INVALID_INPUT","UNSUPPORTED_MARKET","AMBIGUOUS_PRODUCT","LABEL_NOT_FOUND","INCOMPARABLE_BASIS","INSUFFICIENT_LABEL_INFORMATION","SOURCE_UNAVAILABLE","RIGHTS_NOT_APPROVED","RATE_LIMITED","AUTHENTICATION_FAILED","AUTHORIZATION_FAILED","INTERNAL_ERROR"]},"message":{"type":"string"},"details":{},"retryable":{"type":"boolean"},"retry_after_seconds":{"type":["integer","null"]},"request_id":{"type":"string","format":"uuid"}}},"generated_at":{"type":"string","format":"date-time"}}}}}}},"x-record-unit":"One label returned.","x-read-only":true,"x-market-coverage":["US"]}},"/api/v1/supplement-label-comparisons":{"post":{"operationId":"compare_supplement_labels","summary":"Compare compatible quantities from two to five labels","description":"Compare explicitly selected US label snapshots on one serving basis. Use only when stable label IDs are known. Do not use it to rank products, infer safety or efficacy, or equate different measurement objects. The read-only POST performs no persistence. Anonymous quota: one record unit per distinct label in the request, counted once.","tags":["Supplement label intelligence"],"security":[{},{"bearerApiKey":[]}],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["label_ids","basis"],"properties":{"label_ids":{"type":"array","minItems":2,"maxItems":5,"uniqueItems":true,"items":{"type":"string"}},"basis":{"type":"string","enum":["as_labeled","per_serving","per_capsule","per_tablet"]}}},"example":{"label_ids":["synthetic_example_a","synthetic_example_b"],"basis":"per_capsule"}}}},"responses":{"200":{"description":"Successful read","content":{"application/json":{"schema":{"type":"object","required":["success","schema_version","request_id","result","sources","coverage","freshness","cache","limitations","next_actions","generated_at"],"properties":{"success":{"const":true},"schema_version":{"type":"string","example":"1.0.0"},"request_id":{"type":"string","format":"uuid"},"result":{"type":"object","additionalProperties":true},"sources":{"type":"array","items":{"type":"object","additionalProperties":true}},"coverage":{"anyOf":[{"type":"object","additionalProperties":true},{"type":"null"}]},"freshness":{"type":"object","additionalProperties":true},"cache":{"type":"object","additionalProperties":true},"limitations":{"type":"array","items":{"type":"string"}},"next_actions":{"type":"array","maxItems":3,"items":{"type":"object","additionalProperties":true}},"generated_at":{"type":"string","format":"date-time"}}}}}},"400":{"description":"Invalid request syntax","content":{"application/json":{"schema":{"type":"object","required":["success","schema_version","error","generated_at"],"properties":{"success":{"const":false},"schema_version":{"type":"string"},"error":{"type":"object","required":["code","message","details","retryable","retry_after_seconds","request_id"],"properties":{"code":{"type":"string","enum":["INVALID_INPUT","UNSUPPORTED_MARKET","AMBIGUOUS_PRODUCT","LABEL_NOT_FOUND","INCOMPARABLE_BASIS","INSUFFICIENT_LABEL_INFORMATION","SOURCE_UNAVAILABLE","RIGHTS_NOT_APPROVED","RATE_LIMITED","AUTHENTICATION_FAILED","AUTHORIZATION_FAILED","INTERNAL_ERROR"]},"message":{"type":"string"},"details":{},"retryable":{"type":"boolean"},"retry_after_seconds":{"type":["integer","null"]},"request_id":{"type":"string","format":"uuid"}}},"generated_at":{"type":"string","format":"date-time"}}}}}},"401":{"description":"Invalid or expired Bearer API key","content":{"application/json":{"schema":{"type":"object","required":["success","schema_version","error","generated_at"],"properties":{"success":{"const":false},"schema_version":{"type":"string"},"error":{"type":"object","required":["code","message","details","retryable","retry_after_seconds","request_id"],"properties":{"code":{"type":"string","enum":["INVALID_INPUT","UNSUPPORTED_MARKET","AMBIGUOUS_PRODUCT","LABEL_NOT_FOUND","INCOMPARABLE_BASIS","INSUFFICIENT_LABEL_INFORMATION","SOURCE_UNAVAILABLE","RIGHTS_NOT_APPROVED","RATE_LIMITED","AUTHENTICATION_FAILED","AUTHORIZATION_FAILED","INTERNAL_ERROR"]},"message":{"type":"string"},"details":{},"retryable":{"type":"boolean"},"retry_after_seconds":{"type":["integer","null"]},"request_id":{"type":"string","format":"uuid"}}},"generated_at":{"type":"string","format":"date-time"}}}}}},"403":{"description":"Authenticated identity lacks the required scope","content":{"application/json":{"schema":{"type":"object","required":["success","schema_version","error","generated_at"],"properties":{"success":{"const":false},"schema_version":{"type":"string"},"error":{"type":"object","required":["code","message","details","retryable","retry_after_seconds","request_id"],"properties":{"code":{"type":"string","enum":["INVALID_INPUT","UNSUPPORTED_MARKET","AMBIGUOUS_PRODUCT","LABEL_NOT_FOUND","INCOMPARABLE_BASIS","INSUFFICIENT_LABEL_INFORMATION","SOURCE_UNAVAILABLE","RIGHTS_NOT_APPROVED","RATE_LIMITED","AUTHENTICATION_FAILED","AUTHORIZATION_FAILED","INTERNAL_ERROR"]},"message":{"type":"string"},"details":{},"retryable":{"type":"boolean"},"retry_after_seconds":{"type":["integer","null"]},"request_id":{"type":"string","format":"uuid"}}},"generated_at":{"type":"string","format":"date-time"}}}}}},"404":{"description":"Published resource not found","content":{"application/json":{"schema":{"type":"object","required":["success","schema_version","error","generated_at"],"properties":{"success":{"const":false},"schema_version":{"type":"string"},"error":{"type":"object","required":["code","message","details","retryable","retry_after_seconds","request_id"],"properties":{"code":{"type":"string","enum":["INVALID_INPUT","UNSUPPORTED_MARKET","AMBIGUOUS_PRODUCT","LABEL_NOT_FOUND","INCOMPARABLE_BASIS","INSUFFICIENT_LABEL_INFORMATION","SOURCE_UNAVAILABLE","RIGHTS_NOT_APPROVED","RATE_LIMITED","AUTHENTICATION_FAILED","AUTHORIZATION_FAILED","INTERNAL_ERROR"]},"message":{"type":"string"},"details":{},"retryable":{"type":"boolean"},"retry_after_seconds":{"type":["integer","null"]},"request_id":{"type":"string","format":"uuid"}}},"generated_at":{"type":"string","format":"date-time"}}}}}},"422":{"description":"Unsupported market, basis, or incomparable data","content":{"application/json":{"schema":{"type":"object","required":["success","schema_version","error","generated_at"],"properties":{"success":{"const":false},"schema_version":{"type":"string"},"error":{"type":"object","required":["code","message","details","retryable","retry_after_seconds","request_id"],"properties":{"code":{"type":"string","enum":["INVALID_INPUT","UNSUPPORTED_MARKET","AMBIGUOUS_PRODUCT","LABEL_NOT_FOUND","INCOMPARABLE_BASIS","INSUFFICIENT_LABEL_INFORMATION","SOURCE_UNAVAILABLE","RIGHTS_NOT_APPROVED","RATE_LIMITED","AUTHENTICATION_FAILED","AUTHORIZATION_FAILED","INTERNAL_ERROR"]},"message":{"type":"string"},"details":{},"retryable":{"type":"boolean"},"retry_after_seconds":{"type":["integer","null"]},"request_id":{"type":"string","format":"uuid"}}},"generated_at":{"type":"string","format":"date-time"}}}}}},"429":{"description":"Rate limit exceeded","headers":{"Retry-After":{"schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["success","schema_version","error","generated_at"],"properties":{"success":{"const":false},"schema_version":{"type":"string"},"error":{"type":"object","required":["code","message","details","retryable","retry_after_seconds","request_id"],"properties":{"code":{"type":"string","enum":["INVALID_INPUT","UNSUPPORTED_MARKET","AMBIGUOUS_PRODUCT","LABEL_NOT_FOUND","INCOMPARABLE_BASIS","INSUFFICIENT_LABEL_INFORMATION","SOURCE_UNAVAILABLE","RIGHTS_NOT_APPROVED","RATE_LIMITED","AUTHENTICATION_FAILED","AUTHORIZATION_FAILED","INTERNAL_ERROR"]},"message":{"type":"string"},"details":{},"retryable":{"type":"boolean"},"retry_after_seconds":{"type":["integer","null"]},"request_id":{"type":"string","format":"uuid"}}},"generated_at":{"type":"string","format":"date-time"}}}}}},"503":{"description":"Data dependency not ready","content":{"application/json":{"schema":{"type":"object","required":["success","schema_version","error","generated_at"],"properties":{"success":{"const":false},"schema_version":{"type":"string"},"error":{"type":"object","required":["code","message","details","retryable","retry_after_seconds","request_id"],"properties":{"code":{"type":"string","enum":["INVALID_INPUT","UNSUPPORTED_MARKET","AMBIGUOUS_PRODUCT","LABEL_NOT_FOUND","INCOMPARABLE_BASIS","INSUFFICIENT_LABEL_INFORMATION","SOURCE_UNAVAILABLE","RIGHTS_NOT_APPROVED","RATE_LIMITED","AUTHENTICATION_FAILED","AUTHORIZATION_FAILED","INTERNAL_ERROR"]},"message":{"type":"string"},"details":{},"retryable":{"type":"boolean"},"retry_after_seconds":{"type":["integer","null"]},"request_id":{"type":"string","format":"uuid"}}},"generated_at":{"type":"string","format":"date-time"}}}}}}},"x-record-unit":"Each distinct input label, counted once.","x-read-only":true,"x-market-coverage":["US"]}},"/api/v1/source-records/{source_record_id}":{"get":{"operationId":"get_source_record","summary":"Inspect public provenance and rights metadata","description":"Retrieve source identity, public URL, snapshot dates, content hash, and applicable rights decision. Use to verify where a label record came from. Do not treat the content hash as third-party truth verification or request private object-store paths. Anonymous quota: one record unit.","tags":["Supplement label intelligence"],"security":[{},{"bearerApiKey":[]}],"parameters":[{"name":"source_record_id","in":"path","required":true,"schema":{"type":"string","maxLength":160}},{"name":"snapshot_id","in":"query","schema":{"type":"string","maxLength":160}}],"responses":{"200":{"description":"Successful read","content":{"application/json":{"schema":{"type":"object","required":["success","schema_version","request_id","result","sources","coverage","freshness","cache","limitations","next_actions","generated_at"],"properties":{"success":{"const":true},"schema_version":{"type":"string","example":"1.0.0"},"request_id":{"type":"string","format":"uuid"},"result":{"type":"object","additionalProperties":true},"sources":{"type":"array","items":{"type":"object","additionalProperties":true}},"coverage":{"anyOf":[{"type":"object","additionalProperties":true},{"type":"null"}]},"freshness":{"type":"object","additionalProperties":true},"cache":{"type":"object","additionalProperties":true},"limitations":{"type":"array","items":{"type":"string"}},"next_actions":{"type":"array","maxItems":3,"items":{"type":"object","additionalProperties":true}},"generated_at":{"type":"string","format":"date-time"}}}}}},"400":{"description":"Invalid request syntax","content":{"application/json":{"schema":{"type":"object","required":["success","schema_version","error","generated_at"],"properties":{"success":{"const":false},"schema_version":{"type":"string"},"error":{"type":"object","required":["code","message","details","retryable","retry_after_seconds","request_id"],"properties":{"code":{"type":"string","enum":["INVALID_INPUT","UNSUPPORTED_MARKET","AMBIGUOUS_PRODUCT","LABEL_NOT_FOUND","INCOMPARABLE_BASIS","INSUFFICIENT_LABEL_INFORMATION","SOURCE_UNAVAILABLE","RIGHTS_NOT_APPROVED","RATE_LIMITED","AUTHENTICATION_FAILED","AUTHORIZATION_FAILED","INTERNAL_ERROR"]},"message":{"type":"string"},"details":{},"retryable":{"type":"boolean"},"retry_after_seconds":{"type":["integer","null"]},"request_id":{"type":"string","format":"uuid"}}},"generated_at":{"type":"string","format":"date-time"}}}}}},"401":{"description":"Invalid or expired Bearer API key","content":{"application/json":{"schema":{"type":"object","required":["success","schema_version","error","generated_at"],"properties":{"success":{"const":false},"schema_version":{"type":"string"},"error":{"type":"object","required":["code","message","details","retryable","retry_after_seconds","request_id"],"properties":{"code":{"type":"string","enum":["INVALID_INPUT","UNSUPPORTED_MARKET","AMBIGUOUS_PRODUCT","LABEL_NOT_FOUND","INCOMPARABLE_BASIS","INSUFFICIENT_LABEL_INFORMATION","SOURCE_UNAVAILABLE","RIGHTS_NOT_APPROVED","RATE_LIMITED","AUTHENTICATION_FAILED","AUTHORIZATION_FAILED","INTERNAL_ERROR"]},"message":{"type":"string"},"details":{},"retryable":{"type":"boolean"},"retry_after_seconds":{"type":["integer","null"]},"request_id":{"type":"string","format":"uuid"}}},"generated_at":{"type":"string","format":"date-time"}}}}}},"403":{"description":"Authenticated identity lacks the required scope","content":{"application/json":{"schema":{"type":"object","required":["success","schema_version","error","generated_at"],"properties":{"success":{"const":false},"schema_version":{"type":"string"},"error":{"type":"object","required":["code","message","details","retryable","retry_after_seconds","request_id"],"properties":{"code":{"type":"string","enum":["INVALID_INPUT","UNSUPPORTED_MARKET","AMBIGUOUS_PRODUCT","LABEL_NOT_FOUND","INCOMPARABLE_BASIS","INSUFFICIENT_LABEL_INFORMATION","SOURCE_UNAVAILABLE","RIGHTS_NOT_APPROVED","RATE_LIMITED","AUTHENTICATION_FAILED","AUTHORIZATION_FAILED","INTERNAL_ERROR"]},"message":{"type":"string"},"details":{},"retryable":{"type":"boolean"},"retry_after_seconds":{"type":["integer","null"]},"request_id":{"type":"string","format":"uuid"}}},"generated_at":{"type":"string","format":"date-time"}}}}}},"404":{"description":"Published resource not found","content":{"application/json":{"schema":{"type":"object","required":["success","schema_version","error","generated_at"],"properties":{"success":{"const":false},"schema_version":{"type":"string"},"error":{"type":"object","required":["code","message","details","retryable","retry_after_seconds","request_id"],"properties":{"code":{"type":"string","enum":["INVALID_INPUT","UNSUPPORTED_MARKET","AMBIGUOUS_PRODUCT","LABEL_NOT_FOUND","INCOMPARABLE_BASIS","INSUFFICIENT_LABEL_INFORMATION","SOURCE_UNAVAILABLE","RIGHTS_NOT_APPROVED","RATE_LIMITED","AUTHENTICATION_FAILED","AUTHORIZATION_FAILED","INTERNAL_ERROR"]},"message":{"type":"string"},"details":{},"retryable":{"type":"boolean"},"retry_after_seconds":{"type":["integer","null"]},"request_id":{"type":"string","format":"uuid"}}},"generated_at":{"type":"string","format":"date-time"}}}}}},"422":{"description":"Unsupported market, basis, or incomparable data","content":{"application/json":{"schema":{"type":"object","required":["success","schema_version","error","generated_at"],"properties":{"success":{"const":false},"schema_version":{"type":"string"},"error":{"type":"object","required":["code","message","details","retryable","retry_after_seconds","request_id"],"properties":{"code":{"type":"string","enum":["INVALID_INPUT","UNSUPPORTED_MARKET","AMBIGUOUS_PRODUCT","LABEL_NOT_FOUND","INCOMPARABLE_BASIS","INSUFFICIENT_LABEL_INFORMATION","SOURCE_UNAVAILABLE","RIGHTS_NOT_APPROVED","RATE_LIMITED","AUTHENTICATION_FAILED","AUTHORIZATION_FAILED","INTERNAL_ERROR"]},"message":{"type":"string"},"details":{},"retryable":{"type":"boolean"},"retry_after_seconds":{"type":["integer","null"]},"request_id":{"type":"string","format":"uuid"}}},"generated_at":{"type":"string","format":"date-time"}}}}}},"429":{"description":"Rate limit exceeded","headers":{"Retry-After":{"schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["success","schema_version","error","generated_at"],"properties":{"success":{"const":false},"schema_version":{"type":"string"},"error":{"type":"object","required":["code","message","details","retryable","retry_after_seconds","request_id"],"properties":{"code":{"type":"string","enum":["INVALID_INPUT","UNSUPPORTED_MARKET","AMBIGUOUS_PRODUCT","LABEL_NOT_FOUND","INCOMPARABLE_BASIS","INSUFFICIENT_LABEL_INFORMATION","SOURCE_UNAVAILABLE","RIGHTS_NOT_APPROVED","RATE_LIMITED","AUTHENTICATION_FAILED","AUTHORIZATION_FAILED","INTERNAL_ERROR"]},"message":{"type":"string"},"details":{},"retryable":{"type":"boolean"},"retry_after_seconds":{"type":["integer","null"]},"request_id":{"type":"string","format":"uuid"}}},"generated_at":{"type":"string","format":"date-time"}}}}}},"503":{"description":"Data dependency not ready","content":{"application/json":{"schema":{"type":"object","required":["success","schema_version","error","generated_at"],"properties":{"success":{"const":false},"schema_version":{"type":"string"},"error":{"type":"object","required":["code","message","details","retryable","retry_after_seconds","request_id"],"properties":{"code":{"type":"string","enum":["INVALID_INPUT","UNSUPPORTED_MARKET","AMBIGUOUS_PRODUCT","LABEL_NOT_FOUND","INCOMPARABLE_BASIS","INSUFFICIENT_LABEL_INFORMATION","SOURCE_UNAVAILABLE","RIGHTS_NOT_APPROVED","RATE_LIMITED","AUTHENTICATION_FAILED","AUTHORIZATION_FAILED","INTERNAL_ERROR"]},"message":{"type":"string"},"details":{},"retryable":{"type":"boolean"},"retry_after_seconds":{"type":["integer","null"]},"request_id":{"type":"string","format":"uuid"}}},"generated_at":{"type":"string","format":"date-time"}}}}}}},"x-record-unit":"One source record.","x-read-only":true,"x-market-coverage":["US"]}},"/api/v1/ingredients/{ingredient_id}/evidence":{"get":{"operationId":"get_ingredient_evidence","summary":"Read a reference-only ingredient evidence index","description":"Retrieve verified mappings to public ingredient references. Use for source discovery, not for medical conclusions. Until a real human review is recorded, summary and evidence grade are null and response_mode is reference_only. Anonymous quota: one record unit.","tags":["Supplement label intelligence"],"security":[{},{"bearerApiKey":[]}],"parameters":[{"name":"ingredient_id","in":"path","required":true,"schema":{"type":"string","maxLength":160}}],"responses":{"200":{"description":"Successful read","content":{"application/json":{"schema":{"type":"object","required":["success","schema_version","request_id","result","sources","coverage","freshness","cache","limitations","next_actions","generated_at"],"properties":{"success":{"const":true},"schema_version":{"type":"string","example":"1.0.0"},"request_id":{"type":"string","format":"uuid"},"result":{"type":"object","additionalProperties":true},"sources":{"type":"array","items":{"type":"object","additionalProperties":true}},"coverage":{"anyOf":[{"type":"object","additionalProperties":true},{"type":"null"}]},"freshness":{"type":"object","additionalProperties":true},"cache":{"type":"object","additionalProperties":true},"limitations":{"type":"array","items":{"type":"string"}},"next_actions":{"type":"array","maxItems":3,"items":{"type":"object","additionalProperties":true}},"generated_at":{"type":"string","format":"date-time"}}}}}},"400":{"description":"Invalid request syntax","content":{"application/json":{"schema":{"type":"object","required":["success","schema_version","error","generated_at"],"properties":{"success":{"const":false},"schema_version":{"type":"string"},"error":{"type":"object","required":["code","message","details","retryable","retry_after_seconds","request_id"],"properties":{"code":{"type":"string","enum":["INVALID_INPUT","UNSUPPORTED_MARKET","AMBIGUOUS_PRODUCT","LABEL_NOT_FOUND","INCOMPARABLE_BASIS","INSUFFICIENT_LABEL_INFORMATION","SOURCE_UNAVAILABLE","RIGHTS_NOT_APPROVED","RATE_LIMITED","AUTHENTICATION_FAILED","AUTHORIZATION_FAILED","INTERNAL_ERROR"]},"message":{"type":"string"},"details":{},"retryable":{"type":"boolean"},"retry_after_seconds":{"type":["integer","null"]},"request_id":{"type":"string","format":"uuid"}}},"generated_at":{"type":"string","format":"date-time"}}}}}},"401":{"description":"Invalid or expired Bearer API key","content":{"application/json":{"schema":{"type":"object","required":["success","schema_version","error","generated_at"],"properties":{"success":{"const":false},"schema_version":{"type":"string"},"error":{"type":"object","required":["code","message","details","retryable","retry_after_seconds","request_id"],"properties":{"code":{"type":"string","enum":["INVALID_INPUT","UNSUPPORTED_MARKET","AMBIGUOUS_PRODUCT","LABEL_NOT_FOUND","INCOMPARABLE_BASIS","INSUFFICIENT_LABEL_INFORMATION","SOURCE_UNAVAILABLE","RIGHTS_NOT_APPROVED","RATE_LIMITED","AUTHENTICATION_FAILED","AUTHORIZATION_FAILED","INTERNAL_ERROR"]},"message":{"type":"string"},"details":{},"retryable":{"type":"boolean"},"retry_after_seconds":{"type":["integer","null"]},"request_id":{"type":"string","format":"uuid"}}},"generated_at":{"type":"string","format":"date-time"}}}}}},"403":{"description":"Authenticated identity lacks the required scope","content":{"application/json":{"schema":{"type":"object","required":["success","schema_version","error","generated_at"],"properties":{"success":{"const":false},"schema_version":{"type":"string"},"error":{"type":"object","required":["code","message","details","retryable","retry_after_seconds","request_id"],"properties":{"code":{"type":"string","enum":["INVALID_INPUT","UNSUPPORTED_MARKET","AMBIGUOUS_PRODUCT","LABEL_NOT_FOUND","INCOMPARABLE_BASIS","INSUFFICIENT_LABEL_INFORMATION","SOURCE_UNAVAILABLE","RIGHTS_NOT_APPROVED","RATE_LIMITED","AUTHENTICATION_FAILED","AUTHORIZATION_FAILED","INTERNAL_ERROR"]},"message":{"type":"string"},"details":{},"retryable":{"type":"boolean"},"retry_after_seconds":{"type":["integer","null"]},"request_id":{"type":"string","format":"uuid"}}},"generated_at":{"type":"string","format":"date-time"}}}}}},"404":{"description":"Published resource not found","content":{"application/json":{"schema":{"type":"object","required":["success","schema_version","error","generated_at"],"properties":{"success":{"const":false},"schema_version":{"type":"string"},"error":{"type":"object","required":["code","message","details","retryable","retry_after_seconds","request_id"],"properties":{"code":{"type":"string","enum":["INVALID_INPUT","UNSUPPORTED_MARKET","AMBIGUOUS_PRODUCT","LABEL_NOT_FOUND","INCOMPARABLE_BASIS","INSUFFICIENT_LABEL_INFORMATION","SOURCE_UNAVAILABLE","RIGHTS_NOT_APPROVED","RATE_LIMITED","AUTHENTICATION_FAILED","AUTHORIZATION_FAILED","INTERNAL_ERROR"]},"message":{"type":"string"},"details":{},"retryable":{"type":"boolean"},"retry_after_seconds":{"type":["integer","null"]},"request_id":{"type":"string","format":"uuid"}}},"generated_at":{"type":"string","format":"date-time"}}}}}},"422":{"description":"Unsupported market, basis, or incomparable data","content":{"application/json":{"schema":{"type":"object","required":["success","schema_version","error","generated_at"],"properties":{"success":{"const":false},"schema_version":{"type":"string"},"error":{"type":"object","required":["code","message","details","retryable","retry_after_seconds","request_id"],"properties":{"code":{"type":"string","enum":["INVALID_INPUT","UNSUPPORTED_MARKET","AMBIGUOUS_PRODUCT","LABEL_NOT_FOUND","INCOMPARABLE_BASIS","INSUFFICIENT_LABEL_INFORMATION","SOURCE_UNAVAILABLE","RIGHTS_NOT_APPROVED","RATE_LIMITED","AUTHENTICATION_FAILED","AUTHORIZATION_FAILED","INTERNAL_ERROR"]},"message":{"type":"string"},"details":{},"retryable":{"type":"boolean"},"retry_after_seconds":{"type":["integer","null"]},"request_id":{"type":"string","format":"uuid"}}},"generated_at":{"type":"string","format":"date-time"}}}}}},"429":{"description":"Rate limit exceeded","headers":{"Retry-After":{"schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["success","schema_version","error","generated_at"],"properties":{"success":{"const":false},"schema_version":{"type":"string"},"error":{"type":"object","required":["code","message","details","retryable","retry_after_seconds","request_id"],"properties":{"code":{"type":"string","enum":["INVALID_INPUT","UNSUPPORTED_MARKET","AMBIGUOUS_PRODUCT","LABEL_NOT_FOUND","INCOMPARABLE_BASIS","INSUFFICIENT_LABEL_INFORMATION","SOURCE_UNAVAILABLE","RIGHTS_NOT_APPROVED","RATE_LIMITED","AUTHENTICATION_FAILED","AUTHORIZATION_FAILED","INTERNAL_ERROR"]},"message":{"type":"string"},"details":{},"retryable":{"type":"boolean"},"retry_after_seconds":{"type":["integer","null"]},"request_id":{"type":"string","format":"uuid"}}},"generated_at":{"type":"string","format":"date-time"}}}}}},"503":{"description":"Data dependency not ready","content":{"application/json":{"schema":{"type":"object","required":["success","schema_version","error","generated_at"],"properties":{"success":{"const":false},"schema_version":{"type":"string"},"error":{"type":"object","required":["code","message","details","retryable","retry_after_seconds","request_id"],"properties":{"code":{"type":"string","enum":["INVALID_INPUT","UNSUPPORTED_MARKET","AMBIGUOUS_PRODUCT","LABEL_NOT_FOUND","INCOMPARABLE_BASIS","INSUFFICIENT_LABEL_INFORMATION","SOURCE_UNAVAILABLE","RIGHTS_NOT_APPROVED","RATE_LIMITED","AUTHENTICATION_FAILED","AUTHORIZATION_FAILED","INTERNAL_ERROR"]},"message":{"type":"string"},"details":{},"retryable":{"type":"boolean"},"retry_after_seconds":{"type":["integer","null"]},"request_id":{"type":"string","format":"uuid"}}},"generated_at":{"type":"string","format":"date-time"}}}}}}},"x-record-unit":"One ingredient evidence index.","x-read-only":true,"x-market-coverage":["US"]}},"/api/v1/supplement-labels/{label_id}/dossier":{"get":{"operationId":"get_supplement_dossier","summary":"Retrieve label, evidence index, and provenance together","description":"Aggregate a selected US label with optional evidence and source modules. Use to reduce repeated calls after a label has been identified. Do not use it as a medical assessment. Optional module failures yield a partial result with module_errors. A dossier counts each distinct label once, not once per internal module.","tags":["Supplement label intelligence"],"security":[{},{"bearerApiKey":[]}],"parameters":[{"name":"label_id","in":"path","required":true,"schema":{"type":"string","maxLength":120}},{"name":"include","in":"query","schema":{"type":"string","default":"label,evidence,sources","example":"label,evidence,sources"}}],"responses":{"200":{"description":"Successful read","content":{"application/json":{"schema":{"type":"object","required":["success","schema_version","request_id","result","sources","coverage","freshness","cache","limitations","next_actions","generated_at"],"properties":{"success":{"const":true},"schema_version":{"type":"string","example":"1.0.0"},"request_id":{"type":"string","format":"uuid"},"result":{"type":"object","additionalProperties":true},"sources":{"type":"array","items":{"type":"object","additionalProperties":true}},"coverage":{"anyOf":[{"type":"object","additionalProperties":true},{"type":"null"}]},"freshness":{"type":"object","additionalProperties":true},"cache":{"type":"object","additionalProperties":true},"limitations":{"type":"array","items":{"type":"string"}},"next_actions":{"type":"array","maxItems":3,"items":{"type":"object","additionalProperties":true}},"generated_at":{"type":"string","format":"date-time"}}}}}},"400":{"description":"Invalid request syntax","content":{"application/json":{"schema":{"type":"object","required":["success","schema_version","error","generated_at"],"properties":{"success":{"const":false},"schema_version":{"type":"string"},"error":{"type":"object","required":["code","message","details","retryable","retry_after_seconds","request_id"],"properties":{"code":{"type":"string","enum":["INVALID_INPUT","UNSUPPORTED_MARKET","AMBIGUOUS_PRODUCT","LABEL_NOT_FOUND","INCOMPARABLE_BASIS","INSUFFICIENT_LABEL_INFORMATION","SOURCE_UNAVAILABLE","RIGHTS_NOT_APPROVED","RATE_LIMITED","AUTHENTICATION_FAILED","AUTHORIZATION_FAILED","INTERNAL_ERROR"]},"message":{"type":"string"},"details":{},"retryable":{"type":"boolean"},"retry_after_seconds":{"type":["integer","null"]},"request_id":{"type":"string","format":"uuid"}}},"generated_at":{"type":"string","format":"date-time"}}}}}},"401":{"description":"Invalid or expired Bearer API key","content":{"application/json":{"schema":{"type":"object","required":["success","schema_version","error","generated_at"],"properties":{"success":{"const":false},"schema_version":{"type":"string"},"error":{"type":"object","required":["code","message","details","retryable","retry_after_seconds","request_id"],"properties":{"code":{"type":"string","enum":["INVALID_INPUT","UNSUPPORTED_MARKET","AMBIGUOUS_PRODUCT","LABEL_NOT_FOUND","INCOMPARABLE_BASIS","INSUFFICIENT_LABEL_INFORMATION","SOURCE_UNAVAILABLE","RIGHTS_NOT_APPROVED","RATE_LIMITED","AUTHENTICATION_FAILED","AUTHORIZATION_FAILED","INTERNAL_ERROR"]},"message":{"type":"string"},"details":{},"retryable":{"type":"boolean"},"retry_after_seconds":{"type":["integer","null"]},"request_id":{"type":"string","format":"uuid"}}},"generated_at":{"type":"string","format":"date-time"}}}}}},"403":{"description":"Authenticated identity lacks the required scope","content":{"application/json":{"schema":{"type":"object","required":["success","schema_version","error","generated_at"],"properties":{"success":{"const":false},"schema_version":{"type":"string"},"error":{"type":"object","required":["code","message","details","retryable","retry_after_seconds","request_id"],"properties":{"code":{"type":"string","enum":["INVALID_INPUT","UNSUPPORTED_MARKET","AMBIGUOUS_PRODUCT","LABEL_NOT_FOUND","INCOMPARABLE_BASIS","INSUFFICIENT_LABEL_INFORMATION","SOURCE_UNAVAILABLE","RIGHTS_NOT_APPROVED","RATE_LIMITED","AUTHENTICATION_FAILED","AUTHORIZATION_FAILED","INTERNAL_ERROR"]},"message":{"type":"string"},"details":{},"retryable":{"type":"boolean"},"retry_after_seconds":{"type":["integer","null"]},"request_id":{"type":"string","format":"uuid"}}},"generated_at":{"type":"string","format":"date-time"}}}}}},"404":{"description":"Published resource not found","content":{"application/json":{"schema":{"type":"object","required":["success","schema_version","error","generated_at"],"properties":{"success":{"const":false},"schema_version":{"type":"string"},"error":{"type":"object","required":["code","message","details","retryable","retry_after_seconds","request_id"],"properties":{"code":{"type":"string","enum":["INVALID_INPUT","UNSUPPORTED_MARKET","AMBIGUOUS_PRODUCT","LABEL_NOT_FOUND","INCOMPARABLE_BASIS","INSUFFICIENT_LABEL_INFORMATION","SOURCE_UNAVAILABLE","RIGHTS_NOT_APPROVED","RATE_LIMITED","AUTHENTICATION_FAILED","AUTHORIZATION_FAILED","INTERNAL_ERROR"]},"message":{"type":"string"},"details":{},"retryable":{"type":"boolean"},"retry_after_seconds":{"type":["integer","null"]},"request_id":{"type":"string","format":"uuid"}}},"generated_at":{"type":"string","format":"date-time"}}}}}},"422":{"description":"Unsupported market, basis, or incomparable data","content":{"application/json":{"schema":{"type":"object","required":["success","schema_version","error","generated_at"],"properties":{"success":{"const":false},"schema_version":{"type":"string"},"error":{"type":"object","required":["code","message","details","retryable","retry_after_seconds","request_id"],"properties":{"code":{"type":"string","enum":["INVALID_INPUT","UNSUPPORTED_MARKET","AMBIGUOUS_PRODUCT","LABEL_NOT_FOUND","INCOMPARABLE_BASIS","INSUFFICIENT_LABEL_INFORMATION","SOURCE_UNAVAILABLE","RIGHTS_NOT_APPROVED","RATE_LIMITED","AUTHENTICATION_FAILED","AUTHORIZATION_FAILED","INTERNAL_ERROR"]},"message":{"type":"string"},"details":{},"retryable":{"type":"boolean"},"retry_after_seconds":{"type":["integer","null"]},"request_id":{"type":"string","format":"uuid"}}},"generated_at":{"type":"string","format":"date-time"}}}}}},"429":{"description":"Rate limit exceeded","headers":{"Retry-After":{"schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["success","schema_version","error","generated_at"],"properties":{"success":{"const":false},"schema_version":{"type":"string"},"error":{"type":"object","required":["code","message","details","retryable","retry_after_seconds","request_id"],"properties":{"code":{"type":"string","enum":["INVALID_INPUT","UNSUPPORTED_MARKET","AMBIGUOUS_PRODUCT","LABEL_NOT_FOUND","INCOMPARABLE_BASIS","INSUFFICIENT_LABEL_INFORMATION","SOURCE_UNAVAILABLE","RIGHTS_NOT_APPROVED","RATE_LIMITED","AUTHENTICATION_FAILED","AUTHORIZATION_FAILED","INTERNAL_ERROR"]},"message":{"type":"string"},"details":{},"retryable":{"type":"boolean"},"retry_after_seconds":{"type":["integer","null"]},"request_id":{"type":"string","format":"uuid"}}},"generated_at":{"type":"string","format":"date-time"}}}}}},"503":{"description":"Data dependency not ready","content":{"application/json":{"schema":{"type":"object","required":["success","schema_version","error","generated_at"],"properties":{"success":{"const":false},"schema_version":{"type":"string"},"error":{"type":"object","required":["code","message","details","retryable","retry_after_seconds","request_id"],"properties":{"code":{"type":"string","enum":["INVALID_INPUT","UNSUPPORTED_MARKET","AMBIGUOUS_PRODUCT","LABEL_NOT_FOUND","INCOMPARABLE_BASIS","INSUFFICIENT_LABEL_INFORMATION","SOURCE_UNAVAILABLE","RIGHTS_NOT_APPROVED","RATE_LIMITED","AUTHENTICATION_FAILED","AUTHORIZATION_FAILED","INTERNAL_ERROR"]},"message":{"type":"string"},"details":{},"retryable":{"type":"boolean"},"retry_after_seconds":{"type":["integer","null"]},"request_id":{"type":"string","format":"uuid"}}},"generated_at":{"type":"string","format":"date-time"}}}}}}},"x-record-unit":"One distinct label, regardless of included internal modules.","x-read-only":true,"x-market-coverage":["US"]}}},"components":{"securitySchemes":{"bearerApiKey":{"type":"http","scheme":"bearer","description":"Optional API key. Anonymous public reads are also supported at lower quotas. Keys are never accepted in URLs."}}}}