Skip to main content
POST
/
transaction
Identify a merchant
curl --request POST \
  --url https://api.logo.dev/transaction \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "transaction": "SQ *BLUE BOTTLE 1523 OAKLAND CA",
  "country_code": "US"
}
'
{
  "name": "Blue Bottle Coffee",
  "domain": "bluebottlecoffee.com",
  "logo_url": "https://img.logo.dev/bluebottlecoffee.com?token=LOGO_DEV_PUBLISHABLE_KEY"
}

Authorizations

​
Authorization
string
header
required

Secret key (sk_...). Server-side only. Used for the REST APIs.

Body

application/json
​
transaction
string
required

The raw card-transaction descriptor.

Example:

"SQ *BLUE BOTTLE 1523 OAKLAND CA"

​
country_code
string

Optional ISO 3166-1 alpha-2 country code where the transaction took place.

Example:

"US"

Response

The matched merchant.

A brand search match.

​
name
string
required

Brand name.

​
domain
string
required

Brand domain.

​
logo_url
string<uri>
required

Image CDN URL for the brand's logo.