> ## Documentation Index > Fetch the complete documentation index at: https://docs.supermetrics.com/llms.txt > Use this file to discover all available pages before exploring further. # List transfers > Retrieve list of transfers for the authenticated team. **Returns:** Array of transfer objects with basic information. **Important Notes:** - Requires scope `dwh_transfers_read` - Your account must have `dwh.transfer.view` permission. See [roles and permissions](https://docs.supermetrics.com/docs/about-supermetrics-teams-and-user-roles#user-roles). - Returns only non-deleted transfers belonging to your team ## OpenAPI ````json GET /teams/{team_id}/transfers { "openapi": "3.0.3", "info": { "title": "Management API Reference", "version": "2.0.0", "description": "API Documentation for the Supermetrics Management API. For more information, visit https://supermetrics.com.", "termsOfService": "https://supermetrics.com/terms-of-service", "contact": { "name": "Supermetrics Suppot", "email": "support@supermetrics.com", "url": "https://supermetrics.com/support" }, "license": { "name": "Apache 2.0", "url": "https://www.apache.org/licenses/LICENSE-2.0.html" }, "x-api-id": "sm-management-api", "x-audience": "public" }, "servers": [ { "url": "https://api.supermetrics.com/v2", "description": "Global production public Supermetrics Management API base path.", "x-internal": "false" } ], "tags": [ { "name": "API Keys", "description": "Manage API keys to access Supermetrics API" }, { "name": "Data Source Logins", "description": "Access your data source authentications" }, { "name": "Data Source Login Links", "description": "Create single-use data source login links" }, { "name": "Saved Queries", "description": "Manage queries saved in Query Manager" }, { "name": "Table Groups", "description": "Manage your team's table groups" }, { "name": "Team Lists", "description": "Manage centralized team lists for your queries" }, { "name": "Team Settings", "description": "Configure general settings for your team" }, { "name": "Data Transfers", "description": "Create, configure, and manage Data Warehouse transfers" }, { "name": "Transfer Runs", "description": "Monitor execution history of Data Warehouse transfers" }, { "name": "Data Backfills", "description": "Manage historical data backfills for your Data Warehouse transfers" }, { "name": "Data Destinations", "description": "Create, configure, and manage Data Warehouse destinations" }, { "name": "Data Source Connections", "description": "Create and manage data source connections for Data Warehouse transfers" }, { "name": "Data Blending", "description": "Create and manage Data Blending" }, { "name": "Custom Fields", "description": "Create and manage Custom Fields" } ], "externalDocs": { "description": "Find out more about Supermetrics Management API", "url": "https://docs.supermetrics.com/apidocs/management-api" }, "paths": { "/teams/{team_id}/transfers": { "servers": [ { "url": "https://dts-api.supermetrics.com/v1", "description": "Data Transfers API" } ], "get": { "summary": "List transfers", "description": "Retrieve list of transfers for the authenticated team.\n\n**Returns:** Array of transfer objects with basic information.\n\n**Important Notes:**\n- Requires scope `dwh_transfers_read`\n- Your account must have `dwh.transfer.view` permission. See [roles and permissions](https://docs.supermetrics.com/docs/about-supermetrics-teams-and-user-roles#user-roles).\n- Returns only non-deleted transfers belonging to your team\n", "operationId": "listTransfers", "tags": [ "Data Transfers" ], "security": [ { "BearerAuth": [] } ], "parameters": [ { "$ref": "#/components/parameters/DwhTeamIdPathParam" } ], "responses": { "200": { "description": "Transfers retrieved successfully", "headers": { "Access-Control-Allow-Origin": { "$ref": "#/components/headers/Access-Control-Allow-Origin" } }, "content": { "application/json": { "schema": { "type": "object", "required": [ "meta", "data" ], "properties": { "meta": { "$ref": "#/components/schemas/ResponseMeta" }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/TransferInfoResponse" } } } }, "example": { "meta": { "request_id": "019461A0-0000-7000-8000-000000000000" }, "data": [ { "dwh_transfer_id": "36091", "display_name": "AW enhanced 2022-11-17", "external_transfer_id": "ext-36091", "status": "active", "state": "active", "schedule": "daily", "run_date": "2026-01-01", "data_source": null, "destination": null, "accounts": [], "backfill": null } ] } } } }, "401": { "$ref": "#/components/responses/DwhUnauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "429": { "$ref": "#/components/responses/DwhTooManyRequests" }, "500": { "$ref": "#/components/responses/DwhInternalServerError" } } } } }, "components": { "parameters": { "DwhTeamIdPathParam": { "name": "team_id", "in": "path", "required": "true", "description": "Unique identifier of the team", "example": "12345", "schema": { "type": "integer", "format": "int64", "minimum": "1", "maximum": "9223372036854776000" } } }, "headers": { "Access-Control-Allow-Origin": { "description": "CORS header", "schema": { "type": "string", "maxLength": "255", "enum": [ "*" ], "example": "*" } } }, "schemas": { "ResponseMeta": { "type": "object", "properties": { "request_id": { "type": "string", "maxLength": "50", "pattern": "^[A-Za-z0-9_-]+$", "description": "API request ID" } } }, "TransferInfoResponse": { "type": "object", "description": "Transfer information for list endpoint", "properties": { "dwh_transfer_id": { "type": "integer", "format": "int32", "description": "The transfer ID", "example": "36091" }, "display_name": { "type": "string", "description": "Display name of the transfer", "example": "AW enhanced 2022-11-17" }, "external_transfer_id": { "type": "string", "description": "External identifier for the transfer", "example": "ext-36091" }, "status": { "type": "string", "description": "Transfer status", "example": "active" }, "state": { "type": "string", "description": "Transfer state (active or paused)", "example": "active" }, "schedule": { "type": "string", "description": "Schedule description", "example": "daily" }, "run_date": { "type": "string", "description": "Last run date", "example": "2026-01-01" }, "data_source": { "type": "object", "nullable": "true", "description": "Data source information" }, "destination": { "type": "object", "nullable": "true", "description": "Destination information" }, "accounts": { "type": "array", "items": { "type": "string" }, "description": "Account identifiers" }, "backfill": { "type": "object", "nullable": "true", "description": "Backfill statistics" } } }, "ErrorResponse": { "type": "object", "properties": { "meta": { "$ref": "#/components/schemas/ResponseMeta" }, "error": { "$ref": "#/components/schemas/Error" } } }, "Error": { "type": "object", "properties": { "code": { "type": "string", "maxLength": "100", "description": "Error code" }, "message": { "type": "string", "maxLength": "255", "description": "Error message" }, "description": { "type": "string", "maxLength": "255", "description": "Error description" } } } }, "responses": { "DwhUnauthorized": { "description": "Unauthorized - Authentication is required and has failed or has not been provided.", "headers": { "Access-Control-Allow-Origin": { "$ref": "#/components/headers/Access-Control-Allow-Origin" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" }, "example": { "meta": { "request_id": "019461A0-0000-7000-8000-000000000000" }, "error": { "code": "API_KEY_INVALID", "message": "Invalid API key", "description": "Provided API key was invalid." } } } } }, "Forbidden": { "description": "Forbidden - The request is understood, but access is not allowed", "headers": { "Access-Control-Allow-Origin": { "$ref": "#/components/headers/Access-Control-Allow-Origin" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" }, "example": { "meta": { "request_id": "01892A4D-7586-7000-8000-000000000000" }, "error": { "code": "ACCESS_DENIED", "message": "Access Denied", "description": "You do not have permission to perform this operation." } } } } }, "DwhTooManyRequests": { "description": "Too Many Requests - Rate limit exceeded.", "headers": { "Retry-After": { "schema": { "type": "integer", "format": "int32", "minimum": "1", "maximum": "3600" }, "description": "Number of seconds to wait before making another request" }, "Access-Control-Allow-Origin": { "$ref": "#/components/headers/Access-Control-Allow-Origin" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" }, "example": { "meta": { "request_id": "019461A0-0000-7000-8000-000000000000" }, "error": { "code": "API_ROW_QUOTA_EXCEEDED", "message": "Row quota exceeded", "description": "You have exceeded your row-quota limit of rows for this month. Please log into Supermetrics Hub at https://hub.supermetrics.com/ and upgrade your plan, or contact our Supermetrics support team." } } } } }, "DwhInternalServerError": { "description": "Internal Server Error - An error occurred on the server.", "headers": { "Access-Control-Allow-Origin": { "$ref": "#/components/headers/Access-Control-Allow-Origin" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" }, "example": { "meta": { "request_id": "01892A4D-7586-7000-8000-000000000000" }, "error": { "code": "INTERNAL_SERVER_ERROR", "message": "Internal Server Error", "description": "An unexpected error occurred. Please try again later or contact support." } } } } } }, "securitySchemes": { "BearerAuth": { "type": "http", "scheme": "bearer", "description": "Bearer token authentication. Include the token in the Authorization header:\n`Authorization: Bearer `\n" } } } } ````