> ## Documentation Index
> Fetch the complete documentation index at: https://laas.mippo.io/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Apply for access to Supercosmos for Platforms

> Submit an access application to onboard your company to the Supercosmos for Platforms API, including legal entity details, contact info, and use case.

> [!NOTE]
>
> This endpoint uses Clerk JWT auth (your Supercosmos login session), not an API key. It is called by the `/laas/apply` frontend — not from your integration code.

## Request

**companyName** `string` *required*

Legal company name.

**cnpj** `string` *required*

Brazilian CNPJ.

**spsavLicenseNumber** `string`

Your company's own SPSAV authorization number, if it has one. Leave empty otherwise.

**integrationType** `string` *required*

`"direct"` | `"via_partner"` | `"shared"`

**expectedVolumeBrl** `number` *required*

Expected monthly transaction volume in BRL.

**webhookUrl** `string`

Webhook endpoint URL. Can be added later in the developer dashboard.

## Response

```json Response (201) theme={null}
{
  "success": true,
  "data": {
    "partnerId": "partner_abc123",
    "status": "PENDING",
    "message": "Application received. We review within 2 business days."
  }
}
```

On approval, you receive an email and can generate API keys in the developer dashboard.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.