Wires API Reference

👍

Availability

These endpoints provide limited functionality. Check with Galileo to verify whether it is supported by your sponsor bank.

Use the following endpoints to create and manage wire transfers:

See Creating a Wire Transfer for step-by-step guidance.

Create Wire Transaction

(POST /createWireTransaction)

Use the Create Wire Transaction endpoint to initiate a wire transfer to a remote bank account. Prior to using this endpoint, you must create an account to receive the wire using Create Destination Account.

After successfully calling this endpoint, there is a 10-minute window during which you can cancel the wire using Cancel Wire Transaction.

Request fields

FieldTypeRequiredDescription
apiLoginstringxWeb service username, as provided by Galileo.
Pattern: Max 50 characters
Example: "AbC123-9999"
apiTransKeystringxWeb service password, as provided by Galileo.
Pattern: Max 15 characters
Example: "4sb62fh6w4h7w34g"
providerIdintegerxGalileo-issued provider identifier.
Pattern: Max 10 digits
Example: 9999
transactionIdstringxA unique provider-generated ID to identify this API call. A UUID is preferred.
Pattern: 60 characters or less
Example: "9845dk-39fdk3fj3-4483483478"
accountNostringxThe PAN or PRN of the account.
Pattern: PRN or PAN
Example: "074103447228"
amountnumberxCurrency amount as a whole or decimal amount.
Pattern: Positive integer or decimal number
Example: 100.00, 100, or 100.73
destinationAccountIdstringxThe destination_account_id as returned by Create Destination Account or Get Destination Accounts.
Pattern: UUID
Example: "629d890a-d773-4615-9bc4-bbe12effcf94"
referencestringDescription for the wire transaction.
Pattern: Max 140 alphanumeric, punctuation
Example: "PMT FOR EQUIPMENT"

Response fields

FieldTypeRequiredDescription
status_codeintegerxThe response status code. May return a string for some statuses.
statusstringxThe condition of a process or response
processing_timenumberxThe time elapsed in processing the transaction
echoobjectxA structure that contains transaction ID information. Contains the following objects:
  • object
    • transaction_id | string | null | required | An ID that represents an API transaction
    • provider_timestamp | date-time | null | required | Store a related timestamp for reporting and troubleshooting purposes
    • provider_transaction_id | string | null | required | Secondary transaction identifier (generated by a provider)
    • object | null
system_timestampdate-timexA system generated timestamp
rtokenstringxA Galileo-generated ID used for tracking
errorsarray of stringsA list of errors generated while the request was processed
response_dataobjectxA structure for the response data. In case of error it will be empty. Contains the following:
  • object
    • balance | number | required | Balance of the account after the transaction.
    • wire_transaction_id | string | required | UUID to identify the transaction.
    • expected_transfer_date | string | required | Date that the recipient should receive the transfer. Should be the same day the wire is sent, unless the bank sends the transaction after the Fedwire cutoff time, in which case the date is the next business day.
    • adjustment_id | integer | required | Galileo generated adjustment ID
  • object| null
  • Example request

    {
      "apiLogin": "AbC123-9999",
      "apiTransKey": "4sb62fh6w4h7w34g",
      "providerId": 9999,
      "transactionId": "123e4567-e89b-12d3-a456-426614174000",
      "accountNo": "074103447228",
      "amount": 100.73,
      "destinationAccountId": "629d890a-d773-4615-9bc4-bbe12effcf94",
      "reference": "PMT FOR EQUIPMENT"
    }
    

    Example response

    {
      "status_code": 0,
      "status": "Success",
      "processing_time": 0.298,
      "transaction_id": "UUID",
      "response_data": {
        "adjustment_id": 5000721233,
        "wire_transaction_id": "123456-1234-1234-123456",
        "balance": "123.34",
        "expected_transfer_date": "2023-11-03"
      },
      "echo": {
        "provider_transaction_id": "",
        "provider_timestamp": null,
        "transaction_id": "629d890a-d773-4615-9bc4-bbe12effcf94"
      },
      "rtoken": "8cc16de0-5eda-4e2a-968e-3b08fce6f778",
        "system_timestamp": "2025-08-13 10:36:54"
    }
    

    Status codes

    See Global Response Statuses for status codes that are common across endpoints.


    Cancel Wire Transaction

    (POST /cancelWireTransaction)

    Use the Cancel Wire Transaction endpoint to cancel a wire transaction that was initiated by the Create Wire Transaction endpoint. The wire transaction can be canceled within 10 minutes of being created with that endpoint. If the wire cannot be canceled, this endpoint returns status_code: 27 Request cannot be completed, which means that the transaction is being processed and cannot be canceled.

    Request fields

    FieldTypeRequiredDescription
    apiLoginstringxWeb service username, as provided by Galileo.
    Pattern: Max 50 characters
    Example: "AbC123-9999"
    apiTransKeystringxWeb service password, as provided by Galileo.
    Pattern: Max 15 characters
    Example: "4sb62fh6w4h7w34g"
    providerIdintegerxGalileo-issued provider identifier.
    Pattern: Max 10 digits
    Example: 9999
    transactionIdstringxA unique provider-generated ID to identify this API call. A UUID is preferred.
    Pattern: 60 characters or less
    Example: "9845dk-39fdk3fj3-4483483478"
    accountNostringxThe PAN or PRN of the account.
    Pattern: PRN or PAN
    Example: "074103447228"
    wireTransactionIdstringwire_transaction_id as returned by Create Wire Transaction or Get Wire History.
    Pattern: UUID
    Example: "dcf0ef1d-6387-42f8-88cc-292f1c90cd67"

    Response fields

    FieldTypeRequiredDescription
    status_codeintegerxThe response status code. May return a string for some statuses.
    statusstringxThe condition of a process or response
    processing_timenumberxThe time elapsed in processing the transaction
    echoobjectxA structure that contains transaction ID information. Contains the following objects:
  • object
    • transaction_id | string | null | required | An ID that represents an API transaction
    • provider_timestamp | date-time | null | required | Store a related timestamp for reporting and troubleshooting purposes
    • provider_transaction_id | string | null | required | Secondary transaction identifier (generated by a provider)
  • object | null
  • system_timestampdate-timexA system generated timestamp
    rtokenstringxA Galileo-generated ID used for tracking
    errorsarray of stringsA list of errors generated while the request was processed
    response_dataobjectxA structure for the response data. In case of error it will be empty. Contains the following required fields:
    • object
    • balance | number | required | Balance of the account after canceling the transaction
    • wire_transaction_id | string | required | UUID of the canceled transaction
  • object| null
  • Example request

    {
      "apiLogin": "AbC123-9999",
      "apiTransKey": "4sb62fh6w4h7w34g",
      "providerId": 9999,
      "transactionId": "123e4567-e89b-12d3-a456-426614174000",
      "accountNo": "074103447228",
      "wireTransactionId": "dcf0ef1d-6387-42f8-88cc-292f1c90cd67"
    }
    

    Example response

    {
      "status_code": 0,
      "status": "Success",
      "processing_time": 0.298,
      "transaction_id": "7b893612-9651-5c50-b6c6-c8095c3a8ac5",
      "response_data": {
        "wire_transaction_id": "12345678-1234-1234-123456789abc",
        "balance": "123.34"
      },
      "echo": {
        "provider_transaction_id": "",
        "provider_timestamp": null,
        "transaction_id": "629d890a-d773-4615-9bc4-bbe12effcf94"
      },
      "rtoken": "8cc16de0-5eda-4e2a-968e-3b08fce6f778",
      "system_timestamp": "2025-08-13 10:36:54"
    }
    

    Status codes

    See Global Response Statuses for status codes that are common across endpoints.


    Get Wire Details

    (POST /getWireDetails)

    Use the Get Wire Details endpoint to retrieve information about a specific wire transaction that was initiated by Create Wire Transaction or retrieved by Get Wire History.

    Request fields

    FieldTypeRequiredDescription
    apiLoginstringxWeb service username, as provided by Galileo.
    Pattern: Max 50 characters
    Example: "AbC123-9999"
    apiTransKeystringxWeb service password, as provided by Galileo.
    Pattern: Max 15 characters
    Example: "4sb62fh6w4h7w34g"
    providerIdintegerxGalileo-issued provider identifier.
    Pattern: Max 10 digits
    Example: 9999
    transactionIdstringxA unique provider-generated ID to identify this API call. A UUID is preferred.
    Pattern: 60 characters or less
    Example: "9845dk-39fdk3fj3-4483483478"
    accountNostringxThe PAN or PRN of the account.
    Pattern: PRN or PAN
    Example: "074103447228"
    wireTransactionIdstringwire_transaction_id as returned by Create Wire Transaction or - Get Wire History.
    Pattern: UUID
    Example: "dcf0ef1d-6387-42f8-88cc-292f1c90cd67

    Response fields

    FieldTypeRequiredDescription
    status_codeintegerxThe response status code. May return a string for some statuses.
    statusstringxThe condition of a process or response
    processing_timenumberxThe time elapsed in processing the transaction
    echoobjectxA structure that contains transaction ID information. Contains the following objects:
  • object
    • transaction_id | string | null | required | An ID that represents an API transaction
    • provider_timestamp | date-time | null | required | Store a related timestamp for reporting and troubleshooting purposes
    • provider_transaction_id | string | null | required | Secondary transaction identifier (generated by a provider)
  • object | null
  • system_timestampdate-timexA system generated timestamp
    rtokenstringxA Galileo-generated ID used for tracking
    errorsarray of stringsA list of errors generated while the request was processed
    response_dataobjectxA structure for the response data. In case of error it will be empty. Contains the following required fields:
  • object
    • wire_transaction_id | string | required | UUID of the canceled transaction
    • status | string | Status of the transaction. See the Transaction statuses table for valid values.
    • reason | string | The cause of the status
    • amount | number | required | Amount of the transaction
    • receive_date | string | required | Date the transaction was received by file or API
    • direction | string | required | Direction of transaction (in/out)
    • description | string | required | Description of transaction
    • deb_cred_ind | string | required | Whether the transaction was a credit or debit
    • imad | string | Incoming only. Input message accountability data, a 22-character universally unique identifier that Fedwire assigns to each wire transfer. The first eight characters are the date of the transfer: YYYYMMDD.
    • payment_id | string | Incoming only. ID of the payment in the payments table
    • sender | object | Incoming only. Information about who sent the transaction. Contains the following:
      • account | string | Account number of the sender (incoming) or receiver (outgoing).
      • address | string | Address of the sender (incoming) or receiver (outgoing).
      • bank | string | Name of the ODFI (incoming) or RDFI (outgoing)
      • country | string | Country of the ODFI (incoming) or RDFI (outgoing)
      • name | string | Name of the wire sender (incoming) or receiver (outgoing)
      • bank_id | string | ID of the sender's bank.
    • adjustment_id | string | Outgoing only. ID of the adjustment in the adjustments table
    • receiver | object | Incoming only. Information about who received the transaction. Contains the following:
      • account | string | Account number of the sender (incoming) or receiver (outgoing).
      • address | string | Address of the sender (incoming) or receiver (outgoing).
      • bank | string | Name of the ODFI (incoming) or RDFI (outgoing)
      • country | string | Country of the ODFI (incoming) or RDFI (outgoing)
      • name | string | Name of the wire sender (incoming) or receiver (outgoing)
  • object | null
  • Example request

    {
      "apiLogin": "AbC123-9999",
      "apiTransKey": "4sb62fh6w4h7w34g",
      "providerId": 9999,
      "transactionId": "123e4567-e89b-12d3-a456-426614174000",
      "accountNo": "074103447228",
      "wireTransactionId": "dcf0ef1d-6387-42f8-88cc-292f1c90cd67"
    }
    

    Example response

    {
      "status_code": 0,
      "status": "Success",
      "processing_time": 1.374,
      "response_data": {
        "amount": 20,
        "deb_cred_ind": "credit",
        "description": "Outgoing wire",
        "direction": "out",
        "reason": "post_transaction call",
        "receive_date": "2025-08-23 08:46:43",
        "receiver": {
          "account": "99987654321",
          "address": "555 Green St. Verdantville NY 10034",
          "country": "US",
          "bank": "Wells Fargo",
          "name": "Bailey Building & Loan"
        },
        "status": "POSTED",
        "wire_transaction_id": "3345df62-3f19-4c21-8b54-f12a3f4f6d3a"
      },
      "echo": {
        "provider_transaction_id": "",
        "provider_timestamp": null,
        "transaction_id": "4b431dcb-a366-4986-9a90-9516b031e79d"
      },
      "system_timestamp": "2025-08-23 08:49:11",
      "rtoken": "ac230dd3-09b6-4ddb-8e1b-1d17a2aa3dd0"
    }
    

    Status codes

    See Global Response Statuses for status codes that are common across endpoints.

    Transaction statuses

    These are the valid values for status in the endpoint response.

    StatusDefinition
    RECEIVEDThe incoming transaction is awaiting processing.
    POSTEDThe transaction has been successfully posted to the account, either deposited or debited.
    PENDING_RETURNThe transaction will be returned to the sending bank; see reason for details.
    RETURNEDThe transaction was returned to the partner bank.
    FAILEDThe transaction was not processed.
    CANCELEDThe transaction was canceled.
    SENTThe transaction has been sent to the partner bank.

    Get Wire History

    (POST /getWireHistory)

    Use the Get Wire History endpoint to retrieve a list of wire transfers related to the specified account. If you do not populate startDate and endDate, the endpoint returns wires from the last 30 days.

    See Record-Set Pagination for instructions on using the paging parameters.

    Request fields

    FieldTypeRequiredDescription
    apiLoginstringxWeb service username, as provided by Galileo.
    Pattern: Max 50 characters
    Example: "AbC123-9999"
    apiTransKeystringxWeb service password, as provided by Galileo.
    Pattern: Max 15 characters
    Example: "4sb62fh6w4h7w34g"
    providerIdintegerxGalileo-issued provider identifier.
    Pattern: Max 10 digits
    Example: 9999
    transactionIdstringxA unique provider-generated ID to identify this API call. A UUID is preferred.
    Pattern: 60 characters or less
    Example: "9845dk-39fdk3fj3-4483483478"
    accountNostringxThe PAN or PRN of the account.
    Pattern: PRN or PAN
    Example: "074103447228"
    startDatestringThe beginning date for the date range, either a date or a date-time. Default: 31 days prior to today's date.
    Pattern: YYYY-MM-DD or YYYY-MM-DD hh:mm:ss
    Example: "2025-07-12" or "2025-07-12 16:20:00"
    endDatestringThe end date for the date range, either a date or a date-time. Must be equal to or later than startDate. Max 1098 days (~3 years) after startDate. Default: End of today.
    Pattern: YYYY-MM-DD or YYYY-MM-DD hh:mm:ss
    Example: "2025-07-12" or "2025-07-12 16:20:00"
    directionstringWhich direction to return: in, out or both
    Pattern: in, out, both
    Example: "in"
    maxTransactionsintegerMaximum number of transactions per page to return. Default: 100
    Pattern: Integer, max 200
    Example: 50
    nextPageTokenstringPass the next_page_token from the previous response to return the next page.
    Pattern: Token string

    Response fields

    FieldTypeRequiredDescription
    status_codeintegerxThe response status code. May return a string for some statuses.
    statusstringxThe condition of a process or response
    processing_timenumberxThe time elapsed in processing the transaction
    echoobjectxA structure that contains transaction ID information. Contains the following objects:
  • object
    • transaction_id | string | null | required | An ID that represents an API transaction
    • provider_timestamp | date-time | null | required | Store a related timestamp for reporting and troubleshooting purposes
    • provider_transaction_id | string | null | required | Secondary transaction identifier (generated by a provider)
  • object | null
  • system_timestampdate-timexA system generated timestamp
    rtokenstringxA Galileo-generated ID used for tracking
    errorsarray of stringsA list of errors generated while the request was processed
    response_dataobjectxA structure for the response data. In case of error it will be empty. Contains the following required fields:
    • object
    • max_transactions | integer | required | The maximum number of transactions per page to return. Echo of request parameter maxTransactions, if provided.
    • num_transactions |
      integer | required | The number of transactions in the transactions list.
    • start_date | string | required | Start date of the transaction history. Echo of startDate, if provided
    • end_date | string | required | End date of the transaction history. Echo of endDate, if provided.
    • transactions | array of objects | required | List of the wire transactions, ordered most recent first. Contains the following:
      • amount | number | required | Amount of the transaction
      • wire_transaction_id | string | required | UUID of the canceled transaction
      • receive_date | string | required | Date the transaction was received by file or API
      • direction | string | required | Direction of transaction (in/out)
      • status | string | Status of the transaction.
      • description | string | required | Description of transaction
      • sender | object | Incoming only. Information about who sent the transaction. Contains the following:
        • account | string | Account number of the sender (incoming) or receiver (outgoing).
        • address | string | Address of the sender (incoming) or receiver (outgoing).
        • bank | string | Name of the ODFI (incoming) or RDFI (outgoing)
        • country | string | Country of the ODFI (incoming) or RDFI (outgoing)
        • name | string | Name of the wire sender (incoming) or receiver (outgoing)
        • bank_id | string | ID of the sender's bank.
      • receiver | object | Incoming only. Information about who received the transaction. Contains the following:
        • account | string | Account number of the sender (incoming) or receiver (outgoing).
        • address | string | Address of the sender (incoming) or receiver (outgoing).
        • bank | string | Name of the ODFI (incoming) or RDFI (outgoing)
        • country | string | Country of the ODFI (incoming) or RDFI (outgoing)
        • name | string | Name of the wire sender (incoming) or receiver (outgoing)
    • next_page_token | string | Token to use to retrieve the next page. When this field is missing, there are no more pages to return.
  • object| null
  • Example request

    {
      "apiLogin": "AbC123-9999",
      "apiTransKey": "4sb62fh6w4h7w34g",
      "providerId": 9999,
      "transactionId": "123e4567-e89b-12d3-a456-426614174000",
      "accountNo": "074103447228",
      "startDate": "2025-07-12 16:20:00",
      "endDate": "2025-08-02",
      "direction": "in",
      "maxTransactions": 50,
      "nextPageToken": "NO34BNT04TV234N6V274692376G32NNFNNF7988247923865017061N"
    }
    

    Example response

    {
      "status_code": 0,
      "status": "Success",
      "processing_time": 0.614,
      "response_data": {
        "end_date": "2025-08-31 23:59:59",
        "max_transactions": 2,
        "next_page_token": "2cXvCmdsR0rJNkYZdJviXcivRBCrUz74foJ9ZU329C8EpG4howC2bv5wqjJRMvzryaFKtwUTbjcm+0cmCyeRqgd//5zyOlzxIcEaEMg7FpTC84HK2TJop7TQChVDE1Iujem5VuxlMsSLCbZe2Qw7kItP6UtSkC+1oOWraQLyDr3/WvEEsik4cE/7/d9MFqQlMp8Z0m6OREA=",
        "num_transactions": 2,
        "start_date": "2025-08-11 00:00:00",
        "transactions": [
          {
            "amount": "20",
            "description": "Outgoing wire",
            "direction": "out",
            "receive_date": "2025-08-23 08:46:43",
            "receiver": {
              "account": "99987654321",
              "address": "555 Green St. Verdantville NY 10034",
              "country": "US",
              "bank": "Wells Fargo",
              "name": "Bailey Building & Loan"
            },
            "status": "POSTED",
            "wire_transaction_id": "3345df62-3f19-4c21-8b54-f12a3f4f6d3a"
          },
          {
            "amount": "20",
            "description": "Outgoing wire",
            "direction": "out",
            "receive_date": "2025-08-23 08:45:21",
            "receiver": {
              "account": "99987654321",
              "address": "555 Green St. Verdantville NY 10034",
              "country": "US",
              "bank": "Wells Fargo",
              "name": "Bailey Building & Loan"
            },
            "status": "POSTED",
            "wire_transaction_id": "de359400-e5bb-4d03-9ec4-52b4ccf1a7ee"
          }
        ]
      },
      "echo": {
        "provider_transaction_id": "",
        "provider_timestamp": null,
        "transaction_id": "0a8a34ab-96e8-47d3-bb31-546dc14b7d6a"
      },
      "system_timestamp": "2025-08-23 08:58:09",
      "rtoken": "88e4493d-3d22-4795-9993-a9ee613a74e9"
    }
    

    Status codes

    See Global Response Statuses for status codes that are common across endpoints.


    © Galileo Financial Technologies, LLC 2025    Privacy Disclosure

    All documentation, including but not limited to text, graphics, images, and any other content, are the exclusive property of Galileo Financial Technologies, LLC and are protected by copyright laws. These materials may not be reproduced, distributed, transmitted, displayed, or otherwise used without the prior written permission of Galileo Financial Technologies, LLC. Any unauthorized use or reproduction of these materials are expressly prohibited.