Fetch invoices

Returns a list of invoices created within the given time window (From/To).

POST https://app.thedex.cloud/api/v1/invoices

Headers

Name	Type	Description
X-EX-APIKEY*	String	Your API key
X-EX-PAYLOAD*	String	Body to base64
X-EX-SIGNATURE*	String	Encrypted body with the secret key

Request Body

{
    "from": "Number", // timestamp
    "to": "Number" // timestamp
}

Request JSON attributes

Name	Type	Description
from	Long	Timestamp (from) in milliseconds since Unix epoch
to	Long	Timestamp (to) in milliseconds since Unix epoch

Response body

200 invoice

[
{
   "invoiceId": "String",
   "merchantId": "String",
   "orderId": "String",
   "clientId": "String",
   "status": "Integer",
   "statusName": "String",
   "createDate": "String",
   "modifiedDate": "String",
   "expirationDate": "String",
   "createTimestamp": "String",
   "modifiedTimestamp": "String",
   "expirationTimestamp": "String",
   "expirationDateInMilliseconds": "Long",
   "purse": "String",
   "memo": "String",
   "currency": "String",
   "payCurrency": "String",
   "amount": "String",
   "amountInPayCurrency": "String",
   "paidAmount":"String",
   "paidAmountFiat": "String",
   "payUrl": "String",
   "creationWay": "String",
   "merchantCommission": "String",
   "merchantBalance": "String",
   "title": "String",
   "description": "String",
   "uniqueUserId":" String",
   "depositBlockchainFee": "String",
   "rate": "String",
   "rateWithCommission": "String",
   "txId": "String"[],
   "fromAddress": [],
   "successUrl": "String",
   "failureUrl": "String",
   "merchantSiteUrl": "String",
   "callbackUrl": "String",
   "complexCommission": "String"
},

{...}
]

Response JSON attributes:

"invoiceId"	String	Invoice id.
"merchantId"	String	Merchant id.
"orderId"	String	Order id.
"clientId"	String	Client id.
"status"	Integer	reach out all accessed values by link: /api/v1/info/statuses
"statusName"	String	reach out all accessed values by link: /api/v1/info/statuses
"createDate"	String	Creation date.
"modifiedDate"	String	Modification date.
"expirationDate"	String	Expiration date.
"createTimestamp"	Long	Creation date in milliseconds
"modifiedTimestamp"	Long	Modified date in milliseconds
"expirationTimestamp"	Long	Expiration date in milliseconds
"expirationDateInMilliseconds"	Long	Left expiration time in milliseconds.
"purse"	String	Crypto-address is used by client to send cryptocurrency.
"currency"	String	reach out all accessed values by link: /api/v1/info/currencies
"payCurrency"	String	reach out all accessed values by link: /api/v1/info/currencies
"amount"	String	Amount in fiat currency.
"amountInPayCurrency"	String	Converted amount in cryptocurrency.
"paidAmount"	String	Represents paid amount in crypto-currency.
"paidAmountFiat"	String	Represents paid amount in fiat currency.
"payUrl"	String	Url is used to deposit.
"callbackUrl"	String	Callback URL. To reach out more about statuses that trigger callback read the section about /api/v1/info/statuses
"creationWay"	String	For this usage “API“. To reach out more creation ways use:/api/v1/info/invoice/creation/ways
"merchantCommission"	String	Merchant commission.
"merchantBalance"	String	Merchant balance.
"title"	String	Title.
"description"	String	Description.
"uniqueUserId"	String	User UUID.
"depositBlockchainFee"	String	Deposit blockchain fee.
"rate"	String	Rate.
"rateWithCommission"	String	Rate with commission.
"txId"	String[]	Transactions list
"failureUrl"	String	Used for redirect to this reference on failure invoice status. You could set this URL individually to merchant.
"successUrl"	String	Used for redirect to this reference on success invoice status. You could set this URL individually to merchant.
"merchantSiteUrl"	String	Used for redirect to this reference if successUrl or failureUrl are not defined.
"memo"	String	Note for payment
"fromAddress"	String[]	From Address list
"complexCommission"	String	Used for commision

Request Curl

curl --location --request POST 'https://app.thedex.cloud/api/v1/invoices' \
--header 'X-EX-APIKEY: <string>' \
--header 'X-EX-PAYLOAD: <string>' \
--header 'X-EX-SIGNATURE: <string>' \
--header 'Content-Type: application/json' \
--header 'Accept: */*' \
--data '{
  "from": "<Long>",
  "to": "<Long>"
}'

Example Curl

curl --location --request POST 'https://app.thedex.cloud/api/v1/invoices' \
--header 'X-EX-APIKEY: test_api_key_123' \
--header 'X-EX-PAYLOAD: eyJmcm9tIjoxNzE4MDAwMDAwMDAsInRvIjoxNzE4MTIwMDAwMDAwfQ==' \
--header 'X-EX-SIGNATURE: dummy_signature_abc1234567890' \
--header 'Content-Type: application/json' \
--header 'Accept: */*' \
--data '{
  "from": 1718000000000,
  "to": 1718120000000
}'