---
title: "Create an SPV request"
method: POST
path: "/v1/spv-requests"
tags: ["SPV Requests"]
---

# Create an SPV request

`POST /v1/spv-requests`

Submits an SPV creation request. Validation runs against the spaas-contract template indicated by `templateId`. On success, Zest fires `spv_request.created`. Admin review materialises the SPV; success fires `spv_request.completed`.

## Headers

- `Idempotency-Key` string

## Request body

- SpvRequestCreate
  - `templateId` string, required — Contract template id (e.g. 'syndicate_secondary').
  - `templateVersion` string, required — Contract template version (e.g. '1.0.0').
  - `attributes` object, required — Flat attribute map validated against the template.

## Response `201`

Successful Response

- SpvRequestResponse
  - `spvRequestSlug` string, required
  - `status` 'pending-review' | 'approved' | 'rejected' | 'cancelled', required — An enumeration.
  - `templateId` string, required
  - `templateVersion` string, required
  - `tenantSlug` string, required
  - `clientId` string, required
  - `attributes` object, required
  - `rejectionReason` string
  - `cancelledAt` string, date-time
  - `approvedAt` string, date-time
  - `materialisedRefs` MaterialisedRefsResponse
    - `opportunitySlug` string, required
    - `vehicleSlug` string, required
    - `spSlug` string, required
    - `spcSlug` string, required
  - `feesAndCarry` FeesAndCarryResponse
    - `shareClasses` ShareClassFeesAndCarry[]
      - `name` string, required
      - `slug` string, required
      - `managementFeePercent` string
      - `carryPercent` string
      - `setupFee` object
  - `createdAt` string, date-time, required
  - `updatedAt` string, date-time, required

## Other responses

- `400` — Contract validation failed
- `401` — Invalid token
- `403` — Service not provisioned for partner API
- `404` — Template not found
- `409` — Idempotency-Key conflict
- `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)