Skip to main content
GET
Get user applications
Use this endpoint to check whether a user already has an application in progress or has already been onboarded, before you start a new White Label App (WLA) onboarding flow. Send a GET request to /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 KYC status before redirecting the applicant to start over, then reuse the kyc_url from 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, or MANUAL_REVIEW) for the user before you submit a new one.
Set active_only to false if you also need to see applications in a final status, such as APPROVED, REJECTED, or EXPIRED.
If the specified user has no applications, the response returns an empty applications array rather than an error.
If the user has more applications than fit in a single page, use the next_cursor value from the response as the cursor parameter in your next request to page through the rest.

Authorizations

Authorization
string
header
required

Token used to verify caller identity and authorize use of the service.

Headers

X-Marqeta-Program-Short-Code
string
required

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.

Maximum string length: 50

Query Parameters

user_id
string
required

The platform's own user ID, as supplied in user.id on submission.

active_only
boolean
default:true

Indicate if only active applications should be returned. An active application is one that has a status other than APPROVED, REJECTED, or EXPIRED.

limit
integer

Maximum number of items to return. If not present, no limit should be applied.

Required range: 1 <= x <= 100
cursor
string

Cursor to a specific position in the results. If not present, the first page should be returned.

Example:

"eyJpZCI6IjEyMyJ9"

Response

Successful operation

applications
object[]
required

The list of applications for the user.

next_cursor
string

Cursor to fetch the next results.

Example:

"eyJpZCI6IjEyMyJ9"