Get Settlement List
1 min
api that returns a list of settlements for the client this api requires access token that can be generated using access token docid\ hccakrqi4shqrffpcboir api a settlement represents the final amount transferred to the client’s bank account for one or more completed crypto orders it includes settlement status, final amount received in the bank account, settlement currency, applicable bank transfer fee, and bank transfer reference id settlementid unique id of the settlement clientid client id requestid unique id passed during order creation fromdate return settlements created on or after this date format yyyy mm dd todate return settlements created on or before this date format yyyy mm dd status status of the settlement possible values are created , processing , completed , failed , rejected netreceivedamount final amount received in the client’s bank account after applicable bank transfer fees fiatcurrencyid currency in which the settlement was transferred to the client’s bank account example aed ae transferfee bank transfer fee deducted from the settlement amount this will be 0 if no bank fee was applied transferreferenceid bank transfer reference id for the settlement transfertriggeredts \ timestamp at which the settlement bank transfer was initiated orderlist list of crypto orders included in the settlement errorreason contains errorcode and errordesc will be received only in case if status is failed list of possible sdk errors docid 94kyvqwbrsg1dfmljddbs { "name" "get settlement details", "method" "get", "url" "https //your hostname pay3 app/v1/client/exchange settlement/list?settlementid={}\&requestid={}\>e=2024 07 15\<e=2024 07 15", "description" "get order details by client's request id", "tab" "examples", "examples" { "languages" \[ { "id" "3ljxgjcqzzkeicmdoi23s", "language" "curl", "code" "curl location 'https //your hostname pay3 app/v1/client/exchange settlement/list?settlementid={}\&requestid={}\>e=2024 07 15\<e=2024 07 15' \\\\\n header 'accept application/json' \\\\\n header 'content type application/json' \\\\\n header 'client id {}'\n header 'access token access token in jwt'", "customlabel" "" } ], "selectedlanguageid" "3ljxgjcqzzkeicmdoi23s" }, "results" { "languages" \[ { "id" "gc lbeev7jo hgfni1chk", "language" "200", "code" "{\n\\"exchange settlements\\" \[{\n \\"settlementid\\" \\"\\",\n \\"status\\" \\"\\", // created, processing, completed, failed, rejected\n \\"fiatcurrencyid\\" \\"aed ae\\", // fiat currency id — must match fiatcurrencyid \n \\"transferdetails\\" {\n \\"netreceivedamount\\" \\"\\", \n \\"transferreferenceid\\" \\"\\",\n \\"transfertriggeredts\\" \\"\\"\n }]\n}", "customlabel" "" }, { "id" "ybev9li4twgz n2zw 919", "language" "401", "code" "{\\"error\\" \\"client verification failed\\"}", "customlabel" "" } ], "selectedlanguageid" "gc lbeev7jo hgfni1chk" }, "request" { "pathparameters" \[], "queryparameters" \[ { "name" "settlementid", "kind" "optional", "type" "string", "description" "unique id of the settlement ", "" "optional" }, { "name" "requestid", "kind" "optional", "type" "string", "description" "request id is the unique id that was passed by your application while creating the order ", "" "request id is the unique id that was passed by your application while creating the order " }, { "name" "fromdate", "kind" "optional", "type" "string", "description" "return settlements created on or after this date format yyyy mm dd ", "" "fromdate" }, { "name" "todate", "kind" "optional", "type" "string", "description" "return settlements created on or before this date format yyyy mm dd ", "" "todate" } ], "headerparameters" \[ { "name" "access token", "kind" "required", "type" "string", "description" "access token received from access token api you can reuse the access token across multiple api calls till it is expired ", "children" \[] }, { "name" "clientid", "kind" "required", "type" "string", "description" "client id", "" "required" } ], "bodydataparameters" \[], "formdataparameters" \[] }, "currentnewparameter" { "label" "query parameter", "value" "queryparameters" }, "hastryitout" false, "autogeneratedanchorslug" "get settlement details", "legacyhash" "s47prcosdcg6c9bw46jeg" }