---
title: "Match Datasets"
method: POST
path: "/v2/explore-use-cases/match"
tags: ["Explore Use Cases"]
---

# Match Datasets

`POST /v2/explore-use-cases/match`

Match data assets to a user's persona using AI.

This public endpoint allows potential customers to describe their business
needs and receive AI-powered recommendations for relevant CarbonArc data assets.

Uses AWS Bedrock with Claude 3.5 Sonnet for inference.

**Rate Limited**: 5 requests per minute per IP address.

## Request body

- PersonaInput — Input describing the user's persona and data needs.
  - `industry` string, required — User's industry (e.g., 'Financial Services')
  - `company_type` string, required — Type of company (e.g., 'Hedge Fund', 'Retailer')
  - `use_cases` string[] — Selected use cases of interest
  - `description` string, required — Free-text description of data needs

## Response `200`

Successful Response

- MatchResult — Result of the AI-powered data asset matching.
  - `persona` PersonaInput, required — Input describing the user's persona and data needs.
    - `industry` string, required — User's industry (e.g., 'Financial Services')
    - `company_type` string, required — Type of company (e.g., 'Hedge Fund', 'Retailer')
    - `use_cases` string[] — Selected use cases of interest
    - `description` string, required — Free-text description of data needs
  - `matches` DatasetMatch[], required — Ranked list of matching data assets
    - `dataset_id` string[], required — Dataset ID(s)
    - `dataset_name` string, required — Name of the data asset
    - `description` string, required — Data asset description
    - `category` string, required — Data asset category (demand/supply/reference)
    - `provider_name` string, nullable — Data provider name
    - `match_score` integer, required — Relevance score 0-100
    - `use_cases` string[] — Example use cases for this data asset
  - `total_datasets_evaluated` integer, required — Total number of data assets considered

## Other responses

- `404` — Not Found
- `422` — Validation Error

---

[API](https://skmtc.net/carbonarc/apis/carbon-arc-api-documentation.md) · [All operations](https://skmtc.net/carbonarc/apis/carbon-arc-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/carbonarc/carbon-arc-api-documentation/revisions/bd33ea42994c/schema)