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

# Find a company's domain, LinkedIn page and logo (free)

> Find a company's website domain, LinkedIn company page and logo from its name, website domain or LinkedIn URL. Free: no credits are charged.

Send at least one of `name` (e.g. "Stripe"), `domain` (e.g. "stripe.com"; a full URL is reduced to its domain) or `linkedinUrl` (e.g. "linkedin.com/company/stripe"). When several are sent, only the most precise is looked up: `linkedinUrl`, then `domain`, then `name`. A name resolves to the best-known company of that name, so send a domain or LinkedIn page for common names.

The answer carries `status` (`found` or `not_found`), `company` (`name`, `domain`, `linkedinUrl` and `logoUrl`, each null when unknown; `company` itself is null when nothing matches) and `creditsCharged` (always 0). A company nothing matches is a 200 `not_found`, never a guess. A lookup the company data provider cannot answer in time answers 504 and caches nothing: retry. Next: pass the `domain` to POST /companies/search as `filters.domains` for the full company record.

Only keys whose usage plan includes `company_resolve` may call it. Rate limit: the plan's `company_resolve` entry.

Errors:
- `403` `API_NOT_ON_PLAN` — The key's usage plan does not include `company_resolve`.
- `422` `COMPANY_IDENTIFIER_INVALID` — `domain` is not a website domain, or `linkedinUrl` is not a LinkedIn company page.
- `429` `RATE_LIMITED` — The plan's per-minute or per-day limit for `company_resolve` is spent, or the company data provider is busy: retry shortly.

Requires one of the following token scopes: data.



## OpenAPI

````yaml /openapi.json post /business/data/companies/resolve
openapi: 3.1.0
info:
  title: Fuse Business API
  version: 1.0.0
  description: >-
    External API for lists, campaigns, prospect search and contacts.
    Authenticate with your API token as HTTP Basic. All paths are under /api/v1.
servers:
  - url: https://api.tryfuse.ai/api/v1
    description: Production
security:
  - basicAuth: []
tags:
  - name: Lists
  - name: Custom columns
  - name: Smart columns
  - name: Exports
  - name: Campaigns
  - name: Knowledge hubs
  - name: Analytics
  - name: Website intent
  - name: Account
  - name: Data
  - name: Prospect search
  - name: Campaign steps
  - name: Scheduled sends
  - name: Campaign templates
  - name: Agents
  - name: Research
  - name: Company search
  - name: Saved searches
  - name: Folders
  - name: Contacts
paths:
  /business/data/companies/resolve:
    post:
      tags:
        - Data
      summary: Find a company's domain, LinkedIn page and logo (free)
      description: >-
        Find a company's website domain, LinkedIn company page and logo from its
        name, website domain or LinkedIn URL. Free: no credits are charged.


        Send at least one of `name` (e.g. "Stripe"), `domain` (e.g.
        "stripe.com"; a full URL is reduced to its domain) or `linkedinUrl`
        (e.g. "linkedin.com/company/stripe"). When several are sent, only the
        most precise is looked up: `linkedinUrl`, then `domain`, then `name`. A
        name resolves to the best-known company of that name, so send a domain
        or LinkedIn page for common names.


        The answer carries `status` (`found` or `not_found`), `company` (`name`,
        `domain`, `linkedinUrl` and `logoUrl`, each null when unknown; `company`
        itself is null when nothing matches) and `creditsCharged` (always 0). A
        company nothing matches is a 200 `not_found`, never a guess. A lookup
        the company data provider cannot answer in time answers 504 and caches
        nothing: retry. Next: pass the `domain` to POST /companies/search as
        `filters.domains` for the full company record.


        Only keys whose usage plan includes `company_resolve` may call it. Rate
        limit: the plan's `company_resolve` entry.


        Errors:

        - `403` `API_NOT_ON_PLAN` — The key's usage plan does not include
        `company_resolve`.

        - `422` `COMPANY_IDENTIFIER_INVALID` — `domain` is not a website domain,
        or `linkedinUrl` is not a LinkedIn company page.

        - `429` `RATE_LIMITED` — The plan's per-minute or per-day limit for
        `company_resolve` is spent, or the company data provider is busy: retry
        shortly.


        Requires one of the following token scopes: data.
      operationId: resolveCompany
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                name:
                  type: string
                  minLength: 1
                  maxLength: 255
                  description: >-
                    The company's name, e.g. `Stripe`. The least precise
                    identifier: used only when no `domain` or `linkedinUrl` is
                    given.
                domain:
                  type: string
                  minLength: 1
                  maxLength: 253
                  description: >-
                    The company's website domain, e.g. `stripe.com`; a full URL
                    such as `https://www.stripe.com/about` is reduced to its
                    domain.
                linkedinUrl:
                  type: string
                  minLength: 1
                  maxLength: 2048
                  description: >-
                    The company's LinkedIn page, e.g.
                    `https://www.linkedin.com/company/stripe`, `company/stripe`
                    or the bare slug `stripe`.
              description: >-
                At least one of `name`, `domain` or `linkedinUrl`. When several
                are given, only the most precise one is looked up:
                `linkedinUrl`, then `domain`, then `name`.
      responses:
        '200':
          description: Success
          headers:
            RateLimit-Limit:
              schema:
                type: integer
              description: Requests permitted in the current window.
            RateLimit-Remaining:
              schema:
                type: integer
              description: Requests remaining in the current window.
            RateLimit-Reset:
              schema:
                type: integer
              description: Seconds until the current window resets.
          content:
            application/json:
              schema:
                type: object
                required:
                  - status
                  - company
                  - creditsCharged
                properties:
                  status:
                    type: string
                    enum:
                      - found
                      - not_found
                  company:
                    type:
                      - object
                      - 'null'
                    required:
                      - name
                      - domain
                      - linkedinUrl
                      - logoUrl
                    properties:
                      name:
                        type: string
                      domain:
                        type:
                          - string
                          - 'null'
                      linkedinUrl:
                        type:
                          - string
                          - 'null'
                      logoUrl:
                        type:
                          - string
                          - 'null'
                    description: Null when `status` is `not_found`.
                  creditsCharged:
                    type: integer
                    description: 'Always 0: resolving is free.'
              example:
                status: found
                company:
                  name: Stripe
                  domain: stripe.com
                  linkedinUrl: linkedin.com/company/stripe
                  logoUrl: https://logo.example.com/stripe.png
                creditsCharged: 0
        '400':
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '402':
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '403':
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '409':
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '422':
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '500':
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      security:
        - basicAuth: []
components:
  schemas:
    Error:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
            message:
              type: string
            param:
              type:
                - string
                - 'null'
            doc_url:
              type:
                - string
                - 'null'
            request_id:
              type:
                - string
                - 'null'
          required:
            - code
            - message
      required:
        - error
  securitySchemes:
    basicAuth:
      type: http
      scheme: basic
      description: >-
        Your API token (`af_…`) as the Basic-auth username, with an empty
        password.

````

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