Merchant resolution

AI agent instructions

Read the Notte skill and follow its setup instructions when setting up Notte or building browser automation. This is the shared source for CLI setup, authentication, and the browser-to-code workflow.

POST /data/brand/retrieve with "type": "by_transaction" takes the messy text from a card or bank statement and returns the merchant behind it, using the same profile as Company enrichment.

Try it in the Console

Try this API in the playground, no code needed.

Quick start

curl -X POST https://api.notte.cc/data/brand/retrieve \
  -H "Authorization: Bearer $NOTTE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "by_transaction",
    "transaction_info": "STARBUCKS STORE 12345 SEATTLE WA",
    "country_gl": "us"
  }'

{
  "status": "ok",
  "code": 200,
  "brand": {
    "domain": "starbucks.com",
    "title": "Starbucks Coffee Company",
    "colors": [{ "hex": "#00754a", "source": "site" }],
    "logos": [{ "url": "https://www.starbucks.com/assets/icons/siren.svg", "type": "logo" }]
  }
}

Parameters

string

required

Always by_transaction.

string

required

The descriptor text, 3 to 500 characters.

string

Country code to narrow the match, for example us.

string

City from the transaction.

string

Merchant category code.

string

Merchant phone number from the transaction.

boolean

default:"false"

Only return a match when the API is confident.

boolean

default:"false"

Prioritize speed.

object

milliseconds and behavior: fail or return-partial.

string[]

Free-form labels attached to the request.

When no merchant is found

If the descriptor can’t be resolved reliably, the API returns:

{
  "error_code": "NOT_FOUND",
  "message": "The merchant could not be identified reliably.",
  "request_id": "..."
}

Add city, mcc or phone and retry.

Getting Started

Sessions

Authentication

Functions

Data APIs

Anything API

Merchant resolution

Try it in the Console

Quick start

Parameters

When no merchant is found

Try it in the Console

​Quick start

​Parameters

​When no merchant is found

Quick start

Parameters

When no merchant is found