> ## Documentation Index
> Fetch the complete documentation index at: https://developers.investorlift.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Access to the private beta

> How to get an account enabled for the Marketplace API, what a personal client and a registered application get, and what the beta costs.

<Note>
  The Marketplace API is in a private beta. It answers only for accounts Investorlift has enabled. [Access](/marketplace/access) says how to ask for one. A route shape on these pages can change before the beta ends. The changelog records every change.
</Note>

The Marketplace API answers only for accounts Investorlift has enabled. This page says who can ask, how to ask, what a
client is, and what the beta costs.

## Who can ask

You need an Investorlift account on Mogul, the account you use on the marketplace. A seller's account is a member of an
organization with the `seller` designation. A buyer's account carries the `buyer` designation. One account can hold both,
and one token then reaches both sides.

## How to ask

<Steps>
  <Step title="Send one email">
    Write to `support@investorlift.com` with the subject "Marketplace API access". Name the account email. For a seller, name
    the organization too.
  </Step>

  <Step title="Investorlift enables the account">
    A release flag at the gateway controls which accounts the API answers for. Investorlift sets it for your account and tells
    you by email. Until then, every route answers `403 not_enabled` for the account.
  </Step>

  <Step title="Sign in and accept the terms">
    Start the OAuth flow from your client. Sign in at the issuer, `https://mogul.investorlift.com/api/auth`, with your
    Investorlift account. The consent page lists each requested scope in one sentence. It also carries the Marketplace API
    Terms checkbox. A seller accepts the terms for the organization. A buyer accepts them for the person.

    [Authentication](/marketplace/authentication) has the flow. [Terms](/marketplace/terms) has the text. A token minted
    before the terms are on file answers `403 terms_required`.
  </Step>
</Steps>

## Personal client or registered application

Every developer starts with a personal client. A registered application is for a product that serves many organizations.

|                        | Personal client                                                             | Registered application                      |
| ---------------------- | --------------------------------------------------------------------------- | ------------------------------------------- |
| How it starts          | Dynamic client registration at the issuer, with no review                   | A review by Investorlift                    |
| The consent page shows | "Unregistered application" and the redirect host                            | The application's name and a verified badge |
| Who can connect        | One organization and three users. The fourth consent answers `client_limit` | Many organizations                          |
| Limits                 | The person's caps. `GET /me` prints them                                    | Higher caps across its users                |
| Good for               | Your own organization's integration, a script, an AI assistant              | A CRM, a deal tool, a partner product       |

Every scope is available to both kinds. The role rule alone limits `webhooks:manage` and `contacts:read` to an owner or an
admin of the organization. [Trust and limits](/marketplace/concepts/trust-and-limits) has the caps.

To ask for a review, send these six items to the same address with the same subject:

* a named company
* a privacy policy
* HTTPS redirect URIs
* the scopes you ask for, and why
* how you keep one customer's data apart from another's
* a security contact

Investorlift aims to answer within 10 business days.

## What the beta costs

* Sellers: the organization's Mogul plan includes the API. A publish through the API spends the same credits as a
  publish in the app. No route charges per request.
* Buyers: free with a verified account. The caps of your trust tier are the bound, not a price.
* No God Mode credits. The God Mode meter stays with God Mode, and no marketplace route charges a credit.

The packaging and the figures can change before the beta ends. The [changelog](/changelog) records a change.

## The sandbox

Investorlift plans a sandbox, and none is available yet. Every call in the beta reaches production data for the
signed-in account. A published deal is live on Mogul, a submitted offer reaches a real seller, and a publish spends real credits. `GET /me`
carries `environment`, which reads `production` on the live host.

Keep a test to drafts until you mean to publish. A draft holds no property slot and costs nothing.


## Related topics

- [The Marketplace API](/marketplace/overview.md)
- [What the API returns](/marketplace/concepts/what-the-api-returns.md)
- [Authentication](/marketplace/authentication.md)
- [Identifiers and the envelope](/marketplace/concepts/identifiers-and-envelope.md)
- [Idempotency](/marketplace/concepts/idempotency.md)