Fetch federated output card

POST

/v1/functions/hospitality.function.fetch_federated_output_card/invoke

curl --request POST \
  --url https://api.aerandil.com/v1/functions/hospitality.function.fetch_federated_output_card/invoke \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "params": { "output_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0" } }'

• Production API

Return the participant-safe card for a published federated output: cohort summary, aggregate values, privacy guarantee, suppression state, applicability statement, and downstream-use restrictions. Draft, revoked, expired, and quarantined outputs are not served.

Authorizations

• aerandil_oauth
  functions:invoke
• aerandil_oauth
  functions:hospitality.function.fetch_federated_output_card:invoke

Request Body^required

Media typeapplication/json

object

params

required

object

output_id

required

Federated output id

string format: uuid

Example^generated

{
  "params": {
    "output_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0"
  }
}

Responses

200

Function invoked. The body carries the typed return_value shaped by the function’s declared return_type.

Media typeapplication/json

InvokeFunctionResponse

Envelope returned by the Aerandil function engine. correlation_id is the per-invocation id for trace stitching; return_value is the typed value the function computed (shape declared by the function’s return_type).

object

correlation_id

required

Per-invocation correlation id; appears on log/trace records this function emitted.

string format: uuid

return_value

required

object

applicability_statement

required

string

artifact_hash

string

artifact_reference

string

cohort_summary

required

confidence_intervals

datasheet_reference

string

downstream_use_restrictions

required

string

expires_at

string format: date-time

metric_values

model_card_reference

string

output_id

required

string format: uuid

output_kind

required

string

Allowed values: benchmark_report calibration_curve aggregate_metric model_artifact signal_package governance_card

output_schema_version

required

string

privacy_guarantee_summary

required

published_at

string format: date-time

published_to_scope

required

string

Allowed values: program_owner participants public_aggregate specific_recipients

run_id

required

string format: uuid

suppression_applied

required

boolean

suppression_reasons

required

Array<string>

Allowed values: minimum_tenants_not_met minimum_properties_not_met minimum_subjects_not_met max_contributor_share_exceeded privacy_budget_exhausted high_variance data_quality_mismatch legal_basis_missing participant_withdrawal reviewer_blocked security_incident

Example

{
  "return_value": {
    "output_kind": "benchmark_report",
    "published_to_scope": "program_owner",
    "suppression_reasons": [
      "minimum_tenants_not_met"
    ]
  }
}

Headers

Cache-Control

string

Always no-store — function results are time-sensitive and never cacheable.

404

Function or target object not found.

422

Parameter validation or domain-rule violation.