POST /sandbox/transfer/ledger/deposit/simulate

Use the /sandbox/transfer/ledger/deposit/simulate endpoint to simulate a ledger deposit event in the Sandbox environment.

Servers

https://production.plaid.com
https://sandbox.plaid.com

Request headers

Name	Type	Required	Description
`Content-Type`	String	Yes	The media type of the request body. Default value: "application/json"

Request body fields

Name	Type	Required	Description
`client_id`	String	No	Your Plaid API `client_id`. The `client_id` is required and may be provided either in the `PLAID-CLIENT-ID` header or as part of a request body.
`event_type`	String	Yes	The asynchronous event to be simulated. May be: `posted`, `settled`, `failed`, or `returned`. An error will be returned if the event type is incompatible with the current ledger sweep status. Compatible status --> event type transitions include: `sweep.pending` --> `sweep.posted` `sweep.pending` --> `sweep.failed` `sweep.posted` --> `sweep.settled` `sweep.posted` --> `sweep.returned` `sweep.settled` --> `sweep.returned` Possible values: `"sweep.posted"` `"sweep.settled"` `"sweep.returned"` `"sweep.failed"`
`sweep_id`	String	Yes	Plaid’s unique identifier for a sweep.
`failure_reason`	Object	No	The failure reason if the event type for a transfer is `"failed"` or `"returned"`. Null value otherwise.
`failure_reason.description`	String	No	A human-readable description of the reason for the failure or reversal.
`failure_reason.failure_code`	String	No	The failure code, e.g. `R01`. A failure code will be provided if and only if the transfer status is `returned`. See ACH return codes for a full listing of ACH return codes and RTP/RfP error codes for RTP error codes.
`failure_reason.ach_return_code`	String	No	The ACH return code, e.g. `R01`. A return code will be provided if and only if the transfer status is `returned`. For a full listing of ACH return codes, see Transfer errors.
`secret`	String	No	Your Plaid API `secret`. The `secret` is required and may be provided either in the `PLAID-SECRET` header or as part of a request body.

How to start integrating

Add HTTP Task to your workflow definition.
Search for the API you want to integrate with and click on the name.
- This loads the API reference documentation and prepares the Http request settings.
Click Test request to test run your request to the API and see the API's response.