Skip to main content
POST
brand.from-transaction

Authorizations

Authorization
string
header
required

API key: sk_live_…

Headers

Idempotency-Key
string

Optional. A retry with the same key returns the stored result.

Maximum string length: 255
Pramaan-Max-Price-Micro
string

Optional. The most this request may be priced at, in micro-USD (a whole number above 0). It replaces the capability's own price ceiling for this request, lower or higher. Sources that could cost more are left out; when none is left the answer is 400 with the lowest limit that would work.

Pattern: ^[1-9]\d{0,14}$

Body

application/json
descriptor
string
required

The merchant text as the bank or card shows it, e.g. "EXAMPLE *STORE 0042".

Required string length: 3 - 500
country
string

Two-letter country of the merchant, e.g. "US".

Required string length: 1 - 2
Pattern: ^[a-z]{2}$
city
string

City of the merchant.

Required string length: 1 - 128
mcc

Merchant category code: four digits, as text or a number.

phone
string

Merchant phone number.

Required string length: 1 - 64
highConfidenceOnly
boolean

When true, answer not found rather than give a less certain match.

Response

The result

name
string
required

Company name.

domain
string

Website domain, e.g. example.com.

description
string

Short description of what the company does.

industry
string

Industry or sector.

employeeCount
number

Number of employees.

foundedYear
number

Year the company was founded.

location
object
websiteUrl
string

Company website URL.

linkedinUrl
string

Company LinkedIn page URL.

logoUrl
string

Logo image URL.