> ## 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 all blends

> Returns all blends for a team, optionally filtered by type.

## OpenAPI

````json GET /v1/teams/{team_id}/data-blending/blends
{
  "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": {
    "/v1/teams/{team_id}/data-blending/blends": {
      "get": {
        "summary": "List all blends",
        "description": "Returns all blends for a team, optionally filtered by type.",
        "operationId": "BlendController::getTeamBlendsAction",
        "x-middlewares": [
          {
            "name": "team-access-check",
            "options": {
              "team-id-param": "team_id"
            }
          },
          {
            "name": "permission-check",
            "options": {
              "permission-id": "data_blending.view"
            }
          },
          {
            "name": "data-blending-access-check"
          }
        ],
        "security": [
          {
            "BearerAuth": [
              "data_blending_read"
            ]
          }
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/TeamId"
          },
          {
            "name": "type",
            "in": "query",
            "required": "false",
            "description": "Filter blends by type",
            "example": "union",
            "schema": {
              "type": "string",
              "enum": [
                "join",
                "union"
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Blends retrieved successfully",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/BlendListResponse"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "429": {
            "$ref": "#/components/responses/TooManyRequests"
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        },
        "tags": [
          "Data Blending"
        ]
      }
    }
  },
  "components": {
    "parameters": {
      "TeamId": {
        "name": "team_id",
        "in": "path",
        "required": "true",
        "description": "ID of the team",
        "example": "936506",
        "schema": {
          "type": "integer",
          "format": "int64",
          "minimum": "1",
          "maximum": "9223372036854776000"
        }
      }
    },
    "schemas": {
      "BlendListResponse": {
        "type": "object",
        "description": "Response envelope containing a list of blends",
        "example": {
          "meta": {
            "request_id": "jxfnEjDRXARNUuUqsatGmaVG3udCNz2y"
          },
          "data": {
            "items": [
              {
                "blend_id": "569",
                "blend_uuid": "71bc0582-31b5-11f1-a55c-4201ac182030",
                "type": "union",
                "display_name": "Example Blend",
                "description": "Example blend description",
                "modified_time_utc": "2026-04-06T12:37:59+00:00",
                "last_modify_user_email": "user@supermetrics.com",
                "blended_data_sources": {
                  "items": [
                    {
                      "blend_data_source_id": "1",
                      "data_source_id": "GA4",
                      "display_name": "Google Analytics 4",
                      "logo_url": "https://cdn.supermetrics.com/images/datasource-logos/GA4.png"
                    }
                  ]
                }
              }
            ]
          }
        },
        "properties": {
          "meta": {
            "type": "object",
            "description": "Response metadata",
            "example": {},
            "properties": {
              "request_id": {
                "type": "string",
                "maxLength": "36",
                "pattern": "^[A-Za-z0-9_-]+",
                "description": "Unique ID of the request",
                "example": "RfNUgKPReZtgmzkqAFe4ArjuCQXQuaRr"
              }
            }
          },
          "data": {
            "type": "object",
            "description": "List of blends",
            "properties": {
              "items": {
                "type": "array",
                "maxItems": "1000",
                "description": "Blend items",
                "example": [],
                "items": {
                  "$ref": "#/components/schemas/BlendListItemOutput"
                }
              }
            }
          }
        }
      },
      "BlendListItemOutput": {
        "type": "object",
        "description": "A blend summary returned in list responses (without config)",
        "properties": {
          "blend_id": {
            "type": "integer",
            "format": "int64",
            "minimum": "1",
            "maximum": "9223372036854776000",
            "description": "Blend ID",
            "example": "569"
          },
          "blend_uuid": {
            "type": "string",
            "format": "uuid",
            "maxLength": "36",
            "description": "Blend UUID",
            "example": "71bc0582-31b5-11f1-a55c-4201ac182030"
          },
          "type": {
            "type": "string",
            "enum": [
              "join",
              "union"
            ],
            "description": "Blend type",
            "example": "union"
          },
          "display_name": {
            "type": "string",
            "maxLength": "300",
            "pattern": "^.+",
            "description": "Display name of the blend",
            "example": "My Blend"
          },
          "description": {
            "type": "string",
            "maxLength": "300",
            "nullable": "true",
            "pattern": "^.+",
            "description": "Description of the blend",
            "example": "Description of the blend"
          },
          "modified_time_utc": {
            "type": "string",
            "format": "date-time",
            "maxLength": "32",
            "description": "UTC timestamp of the last modification",
            "example": "2026-04-07T10:00:00+00:00"
          },
          "last_modify_user_email": {
            "type": "string",
            "format": "email",
            "maxLength": "254",
            "description": "Email of the user who last modified the blend",
            "example": "user@supermetrics.com"
          },
          "blended_data_sources": {
            "type": "object",
            "description": "Simplified data source list for this blend",
            "properties": {
              "items": {
                "type": "array",
                "maxItems": "50",
                "description": "Data source items",
                "example": [],
                "items": {
                  "$ref": "#/components/schemas/BlendListDataSourceOutput"
                }
              }
            }
          }
        }
      },
      "ErrorResponse_ErrorResponse": {
        "type": "object",
        "description": "Standard envelope returned by all error (4xx/5xx) responses.",
        "properties": {
          "meta": {
            "$ref": "#/components/schemas/Meta"
          },
          "error": {
            "$ref": "#/components/schemas/ErrorResponse_Error"
          }
        },
        "required": [
          "meta",
          "error"
        ],
        "additionalProperties": "false"
      },
      "ErrorResponse": {
        "type": "object",
        "properties": {
          "meta": {
            "$ref": "#/components/schemas/ResponseMeta"
          },
          "error": {
            "$ref": "#/components/schemas/Error"
          }
        }
      },
      "BlendListDataSourceOutput": {
        "type": "object",
        "description": "Simplified data source info returned in blend list responses",
        "properties": {
          "blend_data_source_id": {
            "type": "integer",
            "format": "int64",
            "minimum": "1",
            "maximum": "9223372036854776000",
            "description": "Internal ID of the blended data source",
            "example": "1"
          },
          "data_source_id": {
            "type": "string",
            "maxLength": "100",
            "pattern": "^[A-Za-z0-9_]+",
            "description": "Data source identifier",
            "example": "GA4"
          },
          "display_name": {
            "type": "string",
            "maxLength": "300",
            "pattern": "^.+",
            "description": "Display name of the data source",
            "example": "Google Analytics 4"
          },
          "logo_url": {
            "type": "string",
            "format": "uri",
            "maxLength": "2048",
            "description": "Data source logo URL",
            "example": "https://cdn.supermetrics.com/images/datasource-logos/GA4.png"
          }
        }
      },
      "Meta": {
        "type": "object",
        "description": "Metadata included in every API response.",
        "properties": {
          "request_id": {
            "$ref": "#/components/schemas/RequestId"
          }
        },
        "required": [
          "request_id"
        ],
        "additionalProperties": "false"
      },
      "ErrorResponse_Error": {
        "type": "object",
        "description": "Machine- and human-readable detail for a failed request.",
        "properties": {
          "code": {
            "type": "string",
            "pattern": "^[A-Z][A-Z0-9_]*$",
            "maxLength": "100",
            "description": "Stable, screaming-snake-case identifier for the error condition. Clients should branch on this, not on `message`. Common values include BAD_REQUEST, UNAUTHORIZED, FORBIDDEN, NOT_FOUND, CONFLICT_ERROR, PERMISSION_ERROR, UNPROCESSABLE_ENTITY, UNPROCESSABLE_CONTENT, TOO_MANY_REQUESTS, INTERNAL_SERVER_ERROR, DUPLICATION_FAILED, SERVICE_UNAVAILABLE; domains may define additional codes.\n",
            "example": "BAD_REQUEST"
          },
          "message": {
            "type": "string",
            "maxLength": "255",
            "pattern": "^.+$",
            "description": "Short, human-readable summary of the error.",
            "example": "The request was invalid."
          },
          "description": {
            "type": "string",
            "maxLength": "2048",
            "description": "Optional longer explanation specific to this occurrence.",
            "example": "The field 'display_name' must not be empty."
          }
        },
        "required": [
          "code",
          "message"
        ],
        "additionalProperties": "false"
      },
      "ResponseMeta": {
        "type": "object",
        "properties": {
          "request_id": {
            "type": "string",
            "maxLength": "50",
            "pattern": "^[A-Za-z0-9_-]+$",
            "description": "API request ID"
          }
        }
      },
      "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"
          }
        }
      },
      "RequestId": {
        "type": "string",
        "description": "Unique identifier for the request, for tracking and debugging.",
        "pattern": "^[A-Za-z0-9_-]+$",
        "minLength": "8",
        "maxLength": "64",
        "example": "BXaEFVtjc7TXaJxgZhmFgSUD9edqq_CN",
        "x-faker": {
          "random.alphaNumeric": "30"
        }
      }
    },
    "responses": {
      "BadRequest": {
        "description": "Bad request - invalid parameters",
        "headers": {
          "X-RateLimit-Limit": {
            "$ref": "#/components/headers/RateLimitHeaders-X-RateLimit-Limit"
          },
          "X-RateLimit-Remaining": {
            "$ref": "#/components/headers/RateLimitHeaders-X-RateLimit-Remaining"
          },
          "Access-Control-Allow-Origin": {
            "$ref": "#/components/headers/Access-Control-Allow-Origin"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorResponse_ErrorResponse"
            },
            "example": {
              "meta": {
                "request_id": "BXaEFVtjc7TXaJxgZhmFgSUD9edqq_CN"
              },
              "error": {
                "code": "BAD_REQUEST",
                "message": "The request was invalid."
              }
            }
          }
        }
      },
      "Unauthorized": {
        "description": "Unauthorized - invalid or missing authentication",
        "headers": {
          "Content-Type": {
            "$ref": "#/components/headers/Content-Type"
          },
          "X-RateLimit-Limit": {
            "$ref": "#/components/headers/X-RateLimit-Limit"
          },
          "X-RateLimit-Remaining": {
            "$ref": "#/components/headers/X-RateLimit-Remaining"
          },
          "Access-Control-Allow-Origin": {
            "$ref": "#/components/headers/Access-Control-Allow-Origin"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorResponse"
            }
          }
        }
      },
      "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."
              }
            }
          }
        }
      },
      "TooManyRequests": {
        "description": "Too Many Requests - rate limit exceeded",
        "headers": {
          "Content-Type": {
            "$ref": "#/components/headers/Content-Type"
          },
          "X-RateLimit-Limit": {
            "$ref": "#/components/headers/X-RateLimit-Limit"
          },
          "X-RateLimit-Remaining": {
            "$ref": "#/components/headers/X-RateLimit-Remaining"
          },
          "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"
            }
          }
        }
      },
      "InternalServerError": {
        "description": "Internal Server Error - unexpected server error",
        "headers": {
          "Content-Type": {
            "$ref": "#/components/headers/Content-Type"
          },
          "X-RateLimit-Limit": {
            "$ref": "#/components/headers/X-RateLimit-Limit"
          },
          "X-RateLimit-Remaining": {
            "$ref": "#/components/headers/X-RateLimit-Remaining"
          },
          "Access-Control-Allow-Origin": {
            "$ref": "#/components/headers/Access-Control-Allow-Origin"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorResponse"
            }
          }
        }
      }
    },
    "securitySchemes": {
      "BearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "description": "Bearer token authentication. Include the token in the Authorization header:\n`Authorization: Bearer <your-token>`\n"
      }
    },
    "headers": {
      "RateLimitHeaders-X-RateLimit-Limit": {
        "description": "Request limit per hour",
        "schema": {
          "type": "integer",
          "format": "int32",
          "minimum": "1",
          "maximum": "10000",
          "example": "5000"
        }
      },
      "RateLimitHeaders-X-RateLimit-Remaining": {
        "description": "Remaining requests in current window",
        "schema": {
          "type": "integer",
          "format": "int32",
          "minimum": "0",
          "maximum": "10000",
          "example": "4999"
        }
      },
      "Access-Control-Allow-Origin": {
        "description": "CORS header",
        "schema": {
          "type": "string",
          "maxLength": "255",
          "enum": [
            "*"
          ],
          "example": "*"
        }
      },
      "Content-Type": {
        "description": "HTTP response content type",
        "schema": {
          "type": "string",
          "maxLength": "255",
          "enum": [
            "application/json"
          ],
          "example": "application/json"
        }
      },
      "X-RateLimit-Limit": {
        "description": "Request limit per hour",
        "schema": {
          "type": "integer",
          "format": "int32",
          "minimum": "1",
          "maximum": "10000",
          "example": "100"
        }
      },
      "X-RateLimit-Remaining": {
        "description": "Remaining requests in current window",
        "schema": {
          "type": "integer",
          "format": "int32",
          "minimum": "0",
          "maximum": "10000",
          "example": "49"
        }
      }
    }
  }
}
````