> ## Documentation Index
> Fetch the complete documentation index at: https://deepline.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Context.dev: Contextdev Get Brand Transaction Identifier

> Identify the company behind a card transaction from its title, with optional merchant code, city, and phone. Includes SDK V2 examples, schemas, and cost.

Identify the company behind a card transaction from its title, with optional merchant code, city, and phone.

> [!NOTE]
>
> Tool ID: `contextdev_get_brand_transaction_identifier`

## Run this action

Use the TypeScript SDK for one call. Use `ctx.tools.execute(...)` inside a Play for durable calls, scheduled calls, or CSV processing.

```ts theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
import { Deepline } from 'deepline';

const deepline = await Deepline.connect();
const result = await deepline.tools.execute(
  'contextdev_get_brand_transaction_identifier',
  {
    "transaction_info": "example"
  },
);

console.log(result.toolResponse.raw);
```

### CLI

```bash theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
deepline tools execute contextdev_get_brand_transaction_identifier --input '{
  "transaction_info": "example"
}' --json
```

## Example response

The SDK returns this shape at `result.toolResponse.raw`. The example values illustrate the response.

```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
{
  "data": {
    "status": "example",
    "brand": {
      "domain": "example.com",
      "title": "VP of Engineering",
      "description": "Example description"
    },
    "code": 123
  }
}
```

Use `deepline describe contextdev_get_brand_transaction_identifier --json` for the latest machine-readable contract.

## Input reference

Endpoint specially designed for platforms that want to identify transaction data by the transaction title.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `payload.transaction_info` | `string` | Yes | — | Transaction information to identify the brand Minimum length: 3. Maximum length: 500. |
| `payload.force_language` | `"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"` | No | — | Language to force for the retrieved brand data. Allowed: `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`, See the live schema for the complete constraint. |
| `payload.maxSpeed` | `boolean` | No | `false` | Optional parameter to optimize the API call for maximum speed. |
| `payload.timeoutMS` | `integer` | No | — | Optional timeout in milliseconds for the request. If the request takes longer than this value, it will be aborted with a 408 status code. Maximum allowed value is 300000ms (5 minutes). Minimum: 1000. Maximum: 300000. |
| `payload.country_gl` | `"af" \| "al" \| "dz" \| "as" \| "ad" \| "ao" \| "ai" \| "aq" \| "ag" \| "ar" \| "am" \| "aw" \| "au" \| "at" \| "az" \| "bs" \| "bh" \| "bd" \| "bb" \| "by" \| "be" \| "bz" \| "bj" \| "bm" \| "bt" \| "bo" \| "ba" \| "bw" \| "bv" \| "br" \| "io" \| "bn" \| "bg" \| "bf" \| "bi" \| "kh" \| "cm" \| "ca" \| "cv" \| "ky" \| "cf" \| "td" \| "cl" \| "cn" \| "cx" \| "cc" \| "co" \| "km" \| "cg" \| "cd" \| "ck" \| "cr" \| "ci" \| "hr" \| "cu" \| "cy" \| "cz" \| "dk" \| "dj" \| "dm" \| "do" \| "ec" \| "eg" \| "sv" \| "gq" \| "er" \| "ee" \| "et" \| "fk" \| "fo" \| "fj" \| "fi" \| "fr" \| "gf" \| "pf" \| "tf" \| "ga" \| "gm" \| "ge" \| "de" \| "gh" \| "gi" \| "gr" \| "gl" \| "gd" \| "gp" \| "gu" \| "gt" \| "gn" \| "gw" \| "gy" \| "ht" \| "hm" \| "va" \| "hn" \| "hk" \| "hu" \| "is" \| "in" \| "id" \| "ir" \| "iq" \| "ie" \| "il" \| "it" \| "jm" \| "jp" \| "jo" \| "kz" \| "ke" \| "ki" \| "kp" \| "kr" \| "kw" \| "kg" \| "la" \| "lv" \| "lb" \| "ls" \| "lr" \| "ly" \| "li" \| "lt" \| "lu" \| "mo" \| "mk" \| "mg" \| "mw" \| "my" \| "mv" \| "ml" \| "mt" \| "mh" \| "mq" \| "mr" \| "mu" \| "yt" \| "mx" \| "fm" \| "md" \| "mc" \| "mn" \| "ms" \| "ma" \| "mz" \| "mm" \| "na" \| "nr" \| "np" \| "nl" \| "an" \| "nc" \| "nz" \| "ni" \| "ne" \| "ng" \| "nu" \| "nf" \| "mp" \| "no" \| "om" \| "pk" \| "pw" \| "ps" \| "pa" \| "pg" \| "py" \| "pe" \| "ph" \| "pn" \| "pl" \| "pt" \| "pr" \| "qa" \| "re" \| "ro" \| "ru" \| "rw" \| "sh" \| "kn" \| "lc" \| "pm" \| "vc" \| "ws" \| "sm" \| "st" \| "sa" \| "sn" \| "rs" \| "sc" \| "sl" \| "sg" \| "sk" \| "si" \| "sb" \| "so" \| "za" \| "gs" \| "es" \| "lk" \| "sd" \| "sr" \| "sj" \| "sz" \| "se" \| "ch" \| "sy" \| "tw" \| "tj" \| "tz" \| "th" \| "tl" \| "tg" \| "tk" \| "to" \| "tt" \| "tn" \| "tr" \| "tm" \| "tc" \| "tv" \| "ug" \| "ua" \| "ae" \| "gb" \| "us" \| "um" \| "uy" \| "uz" \| "vu" \| "ve" \| "vn" \| "vg" \| "vi" \| "wf" \| "eh" \| "ye" \| "zm" \| "zw"` | No | — | Two-letter ISO 3166-1 alpha-2 country code (GL parameter) used to localize search. Allowed: `af`, `al`, `dz`, `as`, `ad`, `ao`, `ai`, `aq`, `ag`, `ar`, `am`, `aw`, `au`, `at`, `az`, `bs`, `bh`, `bd`, `bb`, `by`, `be`, `bz`, `bj`, `bm`, `bt`, `bo`, `ba`, `bw`, `bv`, `br`, `io`, `bn`, `bg`, `bf`, `bi`, `kh`, `cm`, `ca`, `cv`, `ky`, `cf`, `td`, `cl`, `cn`, `cx`, `cc`, `co`, `km`, `cg`, `cd`, `ck`, `cr`, `ci`, `hr`, `cu`, `cy`, `cz`, `dk`, `dj`, `dm`, `do`, `ec`, `eg`, `sv`, `gq`, `er`, `ee`, `et`, See the live schema for the complete constraint. |
| `payload.city` | `string` | No | — | Optional city name to prioritize when searching for the brand. |
| `payload.mcc` | `string \| number` | No | — | Optional Merchant Category Code (MCC) to help identify the business category/industry. |
| `payload.phone` | `string \| number` | No | — | Optional phone number from the transaction to help verify brand match. |
| `payload.high_confidence_only` | `boolean` | No | `false` | When set to true, the API will perform an additional verification steps to ensure the identified brand matches the transaction with high confidence. |
| `payload.tags` | `array` | No | — | Optional comma-separated caller-defined tags for tracking this request. Tags are recorded on the request's usage log and can be used to filter usage on the dashboard usage page. Up to 20 tags, each 1-50 characters. Maximum items: 20. |

<details>
  <summary>Show raw input schema</summary>

  ### Input JSON Schema

  ```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
  {
    "type": "object",
    "description": "Endpoint specially designed for platforms that want to identify transaction data by the transaction title.",
    "properties": {
      "transaction_info": {
        "type": "string",
        "description": "Transaction information to identify the brand",
        "minLength": 3,
        "maxLength": 500
      },
      "force_language": {
        "type": [
          "string",
          "null"
        ],
        "description": "Language to force for the retrieved brand data.",
        "enum": [
          "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"
        ]
      },
      "maxSpeed": {
        "type": "boolean",
        "description": "Optional parameter to optimize the API call for maximum speed.",
        "default": false
      },
      "timeoutMS": {
        "type": "integer",
        "description": "Optional timeout in milliseconds for the request. If the request takes longer than this value, it will be aborted with a 408 status code. Maximum allowed value is 300000ms (5 minutes).",
        "minimum": 1000,
        "maximum": 300000
      },
      "country_gl": {
        "type": "string",
        "description": "Two-letter ISO 3166-1 alpha-2 country code (GL parameter) used to localize search.",
        "enum": [
          "af",
          "al",
          "dz",
          "as",
          "ad",
          "ao",
          "ai",
          "aq",
          "ag",
          "ar",
          "am",
          "aw",
          "au",
          "at",
          "az",
          "bs",
          "bh",
          "bd",
          "bb",
          "by",
          "be",
          "bz",
          "bj",
          "bm",
          "bt",
          "bo",
          "ba",
          "bw",
          "bv",
          "br",
          "io",
          "bn",
          "bg",
          "bf",
          "bi",
          "kh",
          "cm",
          "ca",
          "cv",
          "ky",
          "cf",
          "td",
          "cl",
          "cn",
          "cx",
          "cc",
          "co",
          "km",
          "cg",
          "cd",
          "ck",
          "cr",
          "ci",
          "hr",
          "cu",
          "cy",
          "cz",
          "dk",
          "dj",
          "dm",
          "do",
          "ec",
          "eg",
          "sv",
          "gq",
          "er",
          "ee",
          "et",
          "fk",
          "fo",
          "fj",
          "fi",
          "fr",
          "gf",
          "pf",
          "tf",
          "ga",
          "gm",
          "ge",
          "de",
          "gh",
          "gi",
          "gr",
          "gl",
          "gd",
          "gp",
          "gu",
          "gt",
          "gn",
          "gw",
          "gy",
          "ht",
          "hm",
          "va",
          "hn",
          "hk",
          "hu",
          "is",
          "in",
          "id",
          "ir",
          "iq",
          "ie",
          "il",
          "it",
          "jm",
          "jp",
          "jo",
          "kz",
          "ke",
          "ki",
          "kp",
          "kr",
          "kw",
          "kg",
          "la",
          "lv",
          "lb",
          "ls",
          "lr",
          "ly",
          "li",
          "lt",
          "lu",
          "mo",
          "mk",
          "mg",
          "mw",
          "my",
          "mv",
          "ml",
          "mt",
          "mh",
          "mq",
          "mr",
          "mu",
          "yt",
          "mx",
          "fm",
          "md",
          "mc",
          "mn",
          "ms",
          "ma",
          "mz",
          "mm",
          "na",
          "nr",
          "np",
          "nl",
          "an",
          "nc",
          "nz",
          "ni",
          "ne",
          "ng",
          "nu",
          "nf",
          "mp",
          "no",
          "om",
          "pk",
          "pw",
          "ps",
          "pa",
          "pg",
          "py",
          "pe",
          "ph",
          "pn",
          "pl",
          "pt",
          "pr",
          "qa",
          "re",
          "ro",
          "ru",
          "rw",
          "sh",
          "kn",
          "lc",
          "pm",
          "vc",
          "ws",
          "sm",
          "st",
          "sa",
          "sn",
          "rs",
          "sc",
          "sl",
          "sg",
          "sk",
          "si",
          "sb",
          "so",
          "za",
          "gs",
          "es",
          "lk",
          "sd",
          "sr",
          "sj",
          "sz",
          "se",
          "ch",
          "sy",
          "tw",
          "tj",
          "tz",
          "th",
          "tl",
          "tg",
          "tk",
          "to",
          "tt",
          "tn",
          "tr",
          "tm",
          "tc",
          "tv",
          "ug",
          "ua",
          "ae",
          "gb",
          "us",
          "um",
          "uy",
          "uz",
          "vu",
          "ve",
          "vn",
          "vg",
          "vi",
          "wf",
          "eh",
          "ye",
          "zm",
          "zw"
        ]
      },
      "city": {
        "type": "string",
        "description": "Optional city name to prioritize when searching for the brand."
      },
      "mcc": {
        "description": "Optional Merchant Category Code (MCC) to help identify the business category/industry.",
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "number"
          }
        ]
      },
      "phone": {
        "description": "Optional phone number from the transaction to help verify brand match.",
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "number"
          }
        ]
      },
      "high_confidence_only": {
        "type": "boolean",
        "description": "When set to true, the API will perform an additional verification steps to ensure the identified brand matches the transaction with high confidence.",
        "default": false
      },
      "tags": {
        "type": "array",
        "description": "Optional comma-separated caller-defined tags for tracking this request. Tags are recorded on the request's usage log and can be used to filter usage on the dashboard usage page. Up to 20 tags, each 1-50 characters.",
        "maxItems": 20,
        "items": {
          "type": "string",
          "minLength": 1,
          "maxLength": 50
        }
      }
    },
    "required": [
      "transaction_info"
    ],
    "additionalProperties": false
  }
  ```
</details>

## Output reference

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `result.data` | `object` | Yes | — | — |
| `result.data.status` | `string` | No | — | — |
| `result.data.brand` | `object` | No | — | — |
| `result.data.brand.domain` | `string` | No | — | — |
| `result.data.brand.title` | `string` | No | — | — |
| `result.data.brand.description` | `string` | No | — | — |
| `result.data.brand.slogan` | `string` | No | — | — |
| `result.data.brand.colors` | `array` | No | — | — |
| `result.data.brand.colors[].hex` | `string` | No | — | — |
| `result.data.brand.colors[].name` | `string` | No | — | — |
| `result.data.brand.logos` | `array` | No | — | — |
| `result.data.brand.logos[].url` | `string` | No | — | — |
| `result.data.brand.logos[].mode` | `"light" \| "dark" \| "has_opaque_background"` | No | — | Allowed: `light`, `dark`, `has_opaque_background`. |
| `result.data.brand.logos[].colors` | `array` | No | — | — |
| `result.data.brand.logos[].colors[].hex` | `string` | No | — | — |
| `result.data.brand.logos[].colors[].name` | `string` | No | — | — |
| `result.data.brand.logos[].resolution` | `object` | No | — | — |
| `result.data.brand.logos[].resolution.width` | `integer` | No | — | — |
| `result.data.brand.logos[].resolution.height` | `integer` | No | — | — |
| `result.data.brand.logos[].resolution.aspect_ratio` | `number` | No | — | — |
| `result.data.brand.logos[].type` | `"icon" \| "logo"` | No | — | Allowed: `icon`, `logo`. |
| `result.data.brand.backdrops` | `array` | No | — | — |
| `result.data.brand.backdrops[].url` | `string` | No | — | — |
| `result.data.brand.backdrops[].colors` | `array` | No | — | — |
| `result.data.brand.backdrops[].colors[].hex` | `string` | No | — | — |
| `result.data.brand.backdrops[].colors[].name` | `string` | No | — | — |
| `result.data.brand.backdrops[].resolution` | `object` | No | — | — |
| `result.data.brand.backdrops[].resolution.width` | `integer` | No | — | — |
| `result.data.brand.backdrops[].resolution.height` | `integer` | No | — | — |
| `result.data.brand.backdrops[].resolution.aspect_ratio` | `number` | No | — | — |
| `result.data.brand.socials` | `array` | No | — | — |
| `result.data.brand.socials[].type` | `"x" \| "facebook" \| "instagram" \| "linkedin" \| "youtube" \| "pinterest" \| "tiktok" \| "dribbble" \| "github" \| "behance" \| "snapchat" \| "whatsapp" \| "telegram" \| "line" \| "discord" \| "twitch" \| "vimeo" \| "imdb" \| "tumblr" \| "flickr" \| "giphy" \| "medium" \| "spotify" \| "soundcloud" \| "tripadvisor" \| "yelp" \| "producthunt" \| "reddit" \| "crunchbase" \| "appstore" \| "playstore"` | No | — | Allowed: `x`, `facebook`, `instagram`, `linkedin`, `youtube`, `pinterest`, `tiktok`, `dribbble`, `github`, `behance`, `snapchat`, `whatsapp`, `telegram`, `line`, `discord`, `twitch`, `vimeo`, `imdb`, `tumblr`, `flickr`, `giphy`, `medium`, `spotify`, `soundcloud`, `tripadvisor`, `yelp`, `producthunt`, `reddit`, `crunchbase`, `appstore`, `playstore`. |
| `result.data.brand.socials[].url` | `string` | No | — | — |
| `result.data.brand.address` | `object` | No | — | — |
| `result.data.brand.address.street` | `string` | No | — | — |
| `result.data.brand.address.city` | `string` | No | — | — |
| `result.data.brand.address.country` | `string` | No | — | — |
| `result.data.brand.address.country_code` | `string` | No | — | — |
| `result.data.brand.address.state_province` | `string` | No | — | — |
| `result.data.brand.address.state_code` | `string` | No | — | — |
| `result.data.brand.address.postal_code` | `string` | No | — | — |
| `result.data.brand.stock` | `object` | No | — | — |
| `result.data.brand.stock.ticker` | `string` | No | — | — |
| `result.data.brand.stock.exchange` | `string` | No | — | — |
| `result.data.brand.employees` | `object` | No | — | — |
| `result.data.brand.employees.range` | `"1 to 10" \| "11 to 50" \| "51 to 200" \| "201 to 500" \| "501 to 1000" \| "1001 to 5000" \| "5001 to 10000" \| "10001+"` | No | — | Allowed: `1 to 10`, `11 to 50`, `51 to 200`, `201 to 500`, `501 to 1000`, `1001 to 5000`, `5001 to 10000`, `10001+`. |
| `result.data.brand.employees.exact` | `integer` | No | — | — |
| `result.data.brand.is_nsfw` | `boolean` | No | — | — |
| `result.data.brand.email` | `string` | No | — | — |
| `result.data.brand.phone` | `string` | No | — | — |

The table shows the first 50 fields. Use the live contract below for every field.

> [!NOTE]
>
> This output schema is too large for an inline display. Read the complete live contract with `deepline describe contextdev_get_brand_transaction_identifier --json`.

## Deepline cost

* Pricing model: `provider_usage` (provider usage).
* Estimated Deepline credits: `0.01` per pricing unit.

## Related documentation

* [Context.dev provider guide](https://deepline.com/docs/providers/contextdev/guide.md)
* [SDK V2 quickstart](https://deepline.com/docs/sdk-v2/quickstart.md)
* [SDK reference](https://deepline.com/docs/sdk-v2/sdk-reference.md)
* [Run tools across a CSV](https://deepline.com/docs/sdk-v2/batch-csv.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.