> For the complete documentation index, see [llms.txt](https://docs.vida.id/identity-stack/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.vida.id/identity-stack/authentication/authentication-factors/password-api/api-reference.md).

# API Reference

The following APIs support the complete password-based identity provisioning and authentication flow. They are organized into two logical phases: **Initiation** and **Completion**.

| Phase          | API Name                               | Description                                                                                              | API Reference Link                                                                                                                              |
| -------------- | -------------------------------------- | -------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- |
| **Initiation** | Password Provisioning Initiation       | Begins the password provisioning process. Returns a session ID, bearer token, and follow-up URL.         | [View API](/identity-stack/authentication/authentication-factors/password-api/api-reference/password-initiation.md#provisioning)                |
|                | Password Authentication API            | Initiates authentication using a password. Returns a session ID, bearer token, and a challenge.          | [View API](/identity-stack/authentication/authentication-factors/password-api/api-reference/password-initiation.md#password-authentication-api) |
| **Completion** | Password Provisioning Completion API   | Completes provisioning by accepting the user’s chosen password. Returns a JWT and credential ID.         | [View API](/identity-stack/authentication/authentication-factors/password-api/api-reference/password-completion.md#provisioning-completion-api) |
|                | Password Authentication Completion API | Completes password authentication by validating the user’s password. Returns access tokens upon success. | [View API](/identity-stack/authentication/authentication-factors/password-api/api-reference/password-completion.md#password-authentication-api) |