Api specification for first cut