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

# Overview

> Turn payment transactions into merchant data.

<Note>
  Requests to the Transaction API count against your Brand API usage quotas.
</Note>

The Transaction API identifies merchant brands from raw transaction data in a single call. It processes unstructured payment text, maps it to a domain, and returns brand details (e.g., name, logo, domain, industry, etc). For more details, refer to our [API Reference](/reference/transaction-api).

Transaction API works in real-time to recognize merchants worldwide. If a brand is not part of our dataset, it will index the information live, providing data for brands of every size, geography, or sector.

## Implementation guide

For more details, refer to our [API Reference](/reference/brand-api).

<Steps>
  <Step title="Get your API key">
    You’ll need to create an account on our [Developer Portal](https://developers.brandfetch.com/register). Creating an account is quick and easy, and will give you access to your dashboard where you’ll find your API key.
  </Step>

  <Step title="Make your first API call">
    Implement or run the code below to make your first API request.

    <CodeGroup>
      ```curl curl theme={null}
      curl --request POST \
        --url https://api.brandfetch.io/v2/brands/transaction \
        --header 'Authorization: Bearer <token>' \
        --header 'Content-Type: application/json' \
        --data '{
          "transactionLabel": "STARBUCKS 1523 OMAHA NE",
          "countryCode": "US"
        }'
      ```
    </CodeGroup>

    Authentication is done by passing your API key as a [Bearer Authentication](https://swagger.io/docs/specification/authentication/bearer-authentication/). The Transaction API can be accessed through the following structure:
  </Step>

  <Step title="Test and deploy">
    All requests for the domain <b>brandfetch.com</b> are free and will not count towards your usage/quotas. You can make as many requests to the Brandfetch’s brand as you need while you iterate on and test your integration.

    Once you are ready to go live, simply replace <b>brandfetch.com</b> with the domain name, Stock/ETF ticker, ISIN or Crypto symbol you want to look up.
  </Step>
</Steps>

## Transaction input

The primary input for querying the Transaction API
is a raw transaction descriptor (the line-item text on a bank or credit card
statement). You provide this as the `transactionLabel` in the request body,
along with a `countryCode` to narrow down the merchant’s locale. For example, a
transaction label like `"STARBUCKS 1523 OMAHA NE"` with country code `"US"` can
be resolved to starbucks.com.

## API Reference

For more details, refer to our [API Reference](/reference/transaction-api).