Skip to main content
POST
Get Brand

Request contract

  • Method and path: POST /apis/v1/context-dev/get-brand
  • Availability: enabled
  • Request URL template: https://api.aisa.one/apis/v1/context-dev/get-brand
  • Runtime facts: 3068b7678674e2539daed47d533143c7d5bf21072a81e6aac34d7bd71ed57eb3
Complete OpenAPI definition Effective request and pricing declaration (including authentication and referenced schemas):

Cost and request rules

Usage-based billing; Default request estimate: $0.0253 USD (not a fixed price). Declared unit rate: $0.000001 USD per provider_credit. Account-specific pricing and final settlement may differ. Published reference values are not an account-specific quote or a settled charge. For endpoints supporting X-AISA-Cost-Mode: quote, obtain a free quote for your exact request before execution; reconcile the settled cost with response metadata and Usage Logs. USD amounts use 1,000,000 integer micro-USD per dollar.
  • Default request reference estimate (USD): 0.0253
  • Declared unit rate (USD): 1e-06
  • Billing unit: provider_credit
  • Cost contract: response_units
  • Published reference multiplier: 1.0
  • Declared maximum count/units: 10000000
  • Settlement evidence source: response_body

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
identifier
string
required

Domain, company name, work email, ticker, full direct URL, or transaction descriptor matching lookup_type.

Minimum string length: 1
Example:

"stripe.com"

lookup_type
enum<string>
required

Kind of identifier supplied in identifier. Selects domain, company name, work email, stock ticker, direct URL, or transaction lookup.

Available options:
domain,
name,
email,
ticker,
direct_url,
transaction
city
string

City hint for transaction lookup.

tags
string[]

Up to 20 usage-tracking tags, each 1-50 characters.

Maximum array length: 20
phone

Phone-number hint for transaction lookup, as text or a number.

country
string

Country hint for name or transaction lookup.

max_speed
boolean
default:false

Prefer faster but potentially less comprehensive retrieval.

max_age_ms
integer

Maximum cached brand-data age in milliseconds. The provider clamps values to 1 day through 1 year.

Required range: x >= 0
timeout_ms
integer

Provider timeout in milliseconds, from 1000 through 300000.

Required range: 1000 <= x <= 300000
force_language
enum<string>

Provider-supported output language name, such as english or french.

Available options:
afrikaans,
albanian,
amharic,
arabic,
armenian,
assamese,
aymara,
azeri,
basque,
belarusian,
bengali,
bosnian,
bulgarian,
burmese,
cantonese,
catalan,
cebuano,
chinese,
corsican,
croatian,
czech,
danish,
dutch,
english,
esperanto,
estonian,
farsi,
fijian,
finnish,
french,
galician,
georgian,
german,
greek,
guarani,
gujarati,
haitian-creole,
hausa,
hawaiian,
hebrew,
hindi,
hmong,
hungarian,
icelandic,
igbo,
indonesian,
irish,
italian,
japanese,
javanese,
kannada,
kazakh,
khmer,
kinyarwanda,
korean,
kurdish,
kyrgyz,
lao,
latin,
latvian,
lingala,
lithuanian,
luxembourgish,
macedonian,
malagasy,
malay,
malayalam,
maltese,
maori,
marathi,
mongolian,
nepali,
norwegian,
odia,
oromo,
pashto,
pidgin,
polish,
portuguese,
punjabi,
quechua,
romanian,
russian,
samoan,
scottish-gaelic,
serbian,
sesotho,
shona,
sindhi,
sinhala,
slovak,
slovene,
somali,
spanish,
sundanese,
swahili,
swedish,
tagalog,
tajik,
tamil,
tatar,
telugu,
thai,
tibetan,
tigrinya,
tongan,
tswana,
turkish,
turkmen,
ukrainian,
urdu,
uyghur,
uzbek,
vietnamese,
welsh,
wolof,
xhosa,
yiddish,
yoruba,
zulu
ticker_exchange
string

Stock exchange identifier for ticker lookup; omit to let Context.dev default to NASDAQ.

Minimum string length: 1
high_confidence_only
boolean
default:false

For transaction lookup, require additional match verification.

merchant_category_code

Merchant Category Code hint for transaction lookup, as text or a number.

Response

Tool result data

brand
object
required
key_metadata
object