> ## Documentation Index > Fetch the complete documentation index at: https://docs.engine.usesophic.com/llms.txt > Use this file to discover all available pages before exploring further. # Create a withdrawal > Initiates a withdrawal of cash out of the account. ## OpenAPI ````yaml /openapi.json post /accounts/{account_id}/withdrawals openapi: 3.1.0 info: title: Sophic Engine API version: 0.1.0 servers: - url: https://api.engine.usesophic.com security: [] tags: - description: Retrieve accounts, statements, and account documents. name: accounts x-group: Accounts - description: Read the audit trail of platform activity. name: activity x-group: Activity - description: Obtain OAuth access tokens for the Engine API. name: auth x-group: Authentication - description: Inspect the authenticated user or service actor. name: identity x-group: Identity - description: Retrieve fee schedules and billing information. name: billing x-group: Billing - description: Browse instruments and tradable products. name: catalog x-group: Catalog - description: Track onboarding applications through completion. name: onboarding x-group: Onboarding - description: Manage customer records and related person data. name: customers x-group: Customers - description: List platform events and inspect individual occurrences. name: events x-group: Events - description: Read positions, transactions, and account holdings. name: holdings x-group: Holdings - description: Retrieve legal agreements and required disclosures. name: legal-documents x-group: Legal Documents - description: Access prices and market data for instruments. name: market-data x-group: Market Data - description: Manage deposits, withdrawals, and funding accounts. name: payments x-group: Payments - description: Retrieve returns, earnings, and performance metrics. name: performance x-group: Performance - description: Place and manage orders, quotes, and trades. name: trading x-group: Trading - description: Read position and account valuations over time. name: valuation x-group: Valuation - description: Configure webhook endpoints and inspect deliveries. name: webhooks x-group: Webhooks - description: Upload files and retrieve stored documents. name: files x-group: Files paths: /accounts/{account_id}/withdrawals: post: tags: - payments summary: Create a withdrawal description: Initiates a withdrawal of cash out of the account. operationId: create_withdrawal_accounts__account_id__withdrawals_post parameters: - in: path name: account_id required: true schema: title: Account Id type: string requestBody: content: application/json: schema: $ref: '#/components/schemas/CreateWithdrawalRequest' required: true responses: '201': content: application/json: schema: $ref: '#/components/schemas/Withdrawal' description: Created '400': content: application/json: schema: $ref: '#/components/schemas/Error' description: Bad Request security: - HTTPBearer: [] components: schemas: CreateWithdrawalRequest: properties: amount: anyOf: - exclusiveMinimum: 0 type: number - type: string description: Positive withdrawal amount with up to two decimal places. examples: - '100.00' title: Amount currency: allOf: - $ref: '#/components/schemas/Currency' description: Supported account currency to withdraw without conversion. funding_account: description: >- ID of the funding account that receives the withdrawal. Must be registered on the parent account. title: Funding Account type: string required: - amount - currency - funding_account title: CreateWithdrawalRequest type: object Withdrawal: properties: account: description: The ID of the parent account. title: Account type: string amount: description: The amount to withdraw. examples: - '100.00' - '50.12' title: Amount type: string completed_at: anyOf: - format: date-time type: string - type: 'null' description: The time the withdrawal was completed. examples: - '2026-07-14T09:34:12Z' title: Completed At created_at: description: >- The timestamp (in [ISO-8601](https://www.iso.org/iso-8601-date-and-time-format.html) format) of when the resource was created. format: date-time title: Created At type: string currency: allOf: - $ref: '#/components/schemas/Currency' description: The currency to withdraw. funding_account: allOf: - $ref: '#/components/schemas/FundingAccount' description: The funding account that will receive the funds. id: description: Unique resource identifier. title: Id type: string modified_at: description: >- The timestamp (in [ISO-8601](https://www.iso.org/iso-8601-date-and-time-format.html) format) of when the resource was last modified. format: date-time title: Modified At type: string status: allOf: - $ref: '#/components/schemas/WithdrawalStatus' description: The status of the withdrawal. required: - created_at - modified_at - id - account - amount - currency - status - funding_account title: Withdrawal type: object Error: properties: code: description: A machine-readable error code. title: Code type: string context: additionalProperties: anyOf: - type: string - type: integer description: An optional object for adding extra context to the error. title: Context type: object x-remove-null-from-type-union: true detail: description: A human-readable description of the error. title: Detail type: string docs: description: A URL to documentation about this error code. title: Docs type: string x-remove-null-from-type-union: true params: description: An optional list of params that failed validation. items: $ref: '#/components/schemas/InvalidParam' title: Params type: array x-remove-null-from-type-union: true required: - detail - code title: Error type: object Currency: enum: - EUR - USD - GBP properties: {} title: Currency type: string FundingAccount: properties: bank_code: description: The bank code, such as a BIC or SWIFT code. title: Bank Code type: string created_at: description: >- The timestamp (in [ISO-8601](https://www.iso.org/iso-8601-date-and-time-format.html) format) of when the resource was created. format: date-time title: Created At type: string currency: allOf: - $ref: '#/components/schemas/Currency' description: The currency of the funding account. iban: description: The IBAN of the funding account. title: Iban type: string id: description: Unique resource identifier. title: Id type: string is_verified: default: false description: Whether ownership of the funding account is verified. title: Is Verified type: boolean modified_at: description: >- The timestamp (in [ISO-8601](https://www.iso.org/iso-8601-date-and-time-format.html) format) of when the resource was last modified. format: date-time title: Modified At type: string nickname: anyOf: - type: string - type: 'null' description: The user-provided nickname for the funding account. title: Nickname owner_name: description: The owner name as specified by the bank on the funding account. title: Owner Name type: string required: - created_at - modified_at - id - owner_name - iban - bank_code - currency title: FundingAccount type: object WithdrawalStatus: enum: - created - completed properties: {} title: WithdrawalStatus type: string InvalidParam: properties: code: description: A machine-readable error code. title: Code type: string detail: description: Human-readable detail for error. title: Detail type: string path: description: Path to the field name (or index if a list) that errored. items: anyOf: - type: integer - type: string title: Path type: array required: - path - detail - code title: InvalidParam type: object securitySchemes: HTTPBearer: scheme: bearer type: http ````