> Portal Navigation:
> 
> - Append `.md` to any URL under `https://dev.wix.com/docs/` to get its markdown version.
> - Pages are either content pages (article or reference text) or menu pages (a list of links to child pages).
> - To get a menu page, truncate any URL to a parent path and append `.md` (e.g. `https://dev.wix.com/docs/sdk.md`, `https://dev.wix.com/docs/sdk/core-modules.md`).
> - Top-level index of all portals: https://dev.wix.com/docs/llms.txt
> - Full concatenated docs: https://dev.wix.com/docs/llms-full.txt

# Resource: Join Applications

# Type: Join Application Object

# Link: https://dev.wix.com/docs/api-reference/business-management/online-programs/join-applications/join-application-object.md

## Description: A join application tracks a member's request or invitation to join an online program, from application through approval, payment, and enrollment.

Wix users can invite members, review applications, and manage payment-related activity. Members can apply to join a program, accept invitations, and complete payment when required.

## Schema:

```json
 Type: Join Application Object | type: JoinApplication
 Description: A join application tracks a member's request or invitation to join an online program, from application through approval, payment, and enrollment.

Wix users can invite members, review applications, and manage payment-related activity. Members can apply to join a program, accept invitations, and complete payment when required.
       - name: id  | type: string | description: Join application ID.
           - name: value  | type: string | description: 
       - name: revision  | type: string | description: Revision number, which increments by 1 each time a lifecycle, payment, or tag action changes the join application.  This API doesn't provide a generic update method, so `revision` is read-only. Don't specify it when creating or changing a join application.
           - name: value  | type: string | description: 
       - name: createdDate  | type: string | description: Date and time the join application was created.
           - name: seconds  | type: string | description: 
           - name: nanos  | type: number | description: 
       - name: updatedDate  | type: string | description: Date and time the join application was last updated.
       - name: memberId  | type: string | description: ID of the site member applying or invited to participate in the program.  Required when a Wix user creates an application on a member's behalf. Automatically set to the caller's member ID when a member creates their own application.
       - name: programId  | type: string | description: ID of the program the join application is for.
       - name: status  | type: string | description: Current status of the join application.  Read-only for member-initiated applications. A Wix user can set the initial status when creating an application on a member's behalf.
           enum: INVITED, APPROVAL_PENDING, APPROVED, CANCELLED, DECLINED, SUSPENDED
       - name: paymentStatus  | type: string | description: Payment status of the join application.
           enum: NO_PAYMENT_REQUIRED, PAYMENT_PENDING, PAYMENT_IN_PROGRESS, PENDING_OWNER_APPROVAL, PAYMENT_SUCCESSFUL, PAYMENT_FAILED, PAYMENT_CANCELED
       - name: paymentInfo  | type: PaymentInfo | description: Wix Payments or Pricing Plans data associated with the join application.
           - name: paymentOrderId  | type: string | description: Wix Payments order ID. Populated when the member selects one-time payment at checkout.
           - name: offlineTransactionId  | type: string | description: Offline transaction ID. Populated when the member selects manual payment at checkout.
           - name: paidPlanIds  | type: Array<string> | description: IDs of the pricing plans connected to the program. Populated when the member selects Pricing Plans at checkout.
           - name: couponId  | type: string | description: ID of the coupon applied to the payment order. Populated when a coupon is applied with [Apply Coupon](https://dev.wix.com/docs/api-reference/business-management/online-programs/join-applications/apply-coupon.md).
       - name: member  | type: Member | description: Snapshot of the member identified by `memberId`, copied from the Members API. It isn't the authoritative member record.
           - name: firstName  | type: string | description: Member contact's first name.
           - name: lastName  | type: string | description: Member contact's last name.
           - name: email  | type: string | description: Member's login email.
           - name: contactId  | type: string | description: Member's contact ID.
           - name: nickname  | type: string | description: Member's nickname.
           - name: profileImageUrl  | type: string | description: URL of the member's profile image.
       - name: participantId  | type: string | description: ID of the participant created from the join application.  Populated when `status` is `APPROVED` and `paymentStatus` is `NO_PAYMENT_REQUIRED` or `PAYMENT_SUCCESSFUL`.
       - name: extendedFields  | type: ExtendedFields | description: Custom field data for the join application object.  [Extended fields](https://dev.wix.com/docs/build-apps/develop-your-app/extensions/backend-extensions/schema-plugins/about-schema-plugin-extensions.md) must be configured in the app dashboard before they can be accessed with API calls.
           - name: namespaces  | type: object | description: Extended field data. Each key corresponds to the namespace of the app that created the extended fields. The value of each key is structured according to the schema defined when the extended fields were configured.  You can only access fields for which you have the appropriate permissions.  Learn more about [extended fields](https://dev.wix.com/docs/rest/articles/getting-started/extended-fields.md).
       - name: tags  | type: Tags | description: Tags for categorizing and organizing join applications.
           - name: privateTags  | type: TagList | description: Tags that require an additional permission in order to access them, typically restricted from site members and visitors.
               - name: tagIds  | type: Array<string> | description: List of tag IDs.
           - name: publicTags  | type: TagList | description: Tags that are exposed to anyone with access to the entity, including site members and visitors.

```