POST
/
v2
/
request
Create a New Request
curl --request POST \
  --url https://api.request.network/v2/request \
  --header 'Content-Type: application/json' \
  --data '{
  "payer": "<string>",
  "payee": "<string>",
  "amount": "<string>",
  "invoiceCurrency": "<string>",
  "paymentCurrency": "<string>",
  "isCryptoToFiatAvailable": true,
  "recurrence": {
    "startDate": {},
    "frequency": {}
  }
}'
{
  "paymentReference": "0xb3581f0b0f74cc61",
  "requestId": "01e273ecc29d4b526df3a0f1f05ffc59372af8752c2b678096e49ac270416a7cdb"
}

​
Headers

​
x-api-key
string
required
API key for authentication

​
Body

​
payer
string
The wallet address of the payer
​
payee
string
The wallet address of the payee. Required for all requests except crypto-to-fiat
​
amount
string
required
The payable amount of the invoice, in human readable format
​
invoiceCurrency
string
required
Invoice Currency ID, from the Request Network Token List e.g: USD
​
paymentCurrency
string
required
Payment currency ID, from the Request Network Token List e.g: ETH-sepolia-sepolia
​
isCryptoToFiatAvailable
boolean
Whether crypto-to-fiat payment is available for this request
​
recurrence
object
The recurrence of the invoice

​
Response

​
201 Request created successfully

​
Response
object
{
  "paymentReference": "0xb3581f0b0f74cc61",
  "requestId": "01e273ecc29d4b526df3a0f1f05ffc59372af8752c2b678096e49ac270416a7cdb"
}

​
Error Responses

​
400
object
Validation failed - check your request parameters
​
401
object
Unauthorized - invalid API key
​
404
object
Wallet not found
​
429
object
Too Many Requests - rate limit exceeded