Get CSV Transfer File Example

This endpoint returns a CSV template file that partners can use as a reference when preparing batch transfer uploads. The response includes the file name, its base64-encoded or plain-text content, and the MIME content type. Use this template to ensure your transfer files are formatted correctly before submission.

Endpoint

GET /Files/transfer/file

Authentication

Bearer token required. Obtain via:

POST https://api.banking.netevia.dev/api/auth/v2

Include in header: Authorization: Bearer {token}
Token lifetime: 10 minutes. Refresh via POST /api/auth/refresh.

When to use

Use this endpoint when onboarding a new integration that requires batch transfer processing, or whenever you need to verify the expected CSV column structure and format. It is particularly useful during development and QA to validate that your file generation logic matches the platform's requirements before submitting actual transfer files.

Query Parameters

Response

200 OK

{
  "name": "transfer_template.csv",
  "content": "transferType,amount,currency,sourceAccountId,destinationAccountId,memo\nACH,100.00,USD,XXXXXXXXXX,XXXXXXXXXX,Payroll\nINTERNAL,250.00,USD,XXXXXXXXXX,XXXXXXXXXX,Reimbursement",
  "contentType": "text/csv"
}

Error Codes

Common Mistakes

• Ignoring the contentType field — always check it before parsing the content value, as the encoding may vary.
• Submitting a transfer file with columns in the wrong order or with missing required headers; use this template as the authoritative reference.
• Forgetting to refresh the Bearer token before calling this endpoint — tokens expire after 10 minutes.

Related Endpoints

• POST /Files/transfer — Submit a completed CSV transfer file for batch processing
• GET /Files/transfer — List previously submitted transfer files and their statuses

Example

curl -X GET "https://api.banking.netevia.dev/Files/transfer/file" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Accept: application/json"