Core Resources
Payment Methods
Products
Checkout
Payment Links
Billing
Capital
Connect
Reserves
Fraud
Issuing
Terminal
Treasury
Payment Records
Entitlements
Sigma
Reporting
Financial Connections
Tax
Identity
Crypto
Climate
Forwarding
Webhooks

Reserve Releases Preview

ReserveReleases represent the release of funds from a ReserveHold.

Endpoints

The ReserveRelease object Preview

Attributes

  • idstring

    Unique identifier for the object.

  • amountinteger

    Amount released. A positive integer representing how much is released in the smallest currency unit.

  • currencyenum

    Three-letter ISO currency code, in lowercase. Must be a supported currency.

  • metadatanullable objectConnect Only

    Set of key-value pairs that you can attach to an object. This can be useful for storing additional information about the object in a structured format.

  • reasonenum

    The reason for the ReserveRelease, indicating why the funds were released.

    Possible enum values
    bulk_hold_expiry

    The ReserveHold expired automatically according to its schedule.

    hold_released_early

    The ReserveHold was manually released before its scheduled release.

    hold_reversed

    The ReserveHold was reversed due to a refund or dispute.

    plan_disabled

    The ReserveHold was released due to its associated plan being disabled.

  • released_attimestamp

    The release timestamp of the funds.

  • reserve_holdnullable stringExpandable

    The ReserveHold this ReserveRelease is associated with.

  • source_transactionnullable object

    The transaction which triggered this ReserveRelease.

More attributes

  • objectstring

  • createdtimestamp

  • created_byenum

  • livemodeboolean

  • reserve_plannullable stringExpandable

The ReserveRelease object
{
  "id": "resrel_61SxyHbQOe90T6sLB41Q8rCFhzAUW",
  "object": "reserve.release",
  "amount": 500,
  "created": 1753406491,
  "created_by": "application",
  "currency": "usd",
  "livemode": false,
  "metadata": {},
  "reason": "hold_released_early",
  "released_at": 1753406491,
  "reserve_hold": "reshold_61SxrUZH1aQJj97WT41Q8rCFhzAUW",
  "reserve_plan": null
}

Create a ReserveRelease Preview

Create a ReserveRelease to manually release funds from a ReserveHold.

Parameters

  • reserve_holdstringRequired

    The ReserveHold to release.

  • amountinteger

    Amount to release from the provided ReserveHold. A positive integer representing how much to release in the smallest currency unit (e.g., 100 cents to release $1.00 or 100 to release ¥100, a zero-decimal currency). If not provided, the full releasable amount of the ReserveHold is released.

  • currencyenum

    Three-letter ISO currency code, in lowercase. Must be a supported currency.

  • metadataobject

    Set of key-value pairs that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to metadata.

Returns

Returns a ReserveRelease object.

POST /v1/reserve/releases
cURL
curl https://api.stripe.com/v1/reserve/releases \
  -u "sk_test_BQokikJ...2HlWgH4olfQ2sk_test_BQokikJOvBiI2HlWgH4olfQ2:" \
  -H "Stripe-Account: {{CONNECTED_ACCOUNT_ID}}" \
  -d reserve_hold=reshold_61SxrUZH1aQJj97WT41Q8rCFhzAUW \
  -d amount=500 \
  -d currency=usd
Response
{
  "id": "resrel_61SxyHbQOe90T6sLB41Q8rCFhzAUW",
  "object": "reserve.release",
  "amount": 500,
  "created": 1753406491,
  "created_by": "application",
  "currency": "usd",
  "livemode": false,
  "metadata": {},
  "reason": "hold_released_early",
  "released_at": 1753406491,
  "reserve_hold": "reshold_61SxrUZH1aQJj97WT41Q8rCFhzAUW",
  "reserve_plan": null
}

Update a ReserveRelease Preview

Update a ReserveRelease’s metadata.

Parameters

  • idstringRequired

    The identifier of the ReserveRelease to update.

  • metadataobjectRequired

    Set of key-value pairs that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to metadata.

Returns

Returns the updated ReserveRelease object.

POST /v1/reserve/releases/:id
cURL
curl https://api.stripe.com/v1/reserve/releases/resrel_61SxyHbQOe90T6sLB41Q8rCFhzAUW \
  -u "sk_test_BQokikJ...2HlWgH4olfQ2sk_test_BQokikJOvBiI2HlWgH4olfQ2:" \
  -H "Stripe-Account: {{CONNECTED_ACCOUNT_ID}}" \
  -d "metadata[test_key]"=test_value
Response
{
  "id": "resrel_61SxyHbQOe90T6sLB41Q8rCFhzAUW",
  "object": "reserve.release",
  "amount": 500,
  "created": 1753406491,
  "created_by": "application",
  "currency": "usd",
  "livemode": false,
  "metadata": {
    "test_key": "test_value"
  },
  "reason": "hold_released_early",
  "released_at": 1753406491,
  "reserve_hold": "reshold_61SxrUZH1aQJj97WT41Q8rCFhzAUW",
  "reserve_plan": null
}

Retrieve a ReserveRelease Preview

Retrieve a ReserveRelease.

Parameters

  • idstringRequired

    The identifier of the ReserveRelease to retrieve.

Returns

Returns a ReserveRelease object.

GET /v1/reserve/releases/:id
curl https://api.stripe.com/v1/reserve/releases/resrel_61SxyHbQOe90T6sLB41Q8rCFhzAUW \
  -u "sk_test_BQokikJ...2HlWgH4olfQ2sk_test_BQokikJOvBiI2HlWgH4olfQ2:"
Response
{
  "id": "resrel_61SxyHbQOe90T6sLB41Q8rCFhzAUW",
  "object": "reserve.release",
  "amount": 500,
  "created": 1753406491,
  "created_by": "application",
  "currency": "usd",
  "livemode": false,
  "metadata": {},
  "reason": "hold_released_early",
  "released_at": 1753406491,
  "reserve_hold": "reshold_61SxrUZH1aQJj97WT41Q8rCFhzAUW",
  "reserve_plan": null
}