Get Applications
Retrieves a user’s existing financial-service account applications
/applications with the user’s ID; the response includes every application submitted for that user, ordered by created_on in ascending order.
Reasons to call this endpoint include:
- Resuming an interrupted signup: Check for an existing application in the
KYCstatus before redirecting the applicant to start over, then reuse thekyc_urlfrom that application instead of submitting a duplicate. - Displaying application status in your app: Poll this endpoint to show the applicant where they stand, as a fallback for cases where you cannot process outbound application events.
- Preventing duplicate submissions: Check for any non-final application (
SUBMITTED,KYC, orMANUAL_REVIEW) for the user before you submit a new one.
active_only to false if you also need to see applications in a final status, such as APPROVED, REJECTED, or EXPIRED.
applications array rather than an error.next_cursor value from the response as the cursor parameter in your next request to page through the rest.Authorizations
Token used to verify caller identity and authorize use of the service.
Headers
Identifies the program this request belongs to. Every application, and every piece of program-configured reference data it refers to, is scoped by this value.
A missing or empty value is rejected with 400. A value the credential is not authorized for is rejected with 401.
50Query Parameters
The platform's own user ID, as supplied in user.id on submission.
Indicate if only active applications should be returned.
An active application is one that has a status other than APPROVED, REJECTED, or EXPIRED.
Maximum number of items to return. If not present, no limit should be applied.
1 <= x <= 100Cursor to a specific position in the results. If not present, the first page should be returned.
"eyJpZCI6IjEyMyJ9"