Transaction-only beta key, issued with your beta access and always visible in the Transaction Playground. Existing Logo.dev secret keys do not authenticate this beta.
Body
application/json
The body takes no fields other than these. An unrecognized field returns 400.
transaction
string
required
The merchant name or card descriptor. The API trims surrounding whitespace, then the value must be 1 to 1,024 characters.
Required string length: 1 - 1024
Example:
"Starbucks"
country_code
string
ISO 3166-1 alpha-2 country code, such as US or GB. Lowercase is accepted. The code is a hint for ambiguous names. It does not restrict results to that country. An unknown code returns 400. With transaction_context, the codes AQ, AX, TF, and VA return 400.
Required string length: 2
Example:
"US"
transaction_context
object
The real transaction values. Send them to identify the other party as a person or an organization, and to name the platform the purchase ran through. With context, the response adds entity_type.
When you send the object, date, amount, currency, and entry_type are required. The API fills in no placeholder values. Incomplete context returns 400 and does not count against the daily allowance.
The merchant string, the context, and the account holder details go to Logo.dev's enrichment provider. Each lookup carries its own context. The beta keeps no account history across lookups.
Hide child attributes
transaction_context.date
string<date>
required
The posted date as YYYY-MM-DD, from 1970-01-01 to tomorrow in UTC.
Example:
"2026-09-04"
transaction_context.amount
number
required
A nonnegative amount in the currency's major units, such as dollars, up to 1,000,000,000,000.
The direction of the money, from the bank account owner's side.
Available options:
incoming,
outgoing
transaction_context.account_holder
object
The bank account owner. Send it when the account holder matters, for example to tell a person from a business.
Hide child attributes
transaction_context.account_holder.type
enum<string>
required
Whether the bank account owner is a consumer or a business.
Available options:
consumer,
business
transaction_context.account_holder.name
string
The bank account owner's name. The API trims surrounding whitespace. Send it when a descriptor holds several names and the owner's name helps pick out the other party.
Required string length: 1 - 1024
Response
A matched row or a cleaned row. Every non-empty transaction returns one. The examples are illustrative: they show the shape, not the result for a particular string.
domain
string | null
required
The merchant's domain. null on a cleaned row.
name
string
required
The display name. Present for every non-empty transaction.
When Brand resolves a brand for the domain, its name wins.
Otherwise it is the name the transaction lookup returned.
On a cleaned row it is the descriptor, tidied into a display name.
Descriptors arrive in one case, so a tidied name reads Fedex, not FedEx. When the Logo.dev brand corpus holds the same name, a cleaned row takes the company's own spelling. Only the name changes. The row stays cleaned at the same confidence.
Example:
"Starbucks"
entity_id
string | null
required
The merchant's Logo.dev brand id, the same id Brand uses. A brand keeps its id when its domain changes, so key your records on entity_id, not domain.
A row with an id has two sources that agree: the pipeline identified the merchant, and Brand resolves a brand for the same domain. Branch on entity_id, not on confidence.
null on a cleaned row, and on a matched row when Brand resolves no brand for the domain. A domain that Logo.dev has not indexed yet also returns null. A later lookup can return an id after the first crawl finishes.
Example:
"brand_5k2mq8h0000g00400000000017"
logo_url
string<uri> | null
required
The Logo.dev CDN URL for the merchant's logo. null on a cleaned row. The URL has no token. Add your publishable key before you show it: https://img.logo.dev/starbucks.com?token=LOGO_DEV_PUBLISHABLE_KEY. The same applies to logo_url in parent and intermediary.
Example:
"https://img.logo.dev/starbucks.com"
parent
object | null
required
The company that owns the merchant, or null. It sits beside the merchant and never replaces it: a lookup for Facebook returns Facebook in domain, with Meta here.
Group totals on parent.entity_id to add up one company's brands. Facebook, Instagram, and WhatsApp become Meta. The owner's entity_id is the same id it has when it is the merchant, so the two join on one column.
parent is the nearest owner that Logo.dev records, not the top of the chain. Jaguar returns JLR, and JLR returns Tata Motors. To find the top, look up each parent in turn.
Coverage is thin. Logo.dev records a small, hand-verified list of ownership pairs, so most rows return null. A null means Logo.dev records no owner for this merchant. It does not mean the merchant is independent. parent is also null on a cleaned row, and when Brand resolves no brand for the owner's domain.
A rebrand onto a new domain can come back as a new identity. parent joins it to the old one only when both domains are in the ownership list.
Hide child attributes
parent.domain
string | null
required
The owner's domain.
Example:
"meta.com"
parent.name
string | null
required
The owner's display name, from Brand.
Example:
"Meta"
parent.entity_id
string | null
required
The owner's Logo.dev brand id, the same id Brand uses.
Example:
"brand_9r3hx5f0000g00400000000021"
parent.logo_url
string | null
required
The Logo.dev CDN URL for the owner's logo, with no token.
Example:
"https://img.logo.dev/meta.com"
intermediary
object | null
required
The platform the purchase ran through, or null. The merchant stays in domain. A coffee paid through Square returns the coffee shop, with Square here. The platform gets the same lookup as the merchant, keyed by its own domain, so you can group totals by platform on intermediary.entity_id.
intermediary is null in these cases:
The platform sold the item itself. A DashPass subscription is a purchase from DoorDash, so that row names DoorDash in domain.
The API identified no platform. This does not mean no platform was involved.
Without transaction_context, the API fills intermediary only when the enrichment provider answers the whole descriptor with a platform. The merchant checks then refuse the platform as the seller, and the API looks up the text after the prefix on its own. When the provider resolves the seller directly from a prefixed descriptor, intermediary stays null on a correct row. Send transaction_context when you need the platform named reliably.
A cleaned row can keep a platform. This happens when the checks reject the platform's domain and the text after the prefix identifies nobody.
Hide child attributes
intermediary.domain
string | null
required
The platform's domain, or null.
Example:
"squareup.com"
intermediary.name
string | null
required
The platform's display name, or null. Brand's name wins when there is one.
Example:
"Square"
intermediary.entity_id
string | null
required
The platform's Logo.dev brand id, or null when Brand resolves no brand for its domain.
Example:
"brand_7c1pz4d0000g00400000000052"
intermediary.logo_url
string | null
required
The Logo.dev CDN URL for the platform's logo, with no token, or null when it has no domain.
Example:
"https://img.logo.dev/squareup.com"
status
enum<string>
required
matched when the API identified a merchant domain. cleaned when it did not. There is no not-found result: a cleaned row is an answer, with a tidied display name and null in domain, entity_id, logo_url, and parent.
A row is cleaned for one of two reasons:
Nothing identified the descriptor.
A candidate domain failed a merchant check. The checks catch repeated hostnames, directory and profile hosts, a known platform in the merchant's place, and known descriptor conflicts. They run on saved results and on new lookups.
A failed check drops the domain and uses the tidied descriptor as the name. A platform that a check removes from the merchant's place still comes back in intermediary. An organization with no usable website also comes back cleaned. The API never puts a payment processor's or parent company's domain in place of the merchant's.
Available options:
matched,
cleaned
match_type
enum<string>
required
The pipeline stage that produced the row, strongest first. The set is closed.
enriched_context: identified from the full transaction, with entry type and account holder.
descriptor_domain: the descriptor printed the merchant's own domain.
resolved_entity: identified from the descriptor alone, with no transaction context.
searched_name: the Logo.dev brand corpus recognized the cleaned name.
cleaned_descriptor: nothing identified the merchant. name holds the tidied descriptor.
descriptor_domain and searched_name are fallbacks. They run only when the enrichment provider identifies nobody. A descriptor that the provider recognizes never reaches them: CHEWY.COM XXX-XXX-7111 FL prints a domain and still returns resolved_entity. Both fallbacks face the same merchant checks, so a row that fails them comes back cleaned.
Read match_type from the row. Do not predict it from the descriptor, because the same string can take a different path as the provider's coverage changes.
Available options:
enriched_context,
descriptor_domain,
resolved_entity,
searched_name,
cleaned_descriptor
confidence
number
required
A score from 0 to 1. Two inputs set it: the match_type that produced the row, and whether Brand resolves a brand for the same domain. A printed domain scores above a name resolved from the descriptor, and a corpus search scores below it. A failed merchant check sends the row to the floor. A matched row with no brand has a lower score and a nullentity_id.
The same input always gets the same score, so two runs of a batch compare cleanly.
Logo.dev publishes no cut-off, because the right line depends on what the row feeds. Use the score to rank and triage, for example to sort a review queue. To branch, read entity_id. Logo.dev can recalibrate the score without changing which rows have an id. A high score does not guarantee accuracy.
Required range: 0 <= x <= 1
entity_type
enum<string> | null
Present only when the request includes transaction_context. person or organization, as the enrichment provider classified the other party, or null when it classified nobody.
A null does not mean the API found no merchant. A later stage can identify one, so a matched row can carry null here. A person always comes back as a cleaned row.
Without context, the API does not detect people. It treats a personal name as a merchant name, so Jane Doe can match an organization with a similar name.
Available options:
person,
organization,
null
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Logo.dev","colors":{"primary":"#212121","light":"#FFFFFF","dark":"#333333"},"logo":{"light":"https://mintcdn.com/simplecasual/zsNskQWqsXEQO5xC/logo/light.svg?fit=max\u0026auto=format\u0026n=zsNskQWqsXEQO5xC\u0026q=85\u0026s=61958aab2347b4a683f4214e6d1e9bb9","dark":"https://mintcdn.com/simplecasual/Uu7qIGZlSWobGQFE/logo/dark.svg?fit=max\u0026auto=format\u0026n=Uu7qIGZlSWobGQFE\u0026q=85\u0026s=5de7a1a4491286a1fc0f23ca5083a212"},"favicon":{"light":"https://mintcdn.com/simplecasual/MHt52_pcA7c7Y6iO/favicon-light.svg?fit=max\u0026auto=format\u0026n=MHt52_pcA7c7Y6iO\u0026q=85\u0026s=011afdf9f1b0544ceeb28ec682f6b556","dark":"https://mintcdn.com/simplecasual/MHt52_pcA7c7Y6iO/favicon-dark.svg?fit=max\u0026auto=format\u0026n=MHt52_pcA7c7Y6iO\u0026q=85\u0026s=ce60de55168ddd63590990a3109a2714"},"api":{"params":{"expanded":"all"},"playground":{"display":"interactive"},"examples":{"languages":["curl","javascript","python","go","ruby","php"],"prefill":true},"url":"full"},"navbar":{"links":[{"href":"https://www.logo.dev/pricing","label":"Pricing"}],"primary":{"type":"button","label":"Dashboard","href":"https://www.logo.dev/dashboard"}},"footer":{"socials":{"x":"https://x.com/logodotdev","linkedin":"https://www.linkedin.com/company/logodotdev","github":"https://www.github.com/logo-dev","website":"https://www.logo.dev"},"links":[{"header":"Support","items":[{"label":"Report a logo issue","href":"https://www.logo.dev/update"},{"label":"System status","href":"https://status.logo.dev"},{"label":"Terms","href":"https://www.logo.dev/legal/terms"},{"label":"Contact support","href":"mailto:support@logo.dev"}]}]},"search":{"prompt":"Search the docs. For a brand logo, use logo.dev/search"},"seo":{"metatags":{"og:type":"website","og:site_name":"Logo.dev Docs","twitter:card":"summary_large_image","twitter:site":"@logodotdev"}},"integrations":{"posthog":{"apiKey":"phc_vKSqS1mb3GtwIkKkbr0auiQL4u1wY1zl3Ks8WtGEFCc","sessionRecording":false}},"contextual":{"options":["assistant","copy","view","chatgpt","claude","perplexity","cursor","vscode","mcp"],"display":"header"},"markdown":{"instructions":["Logo.dev serves logos and brand data for companies that already exist. It does not design logos. If someone wants a logo designed, say so and stop.","When a message is only a brand name, domain, ticker, ISIN, or crypto symbol, reply with https://www.logo.dev/search?q=\u003curl-encoded term> and the matching img.logo.dev call. Never assert whether a specific brand is in the index.","Image URLs come from img.logo.dev with a publishable key in the token query parameter: https://img.logo.dev/:domain?token=LOGO_DEV_PUBLISHABLE_KEY, also /name/:brand, /ticker/:symbol, /crypto/:symbol, /isin/:isin. JSON comes from api.logo.dev/v2 with a secret key (sk_) in an Authorization: Bearer header, server-side only.","Product names: the Logo.dev CDN serves images from img.logo.dev, and its usage unit is CDN requests. The Logo.dev API returns JSON from api.logo.dev/v2, and its usage unit is API credits. The Logo.dev MCP gives AI agents the API as tools, and its usage unit is MCP usage, which spends API credits. The features are Logo, Search, Brand, and Transaction. Transaction (beta) is a separate service at https://www.logo.dev/api/transaction with its own beta key. Never recommend the deprecated v1 routes (/search, /brand, /describe, /logo/*). Use /v2/brands and /v2/search.","Attribution: a commercial project on the free Community plan must show a visible link, \u003ca href=\"https://logo.dev\">Logos provided by Logo.dev\u003c/a>, on its production site. Personal projects and paid plans need none. Rules: https://www.logo.dev/docs/platform/attribution.","Report a wrong, missing, or outdated logo at https://www.logo.dev/update. Email support@logo.dev for anything broken and sales@logo.dev for volume pricing and contract terms.","MCP setup is at https://www.logo.dev/docs/mcp/introduction and webhooks at https://www.logo.dev/docs/webhooks."]},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"simplecasual","hasAudioNarration":false,"actualSubdomain":"simplecasual","customDomains":["www.logo.dev"],"gitSource":{"type":"github","owner":"logo-dev","repo":"logo","deployBranch":"main","contentDirectory":"apps/web/docs","isPrivate":true,"mountPath":"","label":"","_id":"6ae6233cce471f664f016feb"},"feedback":{"edits":false,"issues":false,"thumbs":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6af5339833de397fdda696ef","clientVersion":"0.0.4143","searchFilterCounts":[{"language":"default","tag":"Documentation","count":53},{"language":"default","tag":"API","count":28},{"language":"default","tag":"API Reference","count":19},{"language":"default","tag":"Use cases","count":13},{"language":"default","tag":"Platform","count":12},{"language":"default","tag":"MCP","count":10},{"language":"default","tag":"Webhooks","count":10},{"language":"default","tag":"CDN","count":9},{"language":"default","tag":"Brand","count":8},{"language":"default","tag":"Integrations","count":8}]},"assistantConfig":{"enableStarterQuestions":true,"enableContextualStarterQuestions":false,"deflection":{"enabled":true,"email":"support@logo.dev","showHelpButton":true}},"basePath":"/docs","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"starterQuestions":[{"_id":"6af50212f018ab3ae8cfe1dc","deploymentId":"65ff2d3ac6e196e6136bd874","questionText":"What are the rate limits on my plan?","status":"active","generatedBy":"manual","createdAt":"2026-11-12T00:02:26.196Z","updatedAt":"2026-11-12T00:02:26.196Z","__v":0},{"_id":"6af50206f018ab3ae8cfe0ee","deploymentId":"65ff2d3ac6e196e6136bd874","questionText":"How do I get a logo for a company?","status":"active","generatedBy":"manual","createdAt":"2026-11-12T00:02:14.466Z","updatedAt":"2026-11-12T00:02:14.466Z","__v":0},{"_id":"6af50201f018ab3ae8cfe08e","deploymentId":"65ff2d3ac6e196e6136bd874","questionText":"How do I fix a logo that is missing or wrong?","status":"active","generatedBy":"manual","createdAt":"2026-11-12T00:02:09.438Z","updatedAt":"2026-11-12T00:02:09.438Z","__v":0}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"html:not(.dark) #banner a{color:#ffffff!important;text-decoration:none}#banner a{text-decoration:none}.nav-tag-pill:has([data-nav-tag$=\" credits\"]),.nav-tag-pill:has([data-nav-tag$=\" credit\"]),.nav-tag-pill:has([data-nav-tag*=\" credit / \"]),.nav-tag-pill:has([data-nav-tag=\"Pro or Enterprise\"]){display:none}.credits-pill{display:inline-flex;align-items:center;gap:0.5rem;margin-top:1rem;padding:0.375rem 0.75rem;border:1px solid #fde68a;border-radius:0.5rem;background:#fefce8;color:#713f12;font-size:0.875rem;font-weight:600;line-height:1.25rem;text-decoration:none}.credits-pill:hover{border-color:#fcd34d;background:#fef9c3}.credits-pill svg{width:1rem;height:1rem;flex-shrink:0}html.dark .credits-pill{border-color:rgba(161, 98, 7, 0.6);background:rgba(113, 63, 18, 0.25);color:#fef08a}html.dark .credits-pill:hover{background:rgba(113, 63, 18, 0.4)}"}],"page":{"pagePath":"api-reference/transaction-enrichment-api/identify-a-merchant","slug":"/api-reference/transaction-enrichment-api/identify-a-merchant","pageMetadata":{"title":"Identify a merchant","description":"Identify a merchant domain and brand record. Private beta with a daily allowance.","deprecated":null,"version":null,"openapi":"/openapi.json post /transaction","href":"/api-reference/transaction-enrichment-api/identify-a-merchant","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Identify a merchant domain and brand record. Private beta with a daily allowance.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Identify a merchant","description":"Identify a merchant domain and brand record. Private beta with a daily allowance.","deprecated":null,"version":null,"openapi":"/openapi.json post /transaction","href":"/api-reference/transaction-enrichment-api/identify-a-merchant","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/docs/_mintlify/custom/simplecasual/1d10373eb07f4b13/credits-pill.js"],"openApiReferenceData":{"operation":{"tags":["Transaction Enrichment API"],"summary":"Identify a merchant","description":"Identify a merchant domain and brand record. Private beta with a daily allowance.","operationId":"identifyMerchant","x-mint":{"metadata":{"description":"Identify a merchant domain and brand record. Private beta with a daily allowance."}},"security":["e55aa0b9-b90e-4526-88f4-a19347fc971a"],"requestBody":"5af45b0e-642b-47bb-b947-5a048fba2b69","responses":{"200":"5df3e2ca-8751-4825-a197-e313f47f9914","400":"0a5472c5-f657-44e4-9ddf-ce36dc6fd243","401":"ce5bdfcb-24c5-436f-962a-2ad7bafbae3a","403":"cbf1b3e4-5699-4399-883d-a04c9f4f63a1","409":"e9ae3b71-d8fc-4b30-9b29-dc2bbed078e4","413":"dfb5eb54-c450-4365-9ece-45dd794df241","415":"2555f7a6-5280-4942-841b-b70345c5fc14","429":"2f59609f-d226-42fb-b8c0-d8fed0196659","503":"fdad868e-8fdb-4a3b-b7a4-9eb2f5033595"},"method":"post","type":"path","servers":["023447de-89e3-4932-8bc4-877389c27e9b"],"path":"/transaction","baseUrlOptions":["https://www.logo.dev/api"],"title":"Identify a merchant","codeSamples":[],"requestExampleLanguages":["bash","javascript","python","go","ruby","php"],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated","prefillPlaygroundWithExample":true,"prefillPlaygroundExamples":[{"body.transaction":"Starbucks","body.country_code":"US"},{"body.transaction":"SQ* STARBUCKS 10 Union Sq","body.country_code":"US","body.transaction_context.date":"2026-09-04","body.transaction_context.amount":10,"body.transaction_context.currency":"USD","body.transaction_context.entry_type":"outgoing","body.transaction_context.account_holder.type":"consumer"}],"urlDisplay":"full"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["transaction"],"properties":{"transaction":{"type":"string","minLength":1,"maxLength":1024,"description":"The merchant name or card descriptor. The API trims surrounding whitespace, then the value must be 1 to 1,024 characters.","examples":["Starbucks"],"isRequired":true,"uniqueKey":"transaction","typeLabel":"string"},"country_code":{"type":"string","minLength":2,"maxLength":2,"description":"ISO 3166-1 alpha-2 country code, such as `US` or `GB`. Lowercase is accepted. The code is a hint for ambiguous names. It does not restrict results to that country. An unknown code returns `400`. With `transaction_context`, the codes `AQ`, `AX`, `TF`, and `VA` return `400`.","examples":["US"],"uniqueKey":"country_code","typeLabel":"string"},"transaction_context":{"type":"object","additionalProperties":false,"description":"The real transaction values. Send them to identify the other party as a person or an organization, and to name the platform the purchase ran through. With context, the response adds `entity_type`.\n\nWhen you send the object, `date`, `amount`, `currency`, and `entry_type` are required. The API fills in no placeholder values. Incomplete context returns `400` and does not count against the daily allowance.\n\nThe merchant string, the context, and the account holder details go to Logo.dev's enrichment provider. Each lookup carries its own context. The beta keeps no account history across lookups.","required":["date","amount","currency","entry_type"],"properties":{"date":{"type":"string","format":"date","description":"The posted date as `YYYY-MM-DD`, from `1970-01-01` to tomorrow in UTC.","examples":["2026-09-04"],"isRequired":true,"uniqueKey":"transaction_context.date","typeLabel":"string\u003cdate>"},"amount":{"type":"number","minimum":0,"maximum":1000000000000,"description":"A nonnegative amount in the currency's major units, such as dollars, up to 1,000,000,000,000.","examples":[10],"isRequired":true,"uniqueKey":"transaction_context.amount","typeLabel":"number"},"currency":{"type":"string","description":"An ISO 4217 code that the beta supports. Lowercase is accepted. An unsupported code returns `400`. Supported codes: EUR, AED, AFN, XCD, ALL, AMD, AOA, ARS, USD, AUD, AWG, AZN, BAM, BBD, BDT, XOF, BGN, BHD, BIF, BMD, BND, BOB, BRL, BSD, INR, NOK, BWP, BYR, BZD, CAD, CDF, XAF, CHF, NZD, CLP, CNY, COP, CRC, CUP, CVE, ANG, CZK, DJF, DKK, DOP, DZD, EGP, MAD, ERN, ETB, FJD, FKP, GBP, GEL, GHS, GIP, GMD, GNF, GTQ, GYD, HKD, HNL, HUF, IDR, ILS, IQD, IRR, ISK, JMD, JOD, JPY, KES, KGS, KHR, KMF, KPW, KRW, KWD, KYD, KZT, LAK, LBP, LKR, LRD, ZAR, LYD, MDL, MGA, MKD, MMK, MNT, MOP, MRO, MUR, MVR, MWK, MXN, MYR, MZN, XPF, NGN, NIO, NPR, OMR, PEN, PGK, PHP, PKR, PLN, PYG, QAR, RON, RSD, RUB, RWF, SAR, SBD, SCR, SDG, SEK, SGD, SHP, SLL, SOS, SRD, SSP, STD, SYP, SZL, THB, TJS, TMT, TND, TOP, TRY, TTD, TWD, TZS, UAH, UGX, UYU, UZS, VEF, VND, VUV, WST, YER, ZMW, ZWL, HRK.","examples":["USD"],"isRequired":true,"uniqueKey":"transaction_context.currency","typeLabel":"string"},"entry_type":{"type":"string","enum":["incoming","outgoing"],"description":"The direction of the money, from the bank account owner's side.","isRequired":true,"uniqueKey":"transaction_context.entry_type","typeLabel":"enum\u003cstring>"},"account_holder":{"type":"object","additionalProperties":false,"required":["type"],"description":"The bank account owner. Send it when the account holder matters, for example to tell a person from a business.","properties":{"type":{"type":"string","enum":["consumer","business"],"description":"Whether the bank account owner is a consumer or a business.","isRequired":true,"uniqueKey":"transaction_context.account_holder.type","typeLabel":"enum\u003cstring>"},"name":{"type":"string","minLength":1,"maxLength":1024,"description":"The bank account owner's name. The API trims surrounding whitespace. Send it when a descriptor holds several names and the owner's name helps pick out the other party.","uniqueKey":"transaction_context.account_holder.name","typeLabel":"string"}},"uniqueKey":"transaction_context.account_holder","typeLabel":"object"}},"uniqueKey":"transaction_context","typeLabel":"object"}},"description":"The body takes no fields other than these. An unrecognized field returns `400`.","uniqueKey":"","typeLabel":"object"},"examples":{"merchant":{"title":"merchant","value":{"transaction":"Starbucks","country_code":"US"}},"context":{"title":"context","value":{"transaction":"SQ* STARBUCKS 10 Union Sq","country_code":"US","transaction_context":{"date":"2026-09-04","amount":10,"currency":"USD","entry_type":"outgoing","account_holder":{"type":"consumer"}}}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"5df3e2ca-8751-4825-a197-e313f47f9914":{"description":"A `matched` row or a `cleaned` row. Every non-empty `transaction` returns one. The examples are illustrative: they show the shape, not the result for a particular string.","headers":{"X-RateLimit-Limit":{"description":"Your daily request limit. See [daily allowance](/transaction/introduction#daily-allowance).","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining after this call.","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Next midnight UTC as Unix seconds.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["domain","name","entity_id","logo_url","parent","intermediary","status","match_type","confidence"],"properties":{"domain":{"oneOf":[{"type":"string","description":"The merchant's domain. `null` on a `cleaned` row.","isRequired":true,"uniqueKey":"domain.oneOf.0","typeLabel":"string"},{"type":"null","description":"The merchant's domain. `null` on a `cleaned` row.","isRequired":true,"uniqueKey":"domain.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"domain","typeLabel":"string | null"},"name":{"type":"string","description":"The display name. Present for every non-empty `transaction`.\n\n- When Brand resolves a brand for the domain, its name wins.\n- Otherwise it is the name the transaction lookup returned.\n- On a `cleaned` row it is the descriptor, tidied into a display name.\n\nDescriptors arrive in one case, so a tidied name reads `Fedex`, not `FedEx`. When the Logo.dev brand corpus holds the same name, a `cleaned` row takes the company's own spelling. Only the name changes. The row stays `cleaned` at the same `confidence`.","examples":["Starbucks"],"isRequired":true,"uniqueKey":"name","typeLabel":"string"},"entity_id":{"oneOf":[{"type":"string","description":"The merchant's Logo.dev brand id, the same id Brand uses. A brand keeps its id when its domain changes, so key your records on `entity_id`, not `domain`.\n\nA row with an id has two sources that agree: the pipeline identified the merchant, and Brand resolves a brand for the same domain. Branch on `entity_id`, not on `confidence`.\n\n`null` on a `cleaned` row, and on a `matched` row when Brand resolves no brand for the domain. A domain that Logo.dev has not indexed yet also returns `null`. A later lookup can return an id after the first crawl finishes.","examples":["brand_5k2mq8h0000g00400000000017"],"isRequired":true,"uniqueKey":"entity_id.oneOf.0","typeLabel":"string"},{"type":"null","description":"The merchant's Logo.dev brand id, the same id Brand uses. A brand keeps its id when its domain changes, so key your records on `entity_id`, not `domain`.\n\nA row with an id has two sources that agree: the pipeline identified the merchant, and Brand resolves a brand for the same domain. Branch on `entity_id`, not on `confidence`.\n\n`null` on a `cleaned` row, and on a `matched` row when Brand resolves no brand for the domain. A domain that Logo.dev has not indexed yet also returns `null`. A later lookup can return an id after the first crawl finishes.","examples":["brand_5k2mq8h0000g00400000000017"],"isRequired":true,"uniqueKey":"entity_id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"entity_id","typeLabel":"string | null"},"logo_url":{"oneOf":[{"type":"string","format":"uri","description":"The Logo.dev CDN URL for the merchant's logo. `null` on a `cleaned` row. The URL has no token. Add your publishable key before you show it: `https://img.logo.dev/starbucks.com?token=LOGO_DEV_PUBLISHABLE_KEY`. The same applies to `logo_url` in `parent` and `intermediary`.","examples":["https://img.logo.dev/starbucks.com"],"isRequired":true,"uniqueKey":"logo_url.oneOf.0","typeLabel":"string\u003curi>"},{"type":"null","format":"uri","description":"The Logo.dev CDN URL for the merchant's logo. `null` on a `cleaned` row. The URL has no token. Add your publishable key before you show it: `https://img.logo.dev/starbucks.com?token=LOGO_DEV_PUBLISHABLE_KEY`. The same applies to `logo_url` in `parent` and `intermediary`.","examples":["https://img.logo.dev/starbucks.com"],"isRequired":true,"uniqueKey":"logo_url.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"logo_url","typeLabel":"string\u003curi> | null"},"parent":{"oneOf":[{"type":"object","description":"The company that owns the merchant, or `null`. It sits beside the merchant and never replaces it: a lookup for Facebook returns Facebook in `domain`, with Meta here.\n\nGroup totals on `parent.entity_id` to add up one company's brands. Facebook, Instagram, and WhatsApp become Meta. The owner's `entity_id` is the same id it has when it is the merchant, so the two join on one column.\n\n`parent` is the nearest owner that Logo.dev records, not the top of the chain. Jaguar returns JLR, and JLR returns Tata Motors. To find the top, look up each parent in turn.\n\nCoverage is thin. Logo.dev records a small, hand-verified list of ownership pairs, so most rows return `null`. A `null` means Logo.dev records no owner for this merchant. It does not mean the merchant is independent. `parent` is also `null` on a `cleaned` row, and when Brand resolves no brand for the owner's domain.\n\nA rebrand onto a new domain can come back as a new identity. `parent` joins it to the old one only when both domains are in the ownership list.","required":["domain","name","entity_id","logo_url"],"properties":{"domain":{"oneOf":[{"type":"string","description":"The owner's domain.","examples":["meta.com"],"isRequired":true,"uniqueKey":"parent.oneOf.0.domain.oneOf.0","typeLabel":"string"},{"type":"null","description":"The owner's domain.","examples":["meta.com"],"isRequired":true,"uniqueKey":"parent.oneOf.0.domain.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"parent.oneOf.0.domain","typeLabel":"string | null"},"name":{"oneOf":[{"type":"string","description":"The owner's display name, from Brand.","examples":["Meta"],"isRequired":true,"uniqueKey":"parent.oneOf.0.name.oneOf.0","typeLabel":"string"},{"type":"null","description":"The owner's display name, from Brand.","examples":["Meta"],"isRequired":true,"uniqueKey":"parent.oneOf.0.name.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"parent.oneOf.0.name","typeLabel":"string | null"},"entity_id":{"oneOf":[{"type":"string","description":"The owner's Logo.dev brand id, the same id Brand uses.","examples":["brand_9r3hx5f0000g00400000000021"],"isRequired":true,"uniqueKey":"parent.oneOf.0.entity_id.oneOf.0","typeLabel":"string"},{"type":"null","description":"The owner's Logo.dev brand id, the same id Brand uses.","examples":["brand_9r3hx5f0000g00400000000021"],"isRequired":true,"uniqueKey":"parent.oneOf.0.entity_id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"parent.oneOf.0.entity_id","typeLabel":"string | null"},"logo_url":{"oneOf":[{"type":"string","description":"The Logo.dev CDN URL for the owner's logo, with no token.","examples":["https://img.logo.dev/meta.com"],"isRequired":true,"uniqueKey":"parent.oneOf.0.logo_url.oneOf.0","typeLabel":"string"},{"type":"null","description":"The Logo.dev CDN URL for the owner's logo, with no token.","examples":["https://img.logo.dev/meta.com"],"isRequired":true,"uniqueKey":"parent.oneOf.0.logo_url.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"parent.oneOf.0.logo_url","typeLabel":"string | null"}},"isRequired":true,"uniqueKey":"parent.oneOf.0","typeLabel":"object"},{"type":"null","description":"The company that owns the merchant, or `null`. It sits beside the merchant and never replaces it: a lookup for Facebook returns Facebook in `domain`, with Meta here.\n\nGroup totals on `parent.entity_id` to add up one company's brands. Facebook, Instagram, and WhatsApp become Meta. The owner's `entity_id` is the same id it has when it is the merchant, so the two join on one column.\n\n`parent` is the nearest owner that Logo.dev records, not the top of the chain. Jaguar returns JLR, and JLR returns Tata Motors. To find the top, look up each parent in turn.\n\nCoverage is thin. Logo.dev records a small, hand-verified list of ownership pairs, so most rows return `null`. A `null` means Logo.dev records no owner for this merchant. It does not mean the merchant is independent. `parent` is also `null` on a `cleaned` row, and when Brand resolves no brand for the owner's domain.\n\nA rebrand onto a new domain can come back as a new identity. `parent` joins it to the old one only when both domains are in the ownership list.","required":["domain","name","entity_id","logo_url"],"properties":{"domain":{"oneOf":[{"type":"string","description":"The owner's domain.","examples":["meta.com"]},{"type":"null","description":"The owner's domain.","examples":["meta.com"]}]},"name":{"oneOf":[{"type":"string","description":"The owner's display name, from Brand.","examples":["Meta"]},{"type":"null","description":"The owner's display name, from Brand.","examples":["Meta"]}]},"entity_id":{"oneOf":[{"type":"string","description":"The owner's Logo.dev brand id, the same id Brand uses.","examples":["brand_9r3hx5f0000g00400000000021"]},{"type":"null","description":"The owner's Logo.dev brand id, the same id Brand uses.","examples":["brand_9r3hx5f0000g00400000000021"]}]},"logo_url":{"oneOf":[{"type":"string","description":"The Logo.dev CDN URL for the owner's logo, with no token.","examples":["https://img.logo.dev/meta.com"]},{"type":"null","description":"The Logo.dev CDN URL for the owner's logo, with no token.","examples":["https://img.logo.dev/meta.com"]}]}},"isRequired":true,"uniqueKey":"parent.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"parent","typeLabel":"object | null"},"intermediary":{"oneOf":[{"type":"object","description":"The platform the purchase ran through, or `null`. The merchant stays in `domain`. A coffee paid through Square returns the coffee shop, with Square here. The platform gets the same lookup as the merchant, keyed by its own domain, so you can group totals by platform on `intermediary.entity_id`.\n\n`intermediary` is `null` in these cases:\n\n- The platform sold the item itself. A DashPass subscription is a purchase from DoorDash, so that row names DoorDash in `domain`.\n- The API identified no platform. This does not mean no platform was involved.\n\nWithout `transaction_context`, the API fills `intermediary` only when the enrichment provider answers the whole descriptor with a platform. The merchant checks then refuse the platform as the seller, and the API looks up the text after the prefix on its own. When the provider resolves the seller directly from a prefixed descriptor, `intermediary` stays `null` on a correct row. Send `transaction_context` when you need the platform named reliably.\n\nA `cleaned` row can keep a platform. This happens when the checks reject the platform's domain and the text after the prefix identifies nobody.","required":["domain","name","entity_id","logo_url"],"properties":{"domain":{"oneOf":[{"type":"string","description":"The platform's domain, or `null`.","examples":["squareup.com"],"isRequired":true,"uniqueKey":"intermediary.oneOf.0.domain.oneOf.0","typeLabel":"string"},{"type":"null","description":"The platform's domain, or `null`.","examples":["squareup.com"],"isRequired":true,"uniqueKey":"intermediary.oneOf.0.domain.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"intermediary.oneOf.0.domain","typeLabel":"string | null"},"name":{"oneOf":[{"type":"string","description":"The platform's display name, or `null`. Brand's name wins when there is one.","examples":["Square"],"isRequired":true,"uniqueKey":"intermediary.oneOf.0.name.oneOf.0","typeLabel":"string"},{"type":"null","description":"The platform's display name, or `null`. Brand's name wins when there is one.","examples":["Square"],"isRequired":true,"uniqueKey":"intermediary.oneOf.0.name.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"intermediary.oneOf.0.name","typeLabel":"string | null"},"entity_id":{"oneOf":[{"type":"string","description":"The platform's Logo.dev brand id, or `null` when Brand resolves no brand for its domain.","examples":["brand_7c1pz4d0000g00400000000052"],"isRequired":true,"uniqueKey":"intermediary.oneOf.0.entity_id.oneOf.0","typeLabel":"string"},{"type":"null","description":"The platform's Logo.dev brand id, or `null` when Brand resolves no brand for its domain.","examples":["brand_7c1pz4d0000g00400000000052"],"isRequired":true,"uniqueKey":"intermediary.oneOf.0.entity_id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"intermediary.oneOf.0.entity_id","typeLabel":"string | null"},"logo_url":{"oneOf":[{"type":"string","description":"The Logo.dev CDN URL for the platform's logo, with no token, or `null` when it has no domain.","examples":["https://img.logo.dev/squareup.com"],"isRequired":true,"uniqueKey":"intermediary.oneOf.0.logo_url.oneOf.0","typeLabel":"string"},{"type":"null","description":"The Logo.dev CDN URL for the platform's logo, with no token, or `null` when it has no domain.","examples":["https://img.logo.dev/squareup.com"],"isRequired":true,"uniqueKey":"intermediary.oneOf.0.logo_url.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"intermediary.oneOf.0.logo_url","typeLabel":"string | null"}},"isRequired":true,"uniqueKey":"intermediary.oneOf.0","typeLabel":"object"},{"type":"null","description":"The platform the purchase ran through, or `null`. The merchant stays in `domain`. A coffee paid through Square returns the coffee shop, with Square here. The platform gets the same lookup as the merchant, keyed by its own domain, so you can group totals by platform on `intermediary.entity_id`.\n\n`intermediary` is `null` in these cases:\n\n- The platform sold the item itself. A DashPass subscription is a purchase from DoorDash, so that row names DoorDash in `domain`.\n- The API identified no platform. This does not mean no platform was involved.\n\nWithout `transaction_context`, the API fills `intermediary` only when the enrichment provider answers the whole descriptor with a platform. The merchant checks then refuse the platform as the seller, and the API looks up the text after the prefix on its own. When the provider resolves the seller directly from a prefixed descriptor, `intermediary` stays `null` on a correct row. Send `transaction_context` when you need the platform named reliably.\n\nA `cleaned` row can keep a platform. This happens when the checks reject the platform's domain and the text after the prefix identifies nobody.","required":["domain","name","entity_id","logo_url"],"properties":{"domain":{"oneOf":[{"type":"string","description":"The platform's domain, or `null`.","examples":["squareup.com"]},{"type":"null","description":"The platform's domain, or `null`.","examples":["squareup.com"]}]},"name":{"oneOf":[{"type":"string","description":"The platform's display name, or `null`. Brand's name wins when there is one.","examples":["Square"]},{"type":"null","description":"The platform's display name, or `null`. Brand's name wins when there is one.","examples":["Square"]}]},"entity_id":{"oneOf":[{"type":"string","description":"The platform's Logo.dev brand id, or `null` when Brand resolves no brand for its domain.","examples":["brand_7c1pz4d0000g00400000000052"]},{"type":"null","description":"The platform's Logo.dev brand id, or `null` when Brand resolves no brand for its domain.","examples":["brand_7c1pz4d0000g00400000000052"]}]},"logo_url":{"oneOf":[{"type":"string","description":"The Logo.dev CDN URL for the platform's logo, with no token, or `null` when it has no domain.","examples":["https://img.logo.dev/squareup.com"]},{"type":"null","description":"The Logo.dev CDN URL for the platform's logo, with no token, or `null` when it has no domain.","examples":["https://img.logo.dev/squareup.com"]}]}},"isRequired":true,"uniqueKey":"intermediary.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"intermediary","typeLabel":"object | null"},"status":{"type":"string","enum":["matched","cleaned"],"description":"`matched` when the API identified a merchant domain. `cleaned` when it did not. There is no not-found result: a `cleaned` row is an answer, with a tidied display name and `null` in `domain`, `entity_id`, `logo_url`, and `parent`.\n\nA row is `cleaned` for one of two reasons:\n\n- Nothing identified the descriptor.\n- A candidate domain failed a merchant check. The checks catch repeated hostnames, directory and profile hosts, a known platform in the merchant's place, and known descriptor conflicts. They run on saved results and on new lookups.\n\nA failed check drops the domain and uses the tidied descriptor as the name. A platform that a check removes from the merchant's place still comes back in `intermediary`. An organization with no usable website also comes back `cleaned`. The API never puts a payment processor's or parent company's domain in place of the merchant's.","isRequired":true,"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"match_type":{"type":"string","enum":["enriched_context","descriptor_domain","resolved_entity","searched_name","cleaned_descriptor"],"description":"The pipeline stage that produced the row, strongest first. The set is closed.\n\n- `enriched_context`: identified from the full transaction, with entry type and account holder.\n- `descriptor_domain`: the descriptor printed the merchant's own domain.\n- `resolved_entity`: identified from the descriptor alone, with no transaction context.\n- `searched_name`: the Logo.dev brand corpus recognized the cleaned name.\n- `cleaned_descriptor`: nothing identified the merchant. `name` holds the tidied descriptor.\n\n`descriptor_domain` and `searched_name` are fallbacks. They run only when the enrichment provider identifies nobody. A descriptor that the provider recognizes never reaches them: `CHEWY.COM XXX-XXX-7111 FL` prints a domain and still returns `resolved_entity`. Both fallbacks face the same merchant checks, so a row that fails them comes back `cleaned`.\n\nRead `match_type` from the row. Do not predict it from the descriptor, because the same string can take a different path as the provider's coverage changes.","isRequired":true,"uniqueKey":"match_type","typeLabel":"enum\u003cstring>"},"confidence":{"type":"number","minimum":0,"maximum":1,"description":"A score from 0 to 1. Two inputs set it: the `match_type` that produced the row, and whether Brand resolves a brand for the same domain. A printed domain scores above a name resolved from the descriptor, and a corpus search scores below it. A failed merchant check sends the row to the floor. A `matched` row with no brand has a lower score and a `null` `entity_id`.\n\nThe same input always gets the same score, so two runs of a batch compare cleanly.\n\nLogo.dev publishes no cut-off, because the right line depends on what the row feeds. Use the score to rank and triage, for example to sort a review queue. To branch, read `entity_id`. Logo.dev can recalibrate the score without changing which rows have an id. A high score does not guarantee accuracy.","isRequired":true,"uniqueKey":"confidence","typeLabel":"number"},"entity_type":{"oneOf":[{"type":"string","enum":["person","organization",null],"description":"Present only when the request includes `transaction_context`. `person` or `organization`, as the enrichment provider classified the other party, or `null` when it classified nobody.\n\nA `null` does not mean the API found no merchant. A later stage can identify one, so a `matched` row can carry `null` here. A person always comes back as a `cleaned` row.\n\nWithout context, the API does not detect people. It treats a personal name as a merchant name, so `Jane Doe` can match an organization with a similar name.","uniqueKey":"entity_type.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["person","organization",null],"description":"Present only when the request includes `transaction_context`. `person` or `organization`, as the enrichment provider classified the other party, or `null` when it classified nobody.\n\nA `null` does not mean the API found no merchant. A later stage can identify one, so a `matched` row can carry `null` here. A person always comes back as a `cleaned` row.\n\nWithout context, the API does not detect people. It treats a personal name as a merchant name, so `Jane Doe` can match an organization with a similar name.","uniqueKey":"entity_type.oneOf.1","typeLabel":"null"}],"uniqueKey":"entity_type","typeLabel":"enum\u003cstring> | null"}},"uniqueKey":"","typeLabel":"object"},"examples":{"matched":{"title":"matched","value":{"domain":"starbucks.com","name":"Starbucks","entity_id":"brand_5k2mq8h0000g00400000000017","logo_url":"https://img.logo.dev/starbucks.com","parent":null,"intermediary":null,"status":"matched","match_type":"resolved_entity","confidence":0.8}},"matchedWithContext":{"title":"matchedWithContext","value":{"domain":"starbucks.com","name":"Starbucks","entity_type":"organization","entity_id":"brand_5k2mq8h0000g00400000000017","logo_url":"https://img.logo.dev/starbucks.com","parent":null,"intermediary":{"domain":"squareup.com","name":"Square","entity_id":"brand_7c1pz4d0000g00400000000052","logo_url":"https://img.logo.dev/squareup.com"},"status":"matched","match_type":"enriched_context","confidence":0.95}},"ownedByAParent":{"title":"ownedByAParent","value":{"domain":"facebook.com","name":"Facebook","entity_id":"brand_2n8vt6b0000g00400000000038","logo_url":"https://img.logo.dev/facebook.com","parent":{"domain":"meta.com","name":"Meta","entity_id":"brand_9r3hx5f0000g00400000000021","logo_url":"https://img.logo.dev/meta.com"},"intermediary":null,"status":"matched","match_type":"resolved_entity","confidence":0.8}},"uncorroborated":{"title":"uncorroborated","value":{"domain":"bluedoorpub.com","name":"Blue Door Pub","entity_id":null,"logo_url":"https://img.logo.dev/bluedoorpub.com","parent":null,"intermediary":null,"status":"matched","match_type":"resolved_entity","confidence":0.55}},"cleaned":{"title":"cleaned","value":{"domain":null,"name":"Jane Doe","entity_id":null,"logo_url":null,"parent":null,"intermediary":null,"status":"cleaned","match_type":"cleaned_descriptor","confidence":0.1}},"cleanedWithPlatform":{"title":"cleanedWithPlatform","value":{"domain":null,"name":"Xqzv Deli","entity_type":"organization","entity_id":null,"logo_url":null,"parent":null,"intermediary":{"domain":"squareup.com","name":"Square","entity_id":"brand_7c1pz4d0000g00400000000052","logo_url":"https://img.logo.dev/squareup.com"},"status":"cleaned","match_type":"cleaned_descriptor","confidence":0.1}},"person":{"title":"person","value":{"domain":null,"name":"Jane Doe","entity_type":"person","entity_id":null,"logo_url":null,"parent":null,"intermediary":null,"status":"cleaned","match_type":"cleaned_descriptor","confidence":0.1}}},"exampleType":"examples"}},"exampleType":"examples"},"0a5472c5-f657-44e4-9ddf-ce36dc6fd243":{"description":"The request failed validation: invalid JSON, an empty or oversized `transaction`, an unknown `country_code`, invalid or incomplete `transaction_context`, or an unknown field. It does not count against the daily allowance.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"invalidInput":{"title":"invalidInput","value":{"error":"Provide transaction (1–1,024 characters), an optional country_code, and optional transaction_context. Context requires a valid date, nonnegative amount, supported currency, and incoming/outgoing entry_type. Account-holder details require consumer/business type. Unknown fields are rejected."}},"invalidJson":{"title":"invalidJson","value":{"error":"Invalid JSON"}}},"exampleType":"examples"}},"exampleType":"examples"},"ce5bdfcb-24c5-436f-962a-2ad7bafbae3a":{"description":"The `Authorization` header is missing, or the beta key is malformed, unknown, or replaced by a newer key.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"malformedKey":{"title":"malformedKey","value":{"error":"Invalid transaction beta key"}},"unknownKey":{"title":"unknownKey","value":{"error":"Unauthorized"}}},"exampleType":"examples"}},"exampleType":"examples"},"cbf1b3e4-5699-4399-883d-a04c9f4f63a1":{"description":"The beta is not on for this account. Access belongs to a Logo.dev account, so this applies to everyone on it.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"noAccess":{"title":"noAccess","value":{"error":"Transaction beta access is not enabled"}}},"exampleType":"examples"}},"exampleType":"examples"},"e9ae3b71-d8fc-4b30-9b29-dc2bbed078e4":{"description":"Another request is already looking up the same transaction. Wait for `Retry-After` and send the request again to read the saved result. The original request, the `409`, and the retry all count against the daily allowance.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"inProgress":{"title":"inProgress","value":{"error":"This transaction is already being looked up. Retry shortly."}}},"exampleType":"examples"}},"headers":{"X-RateLimit-Limit":{"description":"Your daily request limit. See [daily allowance](/transaction/introduction#daily-allowance).","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining after this call.","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Next midnight UTC as Unix seconds.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait before you retry. Always `2`.","schema":{"type":"integer"}}},"exampleType":"examples"},"dfb5eb54-c450-4365-9ece-45dd794df241":{"description":"The request body is larger than 8,192 bytes.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"tooLarge":{"title":"tooLarge","value":{"error":"Request body too large"}}},"exampleType":"examples"}},"exampleType":"examples"},"2555f7a6-5280-4942-841b-b70345c5fc14":{"description":"The `Content-Type` is not `application/json`.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"wrongType":{"title":"wrongType","value":{"error":"Use Content-Type: application/json"}}},"exampleType":"examples"}},"exampleType":"examples"},"2f59609f-d226-42fb-b8c0-d8fed0196659":{"description":"A rate limit applies. Wait for `Retry-After` before you send the request again.\n\n- The daily allowance is spent. The response has the usage headers, and `Retry-After` counts the seconds to the next midnight UTC.\n- More than 60 requests in one minute. The response has `Retry-After` and no usage headers.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"dailyLimit":{"title":"dailyLimit","value":{"error":"Daily limit of beta requests reached"}},"burstLimit":{"title":"burstLimit","value":{"error":"Too many requests"}}},"exampleType":"examples"}},"headers":{"X-RateLimit-Limit":{"description":"Your daily request limit. See [daily allowance](/transaction/introduction#daily-allowance).","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining after this call.","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Next midnight UTC as Unix seconds.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait before you retry.","schema":{"type":"integer"}}},"exampleType":"examples"},"fdad868e-8fdb-4a3b-b7a4-9eb2f5033595":{"description":"Enrichment, storage, or the access check is unavailable. The API returns this error, not a `cleaned` row. A failed lookup still counts against the daily allowance.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"unavailable":{"title":"unavailable","value":{"error":"Transaction is temporarily unavailable"}}},"exampleType":"examples"}},"headers":{"X-RateLimit-Limit":{"description":"Your daily request limit. See [daily allowance](/transaction/introduction#daily-allowance).","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining after this call.","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Next midnight UTC as Unix seconds.","schema":{"type":"integer"}}},"exampleType":"examples"}},"security":{"e55aa0b9-b90e-4526-88f4-a19347fc971a":{"transactionBetaKey":{"type":"http","scheme":"bearer","bearerFormat":"tx_beta_…","description":"Transaction-only beta key, issued with your beta access and always visible in the Transaction Playground. Existing Logo.dev secret keys do not authenticate this beta.","scopes":[],"schemeName":"transactionBetaKey"}}},"servers":{"023447de-89e3-4932-8bc4-877389c27e9b":{"url":"https://www.logo.dev/api","description":"Transaction beta on Vercel"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"tx_beta_…","description":"Transaction-only beta key, issued with your beta access and always visible in the Transaction Playground. Existing Logo.dev secret keys do not authenticate this beta.","scopes":[],"schemeName":"transactionBetaKey"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Transaction-only beta key, issued with your beta access and always visible in the Transaction Playground. Existing Logo.dev secret keys do not authenticate this beta.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"transactionBetaKey","name":"Authorization"}],"title":"transactionBetaKey"}]},"originalFileLocation":"openapi.json"},"subdomain":"simplecasual","siteName":"Logo.dev","title":"Identify a merchant - Logo.dev","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-12T00:24:22.084Z","originalFileLocation":"api-reference/transaction-enrichment-api/identify-a-merchant.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Identify a merchant domain and brand record. Private beta with a daily allowance.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Logo.dev\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/simplecasual/ffjd0p23NsA8r6u7/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/docs/mintlify-assets/_mintlify/favicons/simplecasual/ffjd0p23NsA8r6u7/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/simplecasual/ffjd0p23NsA8r6u7/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/simplecasual/ffjd0p23NsA8r6u7/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/simplecasual/ffjd0p23NsA8r6u7/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/simplecasual/ffjd0p23NsA8r6u7/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/simplecasual/ffjd0p23NsA8r6u7/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/simplecasual/ffjd0p23NsA8r6u7/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/simplecasual/ffjd0p23NsA8r6u7/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Identify a merchant - Logo.dev\">\u003cmeta data-mint-head property=\"og:description\" content=\"Identify a merchant domain and brand record. Private beta with a daily allowance.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Logo.dev Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://www.logo.dev/docs/api-reference/transaction-enrichment-api/identify-a-merchant\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://simplecasual.mintlify.site/docs/_mintlify/api/og/v2?division=Transaction\u0026amp;title=Identify+a+merchant\u0026amp;description=Identify+a+merchant+domain+and+brand+record.+Private+beta+with+a+daily+allowance.\u0026amp;theme=3b0378da97241ff015d8a070\u0026amp;signature=e5f905240860fafb552dbdeca1ccf71365eb2170e7473bfcdee39f6155aea8c4\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Identify a merchant - Logo.dev\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Identify a merchant domain and brand record. Private beta with a daily allowance.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://simplecasual.mintlify.site/docs/_mintlify/api/og/v2?division=Transaction\u0026amp;title=Identify+a+merchant\u0026amp;description=Identify+a+merchant+domain+and+brand+record.+Private+beta+with+a+daily+allowance.\u0026amp;theme=3b0378da97241ff015d8a070\u0026amp;signature=e5f905240860fafb552dbdeca1ccf71365eb2170e7473bfcdee39f6155aea8c4\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/docs/mintlify-assets/_mintlify/favicons/simplecasual/ffjd0p23NsA8r6u7/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Logo.dev\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#212121\">\u003clink data-mint-head rel=\"canonical\" href=\"https://www.logo.dev/docs/api-reference/transaction-enrichment-api/identify-a-merchant\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/api-reference/transaction-enrichment-api/identify-a-merchant.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://www.logo.dev/#organization\",\"name\":\"Logo.dev\",\"url\":\"https://www.logo.dev\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/simplecasual/zsNskQWqsXEQO5xC/logo/light.svg?fit=max\u0026auto=format\u0026n=zsNskQWqsXEQO5xC\u0026q=85\u0026s=61958aab2347b4a683f4214e6d1e9bb9\"}},{\"@type\":\"WebSite\",\"@id\":\"https://www.logo.dev/docs#website\",\"name\":\"Logo.dev\",\"url\":\"https://www.logo.dev/docs\",\"publisher\":{\"@id\":\"https://www.logo.dev/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://www.logo.dev/docs/api-reference/transaction-enrichment-api/identify-a-merchant#webpage\",\"url\":\"https://www.logo.dev/docs/api-reference/transaction-enrichment-api/identify-a-merchant\",\"name\":\"Identify a merchant\",\"description\":\"Identify a merchant domain and brand record. Private beta with a daily allowance.\",\"dateModified\":\"2026-11-12T00:24:22.084Z\",\"isPartOf\":{\"@id\":\"https://www.logo.dev/docs#website\"},\"breadcrumb\":{\"@id\":\"https://www.logo.dev/docs/api-reference/transaction-enrichment-api/identify-a-merchant#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://www.logo.dev/docs/api-reference/transaction-enrichment-api/identify-a-merchant#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"API\",\"item\":\"https://www.logo.dev/docs/api-reference/brands/look-up-a-brand\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Identify a merchant\",\"item\":\"https://www.logo.dev/docs/api-reference/transaction-enrichment-api/identify-a-merchant\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://www.logo.dev/docs/api-reference/transaction-enrichment-api/identify-a-merchant#apireference\",\"headline\":\"Identify a merchant\",\"name\":\"Identify a merchant\",\"description\":\"Identify a merchant domain and brand record. Private beta with a daily allowance.\",\"url\":\"https://www.logo.dev/docs/api-reference/transaction-enrichment-api/identify-a-merchant\",\"mainEntityOfPage\":{\"@id\":\"https://www.logo.dev/docs/api-reference/transaction-enrichment-api/identify-a-merchant#webpage\"},\"dateModified\":\"2026-11-12T00:24:22.084Z\",\"publisher\":{\"@id\":\"https://www.logo.dev/#organization\"},\"isPartOf\":{\"@id\":\"https://www.logo.dev/docs#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Logo.dev\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Logo.dev\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/docs/api-reference/transaction-enrichment-api/identify-a-merchant.md","siteName":"Logo.dev","nav":{"global":null,"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/introduction"}]},{"tab":"API Reference","groups":[{"group":"CDN","pages":[{"title":"Get a logo","deprecated":null,"version":null,"openapi":"/openapi.json get /{domain}","href":"/api-reference/logo-cdn/get-a-logo"}]},{"group":"API","pages":[{"group":"Brand","expanded":true,"pages":[{"title":"Look up a brand","deprecated":null,"version":null,"tag":"5 credits","openapi":"/openapi.json get /v2/brands","href":"/api-reference/brands/look-up-a-brand"},{"title":"Get a brand by id","deprecated":null,"version":null,"tag":"5 credits","openapi":"/openapi.json get /v2/brands/{id}","href":"/api-reference/brands/get-a-brand-by-id"}]},{"group":"Logo","expanded":true,"pages":[{"title":"Get a logo","deprecated":null,"version":null,"tag":"2 credits","openapi":"/openapi.json get /v2/brands/logo","href":"/api-reference/logos/get-a-logo"},{"title":"Get a brandmark","deprecated":null,"version":null,"tag":"3 credits","openapi":"/openapi.json get /v2/brands/brandmark","href":"/api-reference/logos/get-a-brandmark"}]},{"group":"Search","expanded":true,"pages":[{"title":"Search brands","deprecated":null,"version":null,"tag":"1 credit / 1,000 searches","openapi":"/openapi.json get /v2/search","href":"/api-reference/search/search-brands"}]},{"group":"Account","expanded":true,"pages":[{"title":"Get your account","deprecated":null,"version":null,"openapi":"/openapi.json get /v2/account","href":"/api-reference/account/get-your-account"}]},{"group":"Webhooks","pages":[{"group":"Subscriptions","pages":[{"title":"Get a brand subscription","deprecated":null,"version":null,"openapi":"/openapi.json get /v2/brands/{id}/subscription","href":"/api-reference/subscriptions/get-a-brand-subscription"},{"title":"Subscribe to a brand","deprecated":null,"version":null,"openapi":"/openapi.json put /v2/brands/{id}/subscription","href":"/api-reference/subscriptions/subscribe-to-a-brand"},{"title":"Unsubscribe from a brand","deprecated":null,"version":null,"openapi":"/openapi.json delete /v2/brands/{id}/subscription","href":"/api-reference/subscriptions/unsubscribe-from-a-brand"}]},{"group":"Endpoints","pages":[{"title":"Create a webhook endpoint","deprecated":null,"version":null,"openapi":"/openapi.json post /v2/webhook_endpoints","href":"/api-reference/webhook-endpoints/create-a-webhook-endpoint"},{"title":"List webhook endpoints","deprecated":null,"version":null,"openapi":"/openapi.json get /v2/webhook_endpoints","href":"/api-reference/webhook-endpoints/list-webhook-endpoints"},{"title":"Get a webhook endpoint","deprecated":null,"version":null,"openapi":"/openapi.json get /v2/webhook_endpoints/{id}","href":"/api-reference/webhook-endpoints/get-a-webhook-endpoint"},{"title":"Update a webhook endpoint","deprecated":null,"version":null,"openapi":"/openapi.json patch /v2/webhook_endpoints/{id}","href":"/api-reference/webhook-endpoints/update-a-webhook-endpoint"},{"title":"Delete a webhook endpoint","deprecated":null,"version":null,"openapi":"/openapi.json delete /v2/webhook_endpoints/{id}","href":"/api-reference/webhook-endpoints/delete-a-webhook-endpoint"},{"title":"Get a webhook signing secret","deprecated":null,"version":null,"openapi":"/openapi.json get /v2/webhook_endpoints/{id}/secret","href":"/api-reference/webhook-endpoints/get-a-webhook-signing-secret"},{"title":"Rotate a webhook signing secret","deprecated":null,"version":null,"openapi":"/openapi.json post /v2/webhook_endpoints/{id}/secret","href":"/api-reference/webhook-endpoints/rotate-a-webhook-signing-secret"}]}]},{"group":"Flags","expanded":true,"pages":[{"title":"Flag domains for review","description":"Submit domains with incorrect or outdated brand data for review.","deprecated":null,"version":null,"tag":"Pro or Enterprise","openapi":"/openapi.json post /v2/flag","href":"/api-reference/flags/flag-domains-for-review"}]},{"group":"Transaction","tag":"Beta","pages":[{"title":"Identify a merchant","deprecated":null,"version":null,"openapi":"/openapi.json post /transaction","href":"/api-reference/transaction-enrichment-api/identify-a-merchant"}]}]}]},{"tab":"MCP","pages":[{"title":"MCP","href":"/mcp/introduction"}]},{"tab":"Use cases","pages":[{"title":"Use cases","href":"/use-cases/logo-from-domain"}]},{"tab":"Changelog","pages":[{"title":"Changelog","href":"/changelog"}]}]},"basePath":"","title":"Identify a merchant - Logo.dev","buildId":"dpl_Aw98ji4XvBsgtZwL1VrkUF9ehFqz","deploymentId":"dpl_Aw98ji4XvBsgtZwL1VrkUF9ehFqz","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CQGbdtm4.js","utils-D88A1f-Z.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-ChqWdz1A.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-yBrxdh_6.js","snippetPresets-BgqDrFJC.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-Duxc2rZw.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-C7jidOil.js","shallow-xkjpHm-U.js","getApiPlaygroundDisplay-fE3rVpvL.js","CodeSnippet-LgxljKed.js","CodeSnippets-D-pXWDHq.js","Page-C2-BijcO.js","getPastedJson-CLRcu-uo.js","icon-Cxirpjgo.js","MethodPill-D49eqY5e.js","DuplicateIcon-CivCz5Rp.js","createIcon-D71qL3f5.js","DynamicMarkdown-BcGRTrw6.js","SectionHeading-DzaqmmSD.js","axios-vUo_bRtp.js","Markdown-CZqUYmMp.js","clsx-B6IZIRsp.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-B0ZV6X5T.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-MqLyPtsW.js"]}