---
title: "Create a reserve (admin only)"
method: POST
path: "/reserves"
tags: ["reserve"]
---

# Create a reserve (admin only)

`POST /reserves`

## Request body

- CreateReserveDto
  - `name` string, required — Reserve name
  - `country` string, required — Country
  - `countryCode` string — ISO 3166-1 alpha-2 country code (lowercased). Used by the frontend to render the flag sprite (e.g. "au" => flag-au).
  - `city` string, required — City
  - `lat` number, required — Latitude
  - `lng` number, required — Longitude
  - `type` 1 | 2 | 3, required — Reserve type
  - `paymentFromType` 1 | 2 | 3 | 4 | 5 | 6 | 7 — How reserve payments are funded. Required for off-chain reserves (USD or USDC). Omit for on-chain cash equivalents — set automatically to USDC.
  - `paymentFromValue` number, required — Value in wei of the payment from amount
  - `status` 'Active' | 'Coming soon' | 'Expired', required — Reserve status
  - `value` number, required — Value in USD cents (integer)
  - `apy` number, required — APY with 4 decimal places (e.g. 5.2500% => 52500).
  - `startDate` string, date-time — Reserve period start. Required except for property credit reserves, where it may be omitted (e.g. coming soon).
  - `endDate` string, date-time — Reserve period end. Required except for property credit reserves, where it may be omitted (e.g. coming soon).
  - `data` object, required — Type-specific reserve data (stored as JSONB). For secured loans include `paymentFrequency`. For cash equivalents use `ticker`, `custodian`, `liquidity`, optional `rating`, and when the position is on-chain (`cashEquivalentType` blockchain) also `yieldSource`, `valueUSDC`, `wallet`, `networkName`, `chainId`, and `contractAddress`. For property credit all fields are optional: collateral, estimated GDV, current/max LTV, loan status, project phase, ranking, backstop facility (amount and provider), and term (whole days).

## Response `201`

Reserve created

- Reserve

## Other responses

- `401` — Unauthorized
- `403` — Forbidden — Admin role required

---

[API](https://skmtc.dev/dre/apis/dre-api.md) · [All operations](https://skmtc.dev/dre/apis/dre-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/dre/dre-api/revisions/5d14beb9482b/schema)