---
title: "Create subscriptions for one SPV"
method: POST
path: "/v1/spvs/{spv_slug}/subscriptions"
tags: ["Subscriptions"]
---

# Create subscriptions for one SPV

`POST /v1/spvs/{spv_slug}/subscriptions`

Creates one or more partner-managed subscription rows for a single SPV. Each subscription auto-creates a Bid under the hood (source=partner-api). Per investor: lump sum + share class. `Idempotency-Key` is optional.

## Path parameters

- `spv_slug` string, required

## Headers

- `Idempotency-Key` string

## Request body

- SubscriptionBulkCreate
  - `subscriptions` SubscriptionCreateRow[], required
    - `partnerSubscriptionId` string — Optional partner-side subscription id; echoed on the response for correlation.
    - `zestPersonId` string, required
    - `lumpSum` object, required — {currency, value} object — currency is ISO 4217, value is a decimal string.
    - `shareClassSlug` string, required

## Response `201`

Successful Response

- SubscriptionBulkResponse
  - `results` SubscriptionResult[], required
    - `partnerSubscriptionId` string
    - `subscriptionSlug` string, required
    - `spvSlug` string, required
    - `personId` string, required
    - `status` string, required
    - `lumpSum` object, required
    - `shareClassSlug` string, required

## Other responses

- `400` — Validation failed
- `401` — Invalid token
- `403` — Service not provisioned for partner API
- `404` — SPV not found
- `409` — Idempotency-Key conflict (different body)
- `422` — Validation Error

---

[API](https://skmtc.dev/zestequity/apis/zest-equity-public-api-api.md) · [All operations](https://skmtc.dev/zestequity/apis/zest-equity-public-api-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/zestequity/zest-equity-public-api-api/revisions/0df065045794/schema)