--- title: "Get reports using SFTP" description: "Learn how to get Adyen reports using SSH File Transfer Protocol (SFTP)." url: "https://docs.adyen.com/reporting/automatically-get-reports/get-reports-using-sftp" source_url: "https://docs.adyen.com/reporting/automatically-get-reports/get-reports-using-sftp.md" canonical: "https://docs.adyen.com/reporting/automatically-get-reports/get-reports-using-sftp" last_modified: "2023-06-09T11:54:00+02:00" language: "en" --- # Get reports using SFTP Learn how to get Adyen reports using SSH File Transfer Protocol (SFTP). [View source](/reporting/automatically-get-reports/get-reports-using-sftp.md) You can connect to our SSH File Transfer Protocol (SFTP) servers to get reports. When SFTP is set up for your account, you can access your SFTP [directory](#directory-structure) to retrieve reports, or submit batch data. Keep in mind that an SFTP connection requires a higher degree of technical knowledge and further development resources. You can [download reports automatically](/reporting/automatically-get-reports#download-reports) without using SFTP. ## Requirements Before you begin, take into account the following requirements, limitations, and preparations. | Requirement | Description | | ---------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Integration type** | All Adyen integrations. | | **[Customer Area roles](/account/user-roles)** | Make sure that you have the following role(s)- **Merchant admin** - **Merchant report** | | **Limitations** | The SFTP server gives you access to all the reports generated for your company. You cannot restrict access to reports from specific merchant accounts or sub-merchant accounts. | | **Setup steps** | Before you begin:- Refer to our [Reporting documentation](/reporting) to learn about reports in Adyen. - [Contact our Support team to get your SFTP access](#set-up-your-sftp-server-access). | ## Set up your SFTP server access Contact our [Support Team](https://ca-test.adyen.com/ca/ca/contactUs/support.shtml?form=other) with a request to create a SFTP directory where you can access your reports. Include the following information in your request: * **Your Customer Area [company account](/account/account-structure#company-account)**. * **Your source IP addresses**: The IP addresses of the servers from which you want to access the SFTP server. Make sure that these are **external** IP addresses, and that the allowlisted IP range is **static**. For available options, refer to the documentation of your provider: * [Azure NAT Gateway for Azure](https://learn.microsoft.com/en-us/azure/nat-gateway/nat-overview) * [Static IP address in GCP](https://cloud.google.com/compute/docs/ip-addresses/configure-static-external-ip-address) * [Elastic IP address in AWS](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/elastic-ip-addresses-eip.html) * **Your public SSH key**: The length of your SSH key must be 2048 bits or 4096 bits. You will receive a response from Support when your SFTP server is configured and ready for you to access from your source IP addresses. ## Connect to the SFTP server Use the details below to connect to the relevant SFTP server. If you have issues connecting to the SFTP server, check out the [troubleshooting steps](https://help.adyen.com/knowledge/ecommerce-integrations/integrations-basics/how-can-i-troubleshoot-sftp-connections). ### Test To connect to the test SFTP server, use: * **Host**: `sftp-test.adyen.com` * **Port**: `5892` * **User**: the user provided to you by Support. For example, `sftpreport_123456@Company.YOUR_COMPANY_ACCOUNT`. * **Allowlist IP**: `213.52.172.120` ### Live To connect to the live SFTP server from all regions except of [India](#india-live), use: * **Host**: `sftp-live.adyen.com` * **Port**: `5631` * **User**: the user provided to you by Support. For example, `sftpreport_123456@Company.YOUR_COMPANY_ACCOUNT`. * **Allowlist IP**: `82.199.87.148` ### India live If you process live payments in India, you need to connect to the India-specific SFTP to comply with data localization requirements. To connect to the India live SFTP server, use: * **Host**: `sftp-live-in.adyen.com` * **Port**: `5631` * **User**: the user provided to you by Support. For example, `sftpreport_123456@Company.YOUR_COMPANY_ACCOUNT`. * **Allowlist IP**: `147.12.20.251` ## Directory structure Your SFTP directory is configured for your company account. Adyen will create a subdirectory for each of your merchant accounts and sub-merchant accounts, after they have generated their first report. Reports for [company accounts](/account/account-structure#company-account) are located in the root directory. Reports for [merchant accounts](/account/account-structure#merchant-accounts) and sub-merchant accounts are located in directories corresponding to their names. The SFTP directory only contains reports that were generated after you set it up. To include reports that were generated before you set up your SFTP connection, [regenerate them in your Customer Area](/reporting/manually-get-reports/). The reports in your SFTP directory are also visible in your Customer Area, unless you have write access and delete them from your SFTP directory. The following table shows the directory structure: | Directory | Structure | | -------------------------------------------------------------------------- | --------------------------------------------------------------- | | [Company account](/account/account-structure#company-account) directory | `/REPORT_NAME.csv.gz` | | [Merchant account](/account/account-structure#merchant-accounts) directory | `/YOUR_MERCHANT_ACCOUNT/REPORT_NAME.csv.gz` | | Sub-merchant account directory | `/YOUR_MERCHANT_NAME/YOUR_SUB_MERCHANT_NAME/REPORT_NAME.csv.gz` | ## See also * [Manually get reports](/reporting/manually-get-reports) * [Time zone setting](/reporting/time-zone-setting) * [Platform reports](/reporting/platform-reports/)