Get an onboarding attempt
Connect
Get an onboarding attempt
Inspect an attempt’s state while you wait for connection.created: whether the person has verified, whether the grant was already exchanged, and when the attempt expires. Only the client that created the attempt can read it.
GET
Get an onboarding attempt
How it works
Read an attempt’s state while you wait for theconnection.created webhook:
pending means the person hasn’t verified yet, converted means they have
(and user_id is present), expired means the link died unused, and
exchanged tells you whether the grant was already collected. Only the client
that created the attempt can read it; anything else answers the same 404 as
an unknown id.Authorizations
A platform access token. Get one on the Create an access token endpoint by exchanging your client_id + client_secret, then send it as Authorization: Bearer <token>. Tokens live one hour.
Path Parameters
The attempt id from the create response.
Response
The attempt.

