Propose a config-only field-map/dialect mapping for a source sample

curl --request POST \
  --url https://matcher.sandbox.lerian.net/v1/imports/contexts/{contextId}/sources/{sourceId}/mapping-proposal \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "sample": "<string>",
  "hints": {}
}
'

import requests

url = "https://matcher.sandbox.lerian.net/v1/imports/contexts/{contextId}/sources/{sourceId}/mapping-proposal"

payload = {
    "sample": "<string>",
    "hints": {}
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({sample: '<string>', hints: {}})
};

fetch('https://matcher.sandbox.lerian.net/v1/imports/contexts/{contextId}/sources/{sourceId}/mapping-proposal', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://matcher.sandbox.lerian.net/v1/imports/contexts/{contextId}/sources/{sourceId}/mapping-proposal",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'sample' => '<string>',
    'hints' => [
        
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://matcher.sandbox.lerian.net/v1/imports/contexts/{contextId}/sources/{sourceId}/mapping-proposal"

	payload := strings.NewReader("{\n  \"sample\": \"<string>\",\n  \"hints\": {}\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://matcher.sandbox.lerian.net/v1/imports/contexts/{contextId}/sources/{sourceId}/mapping-proposal")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"sample\": \"<string>\",\n  \"hints\": {}\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://matcher.sandbox.lerian.net/v1/imports/contexts/{contextId}/sources/{sourceId}/mapping-proposal")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"sample\": \"<string>\",\n  \"hints\": {}\n}"

response = http.request(request)
puts response.read_body

{
  "fields": [
    {
      "canonicalKey": "<string>",
      "confidence": 0.5,
      "rationale": "<string>",
      "sourceColumn": "<string>"
    }
  ],
  "dialect": {
    "dateStyle": "<string>",
    "decimalStyle": "<string>",
    "delimiter": "<string>",
    "encoding": "<string>"
  },
  "mapping": {}
}

{
  "code": "<string>",
  "detail": "<string>",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "<string>",
  "status": 123,
  "title": "<string>",
  "type": "about:blank"
}

Propose a config-only field-map/dialect mapping for a source sample

Inspects a representative sample of a source file and returns a CONFIG-ONLY mapping/dialect proposal (column→canonical-key suggestions, dialect, per-field confidence and rationale). It is ADVISORY and side-effect-free: producing a proposal PERSISTS NOTHING. The operator reviews the proposal and confirms it through the EXISTING field-map declaration path. The tenant is resolved from the JWT and the context/source from the path — never from the body. The response never carries parsed values, amounts, or transactions.

POST

imports

contexts

{contextId}

sources

{sourceId}

mapping-proposal

Propose a config-only field-map/dialect mapping for a source sample

curl --request POST \
  --url https://matcher.sandbox.lerian.net/v1/imports/contexts/{contextId}/sources/{sourceId}/mapping-proposal \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "sample": "<string>",
  "hints": {}
}
'

import requests

url = "https://matcher.sandbox.lerian.net/v1/imports/contexts/{contextId}/sources/{sourceId}/mapping-proposal"

payload = {
    "sample": "<string>",
    "hints": {}
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({sample: '<string>', hints: {}})
};

fetch('https://matcher.sandbox.lerian.net/v1/imports/contexts/{contextId}/sources/{sourceId}/mapping-proposal', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://matcher.sandbox.lerian.net/v1/imports/contexts/{contextId}/sources/{sourceId}/mapping-proposal",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'sample' => '<string>',
    'hints' => [
        
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://matcher.sandbox.lerian.net/v1/imports/contexts/{contextId}/sources/{sourceId}/mapping-proposal"

	payload := strings.NewReader("{\n  \"sample\": \"<string>\",\n  \"hints\": {}\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://matcher.sandbox.lerian.net/v1/imports/contexts/{contextId}/sources/{sourceId}/mapping-proposal")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"sample\": \"<string>\",\n  \"hints\": {}\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://matcher.sandbox.lerian.net/v1/imports/contexts/{contextId}/sources/{sourceId}/mapping-proposal")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"sample\": \"<string>\",\n  \"hints\": {}\n}"

response = http.request(request)
puts response.read_body

{
  "fields": [
    {
      "canonicalKey": "<string>",
      "confidence": 0.5,
      "rationale": "<string>",
      "sourceColumn": "<string>"
    }
  ],
  "dialect": {
    "dateStyle": "<string>",
    "decimalStyle": "<string>",
    "delimiter": "<string>",
    "encoding": "<string>"
  },
  "mapping": {}
}

{
  "code": "<string>",
  "detail": "<string>",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "<string>",
  "status": 123,
  "title": "<string>",
  "type": "about:blank"
}

Authorizations

Authorization

string

header

required

Bearer token authentication (format: "Bearer {token}")

Path Parameters

contextId

string<uuid>

required

Context ID

sourceId

string<uuid>

required

Source ID

Body

application/json

sample

string

required

Representative source-file sample

Minimum string length: 1

Example:

"id;value;ccy;posted_at\nA1;10,50;BRL;2025-06-01\n"

format

enum<string>

Declared file format hint

Available options:

csv,

json,

xml,

camt053

Example:

"csv"

hints

object

Optional non-secret operator nudges (e.g. locale=pt-BR, has_header=true)

Show child attributes

Response

fields

object[] | null

required

Per-field breakdown backing the proposed mapping

Show child attributes

dialect

object

Proposed source dialect; null when the advisor has no dialect suggestion

Show child attributes

mapping

object

Proposed canonical field map (canonical key -> source column); null when the advisor could not propose a mapping

Show child attributes

⌘I

Getting started

Configuration Contexts API

Configuration Match Rules API

Configuration Sources API

Configuration Field Maps API

Configuration Fee Schedules API

Configuration Fee Rules API

Configuration Schedules API

Exception workflow

Bulk actions

Comments

Callback credentials

Disputes API

Export Jobs API

Governance API

Ingestion jobs

Layouts and formats

Extraction reviews

Document extraction

Match runs

Manual matching and adjustments

Candidates and open items

Rule suggestions

Dashboard and metrics

Reports

Exports

Discovery status

Discovery connections

Extractions

Aggregator connections

Aggregator webhooks

Error handling

Propose a config-only field-map/dialect mapping for a source sample

Authorizations

Path Parameters

Body

Response