---
title: "Browse the supported format catalog"
method: GET
path: "/v1/imports/formats"
tags: ["Ingestion"]
---

# Browse the supported format catalog

`GET /v1/imports/formats`

Returns the read-only catalog of formats the ingestion engine can parse, namespaced region -> family -> variant. The catalog is global-first and static (built-in parsers carry no tenant), so the response is identical for every authenticated caller. No path, query, or body parameters — the tenant is irrelevant to the built-in catalog.

## Response `200`

OK

- FormatCatalogResponse
  - `regions` FormatCatalogRegion[], nullable, required — Region axis of the catalog (ISO-3166 alpha-2 uppercased, or XX for region-neutral formats), sorted by region code
    - `families` FormatCatalogFamily[], nullable, required — Format families under this region, sorted by family
      - `family` string, required — Closed-enum format family name (e.g. cnab240, delimited, camt)
      - `variants` FormatCatalogVariant[], nullable, required — Brand/bank variants under this family, sorted by variant; a single-canonical-layout family (e.g. camt) yields one entry with an empty variant
        - `key` string, required — Canonical namespaced registry key (region/family[/variant]); the identity an upload or source declaration pins
        - `variant` string, required — Open brand/bank axis (e.g. itau, febraban-base); empty for a single-canonical-layout family
    - `region` string, required — Region code: ISO-3166 alpha-2 uppercased, or XX for region-neutral formats

## Other responses

- `default` — Error

---

[API](https://skmtc.net/lerian/apis/identity-plugin.md) · [All operations](https://skmtc.net/lerian/apis/identity-plugin/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lerian/identity-plugin/versions/25daba385532/schema)