# Create a cashout

## Generate cashout request

> This endpoint allows generating withdrawal requests (cashouts)

```json
{"openapi":"3.0.0","info":{"title":"Cashout API","version":"3.0.0"},"servers":[{"url":"https://api-stg.directa24.com/v3","description":"Staging server"}],"paths":{"/cashout":{"post":{"summary":"Generate cashout request","description":"This endpoint allows generating withdrawal requests (cashouts)","tags":["Cashout"],"parameters":[{"in":"header","name":"Content-Type","required":true,"schema":{"type":"string","default":"application/json"},"description":"Request content type"},{"in":"header","name":"Payload-Signature","required":true,"schema":{"type":"string"},"description":"Control signature to verify the authenticity of the request"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CashoutRequest"}}}},"responses":{"200":{"description":"Cashout request successfully created","content":{"application/json":{"schema":{"type":"object","properties":{"cashout_id":{"type":"string","description":"Unique identifier for the generated cashout"}}}}}},"400":{"description":"Request error (KYC error)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Authentication error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"412":{"description":"Data validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}},"components":{"schemas":{"CashoutRequest":{"type":"object","required":["login","pass","external_id","country","amount","document_id","beneficiary_name","notification_url"],"properties":{"login":{"type":"string","description":"Your access key for the D24 CASHOUTS API"},"pass":{"type":"string","description":"Your password key for the D24 CASHOUTS API"},"external_id":{"type":"string","description":"Unique cashout ID on the merchant side"},"country":{"type":"string","description":"Country of the cashout"},"amount":{"type":"number","description":"Cashout amount"},"currency":{"type":"string","description":"Currency in which the amount is specified"},"document_id":{"type":"string","description":"Beneficiary's document ID"},"document_type":{"type":"string","description":"Specified identity document type"},"beneficiary_id":{"type":"string","description":"Beneficiary ID (for anonymous)"},"beneficiary_name":{"type":"string","description":"Beneficiary's name"},"beneficiary_lastname":{"type":"string","description":"Beneficiary's last name"},"email":{"type":"string","description":"Beneficiary's email address"},"phone":{"type":"string","description":"Beneficiary's phone number"},"bank_code":{"type":"number","description":"Beneficiary's bank code"},"bank_account":{"type":"string","description":"Beneficiary's bank account"},"bank_branch":{"type":"string","description":"Bank branch of the beneficiary's account"},"account_type":{"type":"string","description":"Beneficiary's account type"},"address":{"type":"string","description":"Beneficiary's address"},"city":{"type":"string","description":"Beneficiary's city"},"postal_code":{"type":"string","description":"Beneficiary's postal code"},"beneficiary_birthdate":{"type":"string","description":"Beneficiary's date of birth"},"notification_url":{"type":"string","description":"URL where notifications will be sent"},"comments":{"type":"string","description":"Comments about the cashout"},"on_hold":{"type":"boolean","description":"Marks a cashout as on hold and does not process it until manually changed to pending"},"type":{"type":"string","description":"Response format type"}}},"ErrorResponse":{"type":"object","properties":{"code":{"type":"integer","description":"Error code"},"message":{"type":"string","description":"Descriptive error message"},"reason":{"type":"string","description":"Detailed reason for the error"},"reason_code":{"type":"integer","description":"Specific code for the error reason"}}}}}}
```