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.
Updated about 2 months ago
What’s Next