> ## Documentation Index
> Fetch the complete documentation index at: https://better-auth-razorpay.amankushwaha.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Add-ons

> Retrieve, list, and delete Razorpay add-ons through the plugin endpoints.

The add-ons endpoints let you fetch, list, and delete Razorpay add-ons. Add-ons are created by linking items to an existing subscription.

> [!NOTE]
>
> To create an add-on, use the subscription add-on endpoint described in [Razorpay subscriptions](https://better-auth-razorpay.amankushwaha.dev/api-reference/razorpay-subscriptions.md).

## Get add-on

`GET /api/auth/razorpay/addon/get`

Retrieves a single Razorpay add-on by id.

**Server API name:** `fetchAddon`\
**Client method:** `authClient.razorpay.addon.get({ query: { addonId } })`

**addonId** `string` *required*

Razorpay add-on id.

> [!NOTE]
>
> Errors: `ADDON_NOT_FOUND`, `ADDON_FETCH_FAILED`.

```ts client.ts theme={null}
const { data, error } = await authClient.razorpay.addon.get({
  query: { addonId: "ao_XXXX" },
});
```

```ts server.ts theme={null}
const result = await auth.api.fetchAddon({
  query: { addonId: "ao_XXXX" },
  headers: await headers(),
});
```

## List add-ons

`GET /api/auth/razorpay/addon/list`

Lists Razorpay add-ons with pagination.

**Server API name:** `listAddons`\
**Client method:** `authClient.razorpay.addon.list({ query: { ... } })`

**from** `integer`

Unix timestamp. Return add-ons created after this time.

**to** `integer`

Unix timestamp. Return add-ons created before this time.

**count** `integer`

Maximum number of add-ons to return. Maximum value is `100`.

**skip** `integer`

Number of add-ons to skip.

> [!NOTE]
>
> Errors: `ADDON_LIST_FAILED`.

```ts client.ts theme={null}
const { data, error } = await authClient.razorpay.addon.list({
  query: { count: 10, skip: 0 },
});
```

```ts server.ts theme={null}
const result = await auth.api.listAddons({
  query: { count: 10, skip: 0 },
  headers: await headers(),
});
```

## Delete add-on

`POST /api/auth/razorpay/addon/delete`

Deletes a Razorpay add-on.

**Server API name:** `deleteAddon`\
**Client method:** `authClient.razorpay.addon.delete(...)`

**addonId** `string` *required*

Razorpay add-on id to delete.

> [!NOTE]
>
> Errors: `ADDON_DELETE_FAILED`.

```ts client.ts theme={null}
const { data, error } = await authClient.razorpay.addon.delete({
  addonId: "ao_XXXX",
});
```

```ts server.ts theme={null}
const result = await auth.api.deleteAddon({
  body: { addonId: "ao_XXXX" },
  headers: await headers(),
});
```


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