Skip to main content
Form filling Partner API structured data is ready only after processing finishes. If you call the structured-data endpoint too early, or after failed / aborted, you get empty or missing results. For the hosted Form filling SDK (cancel, early close, SUKI_FF_*), use Form filling session returns no results.

โ€‹
Status values

Poll Get Form filling session status:

โ€‹
Common causes

  • Calling structured data before status is completed.
  • Skipping RU9G, WebSocket close, or REST end.
  • Calling content APIs after failed or aborted.
  • Using SDK callbacks on a REST-only integration.

โ€‹
Fix

1

Create, Stream, and End

Create the Form filling session, stream audio on /ws/stream (same ambient wire format), send RU9G, close the WebSocket, then call End Form filling session with sdp_suki_token.
2

Poll Until Completed

Call GET /api/v1/form-filling/session/{ambient_session_id}/status until status is completed. Stop on failed or aborted.
3

Retrieve After Completed

Call the Form filling structured-data endpoint only when status is completed.
4

If You Use the Form Filling SDK

Follow Form filling session returns no results for cancel, early close, and SUKI_FF_001 through SUKI_FF_004.
Closing the WebSocket is not enough. Poll session status before you retrieve structured data.

โ€‹
Next steps

Get Form filling session status - Status values for polling Get Form filling structured data - Retrieve after status is completed Form filling session returns no results - SDK cancel, closed, and SUKI_FF_* Empty notes after end session - Ambient poll before retrieve Streaming architecture - Form filling uses ambient wire format on /ws/stream
Last modified on September 29, 2026