> ## Documentation Index > Fetch the complete documentation index at: https://docs.nxos.io/llms.txt > Use this file to discover all available pages before exploring further. # Download a SWIFT copy > Download the bank's SWIFT copy of a completed SWIFT payout: the PDF of the SWIFT message (pacs.008) that sent the payment, as the bank issued it. Available once the payout is `COMPLETED` and its `swiftUetr` is set. The file is fetched from the bank on each call, and the bank serves each file a limited number of times: download it once and keep it. On `swift_copy_not_ready`, retry no more than every few minutes. Supports `Nxos-On-Behalf-Of` on the same terms as retrieving a transaction. ## OpenAPI ````yaml GET /v1/transactions/{transactionId}/swift-copy openapi: 3.0.0 info: title: nxos API version: 1.0.0 contact: name: nxos url: https://nxos.io description: |- The nxos platform API provides programmatic access to accounts, balances, quotes, and trades. All endpoints require API key authentication. servers: - url: https://api.nxos.io description: Production variables: {} - url: https://api.sandbox.nxos.io description: Sandbox variables: {} security: [] tags: - name: Accounts - name: Quotes - name: Beneficiaries - name: Fiat Payouts - name: Crypto Payouts - name: Sandbox Faucet - name: Nxosnet - name: Fees - name: Sub-Org Tiers - name: Assets - name: Funding Methods - name: Transactions - name: Organizations - name: Authorizations - name: Referral invites - name: Referral links - name: Reports - name: Webhooks description: >- Register an HTTPS endpoint to receive events (organization verification, transaction status changes, and finished reports) instead of polling. Deliveries are signed; verify the `svix-signature` header before acting on an event. See the [Webhooks guide](https://docs.nxos.io/core-concepts/webhooks) for the delivery format, signature verification, retries, and broker behavior. Payload shapes are documented in the `…Event` models below. paths: /v1/transactions/{transactionId}/swift-copy: get: tags: - Transactions description: >- Download the bank's SWIFT copy of a completed SWIFT payout: the PDF of the SWIFT message (pacs.008) that sent the payment, as the bank issued it. Available once the payout is `COMPLETED` and its `swiftUetr` is set. The file is fetched from the bank on each call, and the bank serves each file a limited number of times: download it once and keep it. On `swift_copy_not_ready`, retry no more than every few minutes. Supports `Nxos-On-Behalf-Of` on the same terms as retrieving a transaction. operationId: Transactions_getSwiftCopy parameters: - $ref: '#/components/parameters/ApiKeyAuth' - name: transactionId in: path required: true description: Transaction identifier of the payout. schema: type: string responses: '200': description: The request has succeeded. headers: Content-Disposition: required: true description: '`attachment`, with the bank''s file name.' schema: type: string content: application/pdf: schema: type: string format: binary '401': description: Access is unauthorized. content: application/json: schema: $ref: '#/components/schemas/Error401' '403': description: Access is forbidden. content: application/json: schema: $ref: '#/components/schemas/Error403' examples: verification_required: summary: verification_required value: error: code: verification_required message: Complete identity verification before using the API. requestId: req_a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4 acting_org_not_found: summary: acting_org_not_found value: error: code: acting_org_not_found message: >- Nxos-On-Behalf-Of points to an organization that does not exist. requestId: req_a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4 authorization_required: summary: authorization_required value: error: code: authorization_required message: No authorization for the requested organization. requestId: req_a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4 '404': description: The server cannot find the requested resource. content: application/json: schema: $ref: '#/components/schemas/Error404' examples: transaction_not_found: summary: transaction_not_found value: error: code: transaction_not_found message: Transaction not found. requestId: req_a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4 swift_copy_not_found: summary: swift_copy_not_found value: error: code: swift_copy_not_found message: >- No SWIFT copy for this transaction: it is not a completed SWIFT payout on one of your accounts. requestId: req_a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4 '409': description: The request conflicts with the current state of the server. content: application/json: schema: $ref: '#/components/schemas/Error409' examples: swift_copy_not_ready: summary: swift_copy_not_ready value: error: code: swift_copy_not_ready message: >- The bank has not produced the SWIFT copy yet. Try again in a few minutes. requestId: req_a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4 '429': description: Client error content: application/json: schema: $ref: '#/components/schemas/Error429' '500': description: Server error content: application/json: schema: $ref: '#/components/schemas/Error500' '502': description: Server error content: application/json: schema: $ref: '#/components/schemas/Error502' examples: bank_unavailable: summary: bank_unavailable value: error: code: bank_unavailable message: >- The SWIFT copy could not be fetched from the bank right now. Try again in a few minutes. requestId: req_a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4 components: parameters: ApiKeyAuth: name: Authorization in: header required: true description: 'Bearer token. Format: `Bearer `' schema: type: string schemas: Error401: type: object required: - error properties: error: $ref: '#/components/schemas/ErrorBody' description: Standard error response returned by all endpoints on failure. example: error: code: missing_api_key message: 'Missing or invalid Authorization header. Expected: Bearer ' requestId: req_a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4 Error403: type: object required: - error properties: error: $ref: '#/components/schemas/ErrorBody' description: Standard error response returned by all endpoints on failure. Error404: type: object required: - error properties: error: $ref: '#/components/schemas/ErrorBody' description: Standard error response returned by all endpoints on failure. Error409: type: object required: - error properties: error: $ref: '#/components/schemas/ErrorBody' description: Standard error response returned by all endpoints on failure. Error429: type: object required: - error properties: error: $ref: '#/components/schemas/ErrorBody' description: Standard error response returned by all endpoints on failure. example: error: code: rate_limited message: 'Rate limit exceeded: 1000 requests per minute. Retry in 23 seconds.' requestId: req_a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4 Error500: type: object required: - error properties: error: $ref: '#/components/schemas/ErrorBody' description: Standard error response returned by all endpoints on failure. example: error: code: internal_error message: An unexpected error occurred. requestId: req_a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4 Error502: type: object required: - error properties: error: $ref: '#/components/schemas/ErrorBody' description: Standard error response returned by all endpoints on failure. ErrorBody: type: object required: - code - message - requestId properties: code: allOf: - $ref: '#/components/schemas/ErrorCode' description: Machine-readable error code. message: type: string description: Human-readable error message. requestId: type: string description: Unique identifier for this request, useful for debugging. ErrorCode: type: string enum: - missing_api_key - authentication_failed - invalid_api_key - forbidden - acting_org_not_found - authorization_required - swap_direction_not_allowed - sub_org_tier_not_available - service_not_enabled - not_found - organization_not_found - account_not_found - quote_not_found - beneficiary_not_found - transaction_not_found - funding_method_not_found - authorization_not_found - nxosnet_handle_not_found - sub_org_tier_not_found - report_not_found - quote_expired - quote_already_used - beneficiary_already_archived - beneficiary_not_archived - beneficiary_blocked - transaction_blocked - transaction_not_held - fee_schedule_drifted - nxosnet_not_enabled - nxosnet_handle_taken - chain_send_failed - swift_copy_not_found - swift_copy_not_ready - bank_unavailable - idempotency_key_in_use - idempotency_request_in_flight - referral_invite_already_accepted - report_not_ready - too_many_pending_reports - invalid_request - insufficient_funds - trade_size_out_of_bounds - validation_error - invalid_document - too_many_documents - document_too_large - document_not_found - document_not_uploaded - share_token_invalid - verification_import_unsupported - verification_required - rate_limited - webhooks_unavailable - internal_error description: All possible error codes returned by the API. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.