---
title: "suggestErpImportUseCases"
method: POST
path: "/v2/erp/imports/{importId}:suggest-use-cases"
tags: ["erp-imports"]
---

# suggestErpImportUseCases

`POST /v2/erp/imports/{importId}:suggest-use-cases`

Rank the org's inbound use cases against this file's columns — the input to the ranked picker ("matches 6 of your 7 columns"). Optional: skip this and call `:validate` directly when the use case is already known. Reads only the file's first row, not its data.
Every eligible use case is returned, including ones matching nothing: the "nothing fits, pick anyway" view needs the full list. Highest match first.
CSV only — an xlsx import fails with 400 rather than silently returning zero matches, which would look identical to "we checked and nothing matches".

## Path parameters

- `importId` string, required

## Response `200`

Ranked use-case suggestions

- SuggestErpImportUseCasesResponse
  - `file_columns` integer, required — Columns in the file. Present even when `suggestions` is empty.
  - `suggestions` ErpImportUseCaseSuggestion[], required
    - `integration_id` string, required
    - `integration_name` string, required
    - `use_case_slug` string, required
    - `use_case_name` string, required
    - `entity_types` integer, required — How many distinct entity schemas this mapping uses.
    - `matched_columns` integer, required — How many of the FILE's columns this use case reads, by exact trimmed name.

## Other responses

- `400` — Bad request
- `403` — Forbidden - insufficient permissions
- `404` — Resource not found
- `500` — Internal Server Error

---

[API](https://skmtc.net/epilot/apis/integration-toolkit-api.md) · [All operations](https://skmtc.net/epilot/apis/integration-toolkit-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/epilot/integration-toolkit-api/revisions/cf02c9310c0f/schema)