Check the status of your case

After submission, Beam immediately creates a KYB/KYC case. To monitor progress, you can use the following endpoint:

Note: The {CASE_ID} field that is part of the request URI is the case_id you received when you submitted the request in the previous page.

Endpoint

GET /identity/cases/{CASE_ID}

Request

curl --request GET  
     --url <https://api.dev.getbeam.cash/identity/cases/{CASE_ID}>  
     --header 'Authorization: Bearer beam_sandbox_abc123'  
     --header 'Content-Type: application/json'

Response

{  
  "status": "review_required",  
  "next_steps": ["submit_missing_fields"],  
  "missing_fields": ["owner.identification_number"]  
}

Beam normalizes inquiry, verification, and reporting states into a single, easy-to-parse status object, so you always know what’s happening and what’s needed next.

Use this endpoint to power dashboards, trigger retries, or surface next steps directly to your users.