--- updatedAt: 2026-06-02T20:06:00.000Z agentTools: projectIndex: https://docs.zerohash.com/llms.txt --- # Get fiat account Retrieves a specific fiat withdrawal account that has been whitelisted. # OpenAPI definition ```json { "openapi": "3.1.0", "info": { "title": "zerohash API", "description": "\n### Authentication\n\nzerohash Uses HMAC SHA-256 verification to ensure the authenticity of API requests, follow instructions by link [https://docs.zerohash.com/reference/api-authentication](https://docs.zerohash.com/reference/api-authentication)\n\nDownload zerohash OpenAPI Schema as JSON\n", "version": "1.7.0" }, "servers": [ { "url": "https://api.cert.zerohash.com", "description": "Certification API server" } ], "x-readme": { "proxy-enabled": false }, "tags": [ { "name": "Withdrawals", "description": "Initiate and monitor withdrawals from accounts" } ], "paths": { "/withdrawals/fiat_accounts/{id}": { "get": { "tags": [ "Withdrawals" ], "summary": "Get fiat account", "description": "Retrieves a specific fiat withdrawal account that has been whitelisted.", "parameters": [ { "$ref": "#/components/parameters/Signature" }, { "$ref": "#/components/parameters/Timestamp" }, { "name": "id", "in": "path", "description": "Withdrawal account id", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successfully retrieved fiat withdrawal account. including account details and whitelist status.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GetWithdrawalFiatAccountById" } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Code400" } } } }, "403": { "description": "Forbidden", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Code403" } } } }, "404": { "description": "Not Found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Code404" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Code500" } } } }, "503": { "description": "Service Unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Code503" } } } } } } } }, "security": [ { "apiKey": [], "apiPassphrase": [] } ], "components": { "securitySchemes": { "apiKey": { "type": "apiKey", "description": "Your API public key. See the [Authentication guide](https://docs.zerohash.com/reference/api-authentication) for how to obtain keys.", "in": "header", "name": "X-SCX-API-KEY" }, "apiPassphrase": { "type": "apiKey", "description": "The passphrase associated with your API key, set when the key was created.", "in": "header", "name": "X-SCX-PASSPHRASE" } }, "parameters": { "Signature": { "name": "X-SCX-SIGNED", "in": "header", "description": "HMAC-SHA256 signature of the request, base64-encoded. See the [Authentication guide](https://docs.zerohash.com/reference/api-authentication) for the exact signing formula.", "required": true, "schema": { "type": "string" } }, "Timestamp": { "name": "X-SCX-TIMESTAMP", "in": "header", "description": "Current Unix timestamp in seconds. Must be within 60 seconds of server time or the request is rejected.", "required": true, "schema": { "type": "string", "example": "1678901234" } } }, "schemas": { "Code400": { "type": "object", "description": "Request was rejected by validation or a downstream service. `errors` is an array of human-readable messages; each entry describes a single validation failure or business-rule violation.", "required": [ "errors" ], "properties": { "errors": { "type": "array", "items": { "type": "string" }, "example": [ "body/amount must be >= 0", "body/asset is required" ] } } }, "Code403": { "type": "object", "description": "Authentication or authorization failed. `error` is always `true`; `message` explains which check failed (missing API key, bad signature, insufficient permission, etc.).", "required": [ "error", "message" ], "properties": { "error": { "type": "boolean", "example": true }, "message": { "type": "string", "example": "This api key does not have write permission to this endpoint" } } }, "Code404": { "type": "object", "description": "The requested resource does not exist or is not visible to the caller.", "required": [ "error" ], "properties": { "error": { "type": "string", "example": "Not Found" } } }, "Code500": { "type": "object", "description": "An unexpected error occurred on the server. The request can be retried after a short delay, but the same inputs may reproduce the error.", "required": [ "error" ], "properties": { "error": { "type": "string", "example": "Internal Server Error" } } }, "Code503": { "type": "object", "description": "A downstream dependency was unavailable, timed out, or returned a retryable error. Safe to retry; the response carries a `zh-allow-retry: true` header.", "required": [ "error" ], "properties": { "error": { "type": "string", "example": "Service Unavailable" } } }, "FiatAccountsEntity": { "type": "object", "description": "The whitelisted withdrawal account or address to withdraw funds to\n Note: only one of withdrawal_account_id, address or account{} can be submitted per withdrawal, but zerohash will always respond with withdrawal_account_id", "properties": { "withdrawal_account_id": { "type": "number", "description": "The ID of the withdrawal account", "example": 286 }, "name": { "type": "string", "description": "The nickname given to the withdrawal account\n Note: zerohash will append the last 4 digits of the account number to this when saving it", "example": "Primary (1234)" }, "status": { "type": "string", "description": "The approval status of the withdrawal account\t", "example": "PENDING_CREATION", "enum": [ "PENDING_CREATION", "APPROVED", "REJECTED", "DELETED", "PENDING_CHANGE" ] }, "limit": { "type": "number", "description": "The limit applied to the account on a per-withdrawal basis", "example": 750000 }, "type": { "type": "string", "description": "The type of account: REAL_TIME_FIAT for 24/7 USD withdrawals, DOMESTIC_FIAT for US wires or INTERNATIONAL_FIAT for international wires", "example": "DOMESTIC_FIAT" }, "beneficiary_name": { "type": "string", "description": "The owner of the account at the withdrawal destination", "example": "John Doe" }, "account_number": { "type": "string", "description": "The unique IBAN or account number for the final withdrawal destination", "example": "1231234" }, "bank_name": { "type": "string", "description": "The name of the destination financial institution", "example": "BMO Harris" }, "routing_number": { "type": "string", "description": "For US wires, the ABA routing number identifies the destination financial institution", "example": "07102343" }, "swift_code": { "type": "string", "description": "SWIFT code, if applicable" }, "recipient_instructions": { "type": "string", "description": "Any additional instructions on the account" }, "intermediary_bank_name": { "type": "string", "description": "Intermediary bank name, if applicable" }, "intermediary_bank_code_type": { "type": "string", "description": "Intermediary bank identifier code type, if applicable\n Options include SWIFT" }, "intermediary_bank_code": { "type": "string", "description": "Intermediary bank identifier that corresponds to intermediary_bank_code_type, if applicable" }, "intermediary_bank_account_number": { "type": "string", "description": "Intermediary bank IBAN or account number, if applicable" }, "correspondent_bank_name": { "type": "string", "description": "Correspondent bank name, if applicable" }, "correspondent_bank_code_type": { "type": "string", "description": "Correspondent bank identifier code type, if applicable\n Options include SWIFT" }, "correspondent_bank_code": { "type": "string", "description": "Correspondent bank identifier that corresponds to correspondent_bank_code_type, if applicable" }, "correspondent_bank_account_number": { "type": "string", "description": "Correspondent bank IBAN or account number, if applicable" }, "last_update": { "type": "number", "description": "Timestamp for when the withdrawal address last update", "example": "1571175076187" }, "participant_code": { "type": "string", "description": "The participant the request belongs to, e.g. ABCDEF", "example": "ABCDEF" } } }, "GetWithdrawalFiatAccountById": { "type": "object", "properties": { "message": { "$ref": "#/components/schemas/FiatAccountsEntity" } } } } } } ```