curl --request GET \
--url https://sandbox-api.polygon.technology/v0.11/cash-ins \
--header 'Authorization: Bearer <token>'import requests
url = "https://sandbox-api.polygon.technology/v0.11/cash-ins"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://sandbox-api.polygon.technology/v0.11/cash-ins', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://sandbox-api.polygon.technology/v0.11/cash-ins",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://sandbox-api.polygon.technology/v0.11/cash-ins"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://sandbox-api.polygon.technology/v0.11/cash-ins")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://sandbox-api.polygon.technology/v0.11/cash-ins")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"data": [
{
"id": "ci_44vxe2xk8gfsjehfcw3npt5bg8",
"object": "cashIn",
"type": "fiatToCrypto",
"status": "pending",
"subStatus": "order_reserved",
"customerId": "cst_vfa0nxw6zvyws9g237jrxn4y7k",
"source": {
"asset": "usd",
"indicatedAmount": "200.00",
"amountGross": "200.00",
"amountNet": "200.00",
"feesDeducted": {
"total": "0.00",
"developer": "0.00",
"oms": "0.00",
"gas": "0.00"
}
},
"destination": {
"asset": "usdc",
"network": "polygon",
"amountGross": "200.00",
"amountNet": "200.00",
"feesDeducted": {
"total": "0.00",
"developer": "0.00",
"oms": "0.00",
"gas": "0.00"
},
"wallet": {
"id": "wlt_5h4jzzpr9xre3bamd9ca7qyghn",
"blockchainAddress": "0x7B3A9F2C4D1eA8bf6390cE5D2b7fA104c8e3D9B1"
}
},
"cash": {
"locationId": "loc_01H9Xd",
"locationReference": "R1JFRU5ET1QtMjQzNA=="
},
"location": {
"name": "CVS Pharmacy #4521",
"address": "123 Main St, San Francisco, CA 94105"
},
"rates": {
"pair": "usd/usdc",
"exchangeRate": "1.0000",
"effectiveRate": "1.0000"
},
"depositInstructions": {
"cashInCode": "483 291",
"locationName": "CVS Pharmacy #4521",
"locationAddress": "123 Main St, San Francisco, CA 94105"
},
"fixedAmountSide": "source",
"sponsorGas": true,
"sponsorGasCost": "0",
"expiresAt": "2026-05-15T18:32:48Z",
"createdAt": "2026-05-15T17:32:48Z",
"updatedAt": "2026-05-15T17:32:48Z"
}
],
"hasMore": true,
"nextCursor": "<string>"
}List cash-ins
Returns a paginated list of cash-ins, optionally filtered by customer,
status, type, date range, or free-text search. Results are ordered
newest-first. Date filters createdAfter and createdBefore are inclusive,
matching GET /transactions.
curl --request GET \
--url https://sandbox-api.polygon.technology/v0.11/cash-ins \
--header 'Authorization: Bearer <token>'import requests
url = "https://sandbox-api.polygon.technology/v0.11/cash-ins"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://sandbox-api.polygon.technology/v0.11/cash-ins', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://sandbox-api.polygon.technology/v0.11/cash-ins",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://sandbox-api.polygon.technology/v0.11/cash-ins"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://sandbox-api.polygon.technology/v0.11/cash-ins")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://sandbox-api.polygon.technology/v0.11/cash-ins")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"data": [
{
"id": "ci_44vxe2xk8gfsjehfcw3npt5bg8",
"object": "cashIn",
"type": "fiatToCrypto",
"status": "pending",
"subStatus": "order_reserved",
"customerId": "cst_vfa0nxw6zvyws9g237jrxn4y7k",
"source": {
"asset": "usd",
"indicatedAmount": "200.00",
"amountGross": "200.00",
"amountNet": "200.00",
"feesDeducted": {
"total": "0.00",
"developer": "0.00",
"oms": "0.00",
"gas": "0.00"
}
},
"destination": {
"asset": "usdc",
"network": "polygon",
"amountGross": "200.00",
"amountNet": "200.00",
"feesDeducted": {
"total": "0.00",
"developer": "0.00",
"oms": "0.00",
"gas": "0.00"
},
"wallet": {
"id": "wlt_5h4jzzpr9xre3bamd9ca7qyghn",
"blockchainAddress": "0x7B3A9F2C4D1eA8bf6390cE5D2b7fA104c8e3D9B1"
}
},
"cash": {
"locationId": "loc_01H9Xd",
"locationReference": "R1JFRU5ET1QtMjQzNA=="
},
"location": {
"name": "CVS Pharmacy #4521",
"address": "123 Main St, San Francisco, CA 94105"
},
"rates": {
"pair": "usd/usdc",
"exchangeRate": "1.0000",
"effectiveRate": "1.0000"
},
"depositInstructions": {
"cashInCode": "483 291",
"locationName": "CVS Pharmacy #4521",
"locationAddress": "123 Main St, San Francisco, CA 94105"
},
"fixedAmountSide": "source",
"sponsorGas": true,
"sponsorGasCost": "0",
"expiresAt": "2026-05-15T18:32:48Z",
"createdAt": "2026-05-15T17:32:48Z",
"updatedAt": "2026-05-15T17:32:48Z"
}
],
"hasMore": true,
"nextCursor": "<string>"
}Authorizations
Token from POST /auth/token
Query Parameters
Filter to a single customer (cst_ prefix).
Filter by status.
Filter by type.
Direction of value across rails: cryptoToCrypto, fiatToCrypto, or cryptoToFiat.
Retained for resources not yet on the SourceToDestination shape
(onramp/cash-in, customer filters).
cryptoToCrypto, fiatToCrypto, cryptoToFiat Inclusive lower bound on createdAt.
Inclusive upper bound on createdAt.
Free-text search. Matches cash-in id, customer id, or customer email.
Alias for search.
Maximum number of results per page.
Opaque pagination cursor from a previous response; omit for the first page.
Response
The request has succeeded.
A paginated list of cash-ins.
The page of results.
Hide child attributes
Hide child attributes
Cash-in ID (ci_ prefix).
^[a-z]+_([0-9a-hjkmnp-tv-z]{26}|[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12})$Cash-in flavor.
cryptoToCrypto, fiatToCrypto, cryptoToFiat Current lifecycle status of the cash-in.
pending, processing, completed, failed, expired The OMS customer that owns this record (cst_ prefix).
^[a-z]+_([0-9a-hjkmnp-tv-z]{26}|[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12})$Where the customer deposits cash: the provider and location.
Hide child attributes
Hide child attributes
Canonical asset identifier.
Network identifier.
Email address.
The cash amount the customer indicated they will deposit.
Amount as a decimal string.
Amount on this side before fees are applied.
Amount after fees - what is actually pulled from a source, or delivered to a destination.
Per-side breakdown of fees deducted in-line from the transaction.
End-of-month billable fees will be reported separately in the future
(planned feesInvoice sibling). Denominated in that side's asset.
Hide child attributes
Hide child attributes
Per-side aggregated developer fee total in this side's asset. Always "0" in alpha - alpha invariant, mirrors the gas line.
Crypto instrument the converted funds are delivered to.
Hide child attributes
Hide child attributes
The wallet receiving the converted funds.
Hide child attributes
Hide child attributes
Unique identifier.
^[a-z]+_([0-9a-hjkmnp-tv-z]{26}|[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12})$Registered External Account receiving the funds, when applicable.
On-chain address. For an EVM network the address must be all-lowercase, all-uppercase, or a valid EIP-55 checksummed form; an inconsistent mixed-case address is rejected as a likely casing typo, and the zero address is rejected. Solana/SUI are validated per their own network rules.
Canonical asset identifier.
Network identifier.
Amount on this side before fees are applied.
Amount after fees - what is actually pulled from a source, or delivered to a destination.
Per-side breakdown of fees deducted in-line from the transaction.
End-of-month billable fees will be reported separately in the future
(planned feesInvoice sibling). Denominated in that side's asset.
Hide child attributes
Hide child attributes
Per-side aggregated developer fee total in this side's asset. Always "0" in alpha - alpha invariant, mirrors the gas line.
When the cash-in was created.
When the cash-in was last updated.
Resource type discriminator. Always "cashIn".
cashIn Granular sub-status adding detail behind status.
order_reserved, settled, cash_deposit_expired, cash_deposit_failed, provider_order_failed, provider_order_template_error The side the amount was fixed on when creating the cash-in. OMS calculated the other side.
source, destination The deposit code and instructions the customer presents at the retail location.
Exchange and effective rates applied to this cash-in.
USD cost of gas absorbed by the developer when sponsoring gas. Always "0" in alpha - gas is sponsored. Spec § 4.1.
OMS fee schedule applied to this cash-in.
Hide child attributes
Hide child attributes
Currency the fee lines are denominated in.
The Transaction produced once the cash-in completes. Null while pending.
^[a-z]+_([0-9a-hjkmnp-tv-z]{26}|[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12})$When true, OMS absorbs the on-chain gas cost for the destination delivery. Only true is currently supported.
Developer fee entries echoed back from the request. Omitted in alpha - request side is stripped per spec § 2. The field stays on the schema so it can be reintroduced without a breaking change when developer fees ship.
Hide child attributes
Hide child attributes
Unique identifier assigned by OMS. Present on responses only.
Percentage fee as a decimal rate. "0.02" = 2%.
Fixed fee in USD. Converted to fee-side asset at the exchange rate.
Computed fee amount for this entry. Present on responses only.
Crypto asset for fee payout. Defaults to "usdc".
usdc, usdt OMS wallet to receive this fee.
When the cash-in reached a terminal state. Null while in progress.
When the issued deposit code expires. Single source of truth for cash-in expiry (#2144); the per-instruction expiresAt was removed in favor of this.
Whether more results exist beyond this page.
Cursor for the next page; null when there are no more results.
Was this page helpful?