> For the complete documentation index, see [llms.txt](https://docs.tnid.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.tnid.com/api-reference/002_company/001_companies/001__search_companies.md).

# Search Companies

GraphQL endpoint: `/company`

Search for companies registered on the platform.

## Query

```graphql
query (
  $id: ID
  $name: String
  $taxId: String
  $email: String
  $telephoneNumber: String
  $webpage: String
  $limit: Int
  $metadata: JSON
) {
  companies (
    id: $id
    name: $name
    taxId: $taxId
    email: $email
    telephoneNumber: $telephoneNumber
    webpage: $webpage
    limit: $limit
    metadata: $metadata
  ) {
    id
    legalName
    brandName
    profileName
    yearFounded
    aboutUs
    metadata
    verified
    logoUrl
    verticalType {
      id
      displayName
      description
    }
    organizationType {
      id
      displayName
    }
    addresses {
      city
      country
      state
      street
      types
      zipCode
      visibility
    }
    emails {
      email
      types
      visibility
    }
    telephoneNumbers {
      number
      types
      visibility
    }
    socialNetworks {
      type
      url
      visibility
    }
    webpages {
      type
      url
      visibility
    }
    specialties {
      description
      title
    }
    trustedDomains {
      domain
    }
    subscriptionTopics {
      id
      name
    }
    subscriptionSettings {
      enable_email
      enable_sms
      enable_voice
    }
    taxIds {
      id
      type
      value
      usState
      visibility
    }
    legalNameVisibility
    brandNameVisibility
    aboutUsVisibility
    yearFoundedVisibility
    verticalTypeVisibility
    organizationTypeVisibility
    specialtiesVisibility
    b2cVisibility
    metadataVisibility
  }
}

```

## Variables

```json
{}
```

## Response

```json
{
  "data": {
    "companies": [
      {
        "aboutUs": "about us content",
        "aboutUsVisibility": null,
        "addresses": [
          {
            "city": "test city",
            "country": "United States",
            "state": "Alabama",
            "street": "test street 1",
            "types": [
              "HEADQUARTERS"
            ],
            "visibility": null,
            "zipCode": "12345"
          }
        ],
        "b2cVisibility": null,
        "brandName": "1brand-name",
        "brandNameVisibility": null,
        "emails": [
          {
            "email": "test2@email.com",
            "types": [
              "HEADQUARTERS"
            ],
            "visibility": null
          }
        ],
        "id": "00000000-0000-4000-8000-000000000001",
        "legalName": "2legal-name",
        "legalNameVisibility": null,
        "logoUrl": "http://localhost:4566/logo_url?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=SOME_RANDOM_ACCESS_KEY%2F20260115%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260115T090000Z&X-Amz-Expires=600&X-Amz-SignedHeaders=host&X-Amz-Signature=0000000000000000000000000000000000000000000000000000000000000000",
        "metadata": {
          "test": "value"
        },
        "metadataVisibility": null,
        "organizationType": {
          "displayName": "display_name_3",
          "id": "00000000-0000-4000-8000-000000000002"
        },
        "organizationTypeVisibility": null,
        "profileName": "3profile-name",
        "socialNetworks": [
          {
            "type": "FACEBOOK",
            "url": "https://test-sm4.not",
            "visibility": null
          }
        ],
        "specialties": [
          {
            "description": null,
            "title": "Telecommunications"
          }
        ],
        "specialtiesVisibility": null,
        "subscriptionSettings": null,
        "subscriptionTopics": [
          {
            "id": "00000000-0000-4000-8000-000000000003",
            "name": "topic_5"
          },
          {
            "id": "00000000-0000-4000-8000-000000000004",
            "name": "topic_6"
          }
        ],
        "taxIds": [],
        "telephoneNumbers": [
          {
            "number": "7",
            "types": [
              "HEADQUARTERS"
            ],
            "visibility": null
          }
        ],
        "trustedDomains": null,
        "verified": true,
        "verticalType": {
          "description": "description_8",
          "displayName": "display_name_9",
          "id": "00000000-0000-4000-8000-000000000005"
        },
        "verticalTypeVisibility": null,
        "webpages": [
          {
            "type": "WEBPAGE",
            "url": "https://test-webpage10.not",
            "visibility": null
          }
        ],
        "yearFounded": 2000,
        "yearFoundedVisibility": null
      },
      {
        "aboutUs": "about us content",
        "aboutUsVisibility": [
          "PUBLIC"
        ],
        "addresses": [
          {
            "city": "test city",
            "country": "United States",
            "state": "Alabama",
            "street": "test street 11",
            "types": [
              "HEADQUARTERS"
            ],
            "visibility": [
              "PUBLIC"
            ],
            "zipCode": "12345"
          }
        ],
        "b2cVisibility": [
          "PUBLIC"
        ],
        "brandName": "4brand-name",
        "brandNameVisibility": [
          "PUBLIC"
        ],
        "emails": [
          {
            "email": "test12@email.com",
            "types": [
              "HEADQUARTERS"
            ],
            "visibility": [
              "PUBLIC"
            ]
          }
        ],
        "id": "00000000-0000-4000-8000-000000000006",
        "legalName": "5legal-name",
        "legalNameVisibility": [
          "PUBLIC"
        ],
        "logoUrl": "http://localhost:4566/logo_url?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=SOME_RANDOM_ACCESS_KEY%2F20260115%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260115T090000Z&X-Amz-Expires=600&X-Amz-SignedHeaders=host&X-Amz-Signature=0000000000000000000000000000000000000000000000000000000000000000",
        "metadata": {
          "test": "value"
        },
        "metadataVisibility": [
          "PUBLIC"
        ],
        "organizationType": {
          "displayName": "display_name_13",
          "id": "00000000-0000-4000-8000-000000000007"
        },
        "organizationTypeVisibility": [
          "PUBLIC"
        ],
        "profileName": "6profile-name",
        "socialNetworks": [
          {
            "type": "FACEBOOK",
            "url": "https://test-sm14.not",
            "visibility": [
              "PUBLIC"
            ]
          }
        ],
        "specialties": [
          {
            "description": null,
            "title": "Telecommunications"
          }
        ],
        "specialtiesVisibility": [
          "PUBLIC"
        ],
        "subscriptionSettings": {
          "enable_email": true,
          "enable_sms": true,
          "enable_voice": true
        },
        "subscriptionTopics": [
          {
            "id": "00000000-0000-4000-8000-000000000008",
            "name": "topic_15"
          },
          {
            "id": "00000000-0000-4000-8000-000000000009",
            "name": "topic_16"
          }
        ],
        "taxIds": [
          {
            "id": "00000000-0000-4000-8000-000000000010",
            "type": "EIN",
            "usState": null,
            "value": "100000645",
            "visibility": [
              "PRIVATE"
            ]
          }
        ],
        "telephoneNumbers": [
          {
            "number": "17",
            "types": [
              "HEADQUARTERS"
            ],
            "visibility": [
              "PUBLIC"
            ]
          }
        ],
        "trustedDomains": [],
        "verified": true,
        "verticalType": {
          "description": "description_18",
          "displayName": "display_name_19",
          "id": "00000000-0000-4000-8000-000000000011"
        },
        "verticalTypeVisibility": [
          "PUBLIC"
        ],
        "webpages": [
          {
            "type": "WEBPAGE",
            "url": "https://test-webpage20.not",
            "visibility": [
              "PUBLIC"
            ]
          }
        ],
        "yearFounded": 2000,
        "yearFoundedVisibility": [
          "PUBLIC"
        ]
      },
      {
        "aboutUs": "about us content",
        "aboutUsVisibility": null,
        "addresses": [
          {
            "city": "test city",
            "country": "United States",
            "state": "Alabama",
            "street": "test street 21",
            "types": [
              "HEADQUARTERS"
            ],
            "visibility": null,
            "zipCode": "12345"
          }
        ],
        "b2cVisibility": null,
        "brandName": "7brand-name",
        "brandNameVisibility": null,
        "emails": [
          {
            "email": "test22@email.com",
            "types": [
              "HEADQUARTERS"
            ],
            "visibility": null
          }
        ],
        "id": "00000000-0000-4000-8000-000000000012",
        "legalName": "8legal-name",
        "legalNameVisibility": null,
        "logoUrl": "http://localhost:4566/logo_url?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=SOME_RANDOM_ACCESS_KEY%2F20260115%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260115T090000Z&X-Amz-Expires=600&X-Amz-SignedHeaders=host&X-Amz-Signature=0000000000000000000000000000000000000000000000000000000000000000",
        "metadata": {
          "test": "value"
        },
        "metadataVisibility": null,
        "organizationType": {
          "displayName": "display_name_23",
          "id": "00000000-0000-4000-8000-000000000013"
        },
        "organizationTypeVisibility": null,
        "profileName": "9profile-name",
        "socialNetworks": [
          {
            "type": "FACEBOOK",
            "url": "https://test-sm24.not",
            "visibility": null
          }
        ],
        "specialties": [
          {
            "description": null,
            "title": "Telecommunications"
          }
        ],
        "specialtiesVisibility": null,
        "subscriptionSettings": null,
        "subscriptionTopics": [
          {
            "id": "00000000-0000-4000-8000-000000000014",
            "name": "topic_25"
          },
          {
            "id": "00000000-0000-4000-8000-000000000015",
            "name": "topic_26"
          }
        ],
        "taxIds": [],
        "telephoneNumbers": [
          {
            "number": "27",
            "types": [
              "HEADQUARTERS"
            ],
            "visibility": null
          }
        ],
        "trustedDomains": null,
        "verified": true,
        "verticalType": {
          "description": "description_28",
          "displayName": "display_name_29",
          "id": "00000000-0000-4000-8000-000000000016"
        },
        "verticalTypeVisibility": null,
        "webpages": [
          {
            "type": "WEBPAGE",
            "url": "https://test-webpage30.not",
            "visibility": null
          }
        ],
        "yearFounded": 2000,
        "yearFoundedVisibility": null
      },
      {
        "aboutUs": "about us content",
        "aboutUsVisibility": null,
        "addresses": [
          {
            "city": "test city",
            "country": "United States",
            "state": "Alabama",
            "street": "test street 31",
            "types": [
              "HEADQUARTERS"
            ],
            "visibility": null,
            "zipCode": "12345"
          }
        ],
        "b2cVisibility": null,
        "brandName": "10brand-name",
        "brandNameVisibility": null,
        "emails": [
          {
            "email": "test32@email.com",
            "types": [
              "HEADQUARTERS"
            ],
            "visibility": null
          }
        ],
        "id": "00000000-0000-4000-8000-000000000017",
        "legalName": "11legal-name",
        "legalNameVisibility": null,
        "logoUrl": "http://localhost:4566/logo_url?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=SOME_RANDOM_ACCESS_KEY%2F20260115%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260115T090000Z&X-Amz-Expires=600&X-Amz-SignedHeaders=host&X-Amz-Signature=0000000000000000000000000000000000000000000000000000000000000000",
        "metadata": {
          "test": "value"
        },
        "metadataVisibility": null,
        "organizationType": {
          "displayName": "display_name_33",
          "id": "00000000-0000-4000-8000-000000000018"
        },
        "organizationTypeVisibility": null,
        "profileName": "12profile-name",
        "socialNetworks": [
          {
            "type": "FACEBOOK",
            "url": "https://test-sm34.not",
            "visibility": null
          }
        ],
        "specialties": [
          {
            "description": null,
            "title": "Telecommunications"
          }
        ],
        "specialtiesVisibility": null,
        "subscriptionSettings": null,
        "subscriptionTopics": [
          {
            "id": "00000000-0000-4000-8000-000000000019",
            "name": "topic_35"
          },
          {
            "id": "00000000-0000-4000-8000-000000000020",
            "name": "topic_36"
          }
        ],
        "taxIds": [],
        "telephoneNumbers": [
          {
            "number": "37",
            "types": [
              "HEADQUARTERS"
            ],
            "visibility": null
          }
        ],
        "trustedDomains": null,
        "verified": true,
        "verticalType": {
          "description": "description_38",
          "displayName": "display_name_39",
          "id": "00000000-0000-4000-8000-000000000021"
        },
        "verticalTypeVisibility": null,
        "webpages": [
          {
            "type": "WEBPAGE",
            "url": "https://test-webpage40.not",
            "visibility": null
          }
        ],
        "yearFounded": 2000,
        "yearFoundedVisibility": null
      },
      {
        "aboutUs": "about us content",
        "aboutUsVisibility": null,
        "addresses": [
          {
            "city": "test city",
            "country": "United States",
            "state": "Alabama",
            "street": "test street 41",
            "types": [
              "HEADQUARTERS"
            ],
            "visibility": null,
            "zipCode": "12345"
          }
        ],
        "b2cVisibility": null,
        "brandName": "13brand-name",
        "brandNameVisibility": null,
        "emails": [
          {
            "email": "test42@email.com",
            "types": [
              "HEADQUARTERS"
            ],
            "visibility": null
          }
        ],
        "id": "00000000-0000-4000-8000-000000000022",
        "legalName": "14legal-name",
        "legalNameVisibility": null,
        "logoUrl": "http://localhost:4566/logo_url?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=SOME_RANDOM_ACCESS_KEY%2F20260115%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260115T090000Z&X-Amz-Expires=600&X-Amz-SignedHeaders=host&X-Amz-Signature=0000000000000000000000000000000000000000000000000000000000000000",
        "metadata": {
          "test": "value"
        },
        "metadataVisibility": null,
        "organizationType": {
          "displayName": "display_name_43",
          "id": "00000000-0000-4000-8000-000000000023"
        },
        "organizationTypeVisibility": null,
        "profileName": "15profile-name",
        "socialNetworks": [
          {
            "type": "FACEBOOK",
            "url": "https://test-sm44.not",
            "visibility": null
          }
        ],
        "specialties": [
          {
            "description": null,
            "title": "Telecommunications"
          }
        ],
        "specialtiesVisibility": null,
        "subscriptionSettings": null,
        "subscriptionTopics": [
          {
            "id": "00000000-0000-4000-8000-000000000024",
            "name": "topic_45"
          },
          {
            "id": "00000000-0000-4000-8000-000000000025",
            "name": "topic_46"
          }
        ],
        "taxIds": [],
        "telephoneNumbers": [
          {
            "number": "47",
            "types": [
              "HEADQUARTERS"
            ],
            "visibility": null
          }
        ],
        "trustedDomains": null,
        "verified": true,
        "verticalType": {
          "description": "description_48",
          "displayName": "display_name_49",
          "id": "00000000-0000-4000-8000-000000000026"
        },
        "verticalTypeVisibility": null,
        "webpages": [
          {
            "type": "WEBPAGE",
            "url": "https://test-webpage50.not",
            "visibility": null
          }
        ],
        "yearFounded": 2000,
        "yearFoundedVisibility": null
      },
      {
        "aboutUs": "about us content",
        "aboutUsVisibility": null,
        "addresses": [
          {
            "city": "test city",
            "country": "United States",
            "state": "Alabama",
            "street": "test street 51",
            "types": [
              "HEADQUARTERS"
            ],
            "visibility": null,
            "zipCode": "12345"
          }
        ],
        "b2cVisibility": null,
        "brandName": "16brand-name",
        "brandNameVisibility": null,
        "emails": [
          {
            "email": "test52@email.com",
            "types": [
              "HEADQUARTERS"
            ],
            "visibility": null
          }
        ],
        "id": "00000000-0000-4000-8000-000000000027",
        "legalName": "17legal-name",
        "legalNameVisibility": null,
        "logoUrl": "http://localhost:4566/logo_url?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=SOME_RANDOM_ACCESS_KEY%2F20260115%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260115T090000Z&X-Amz-Expires=600&X-Amz-SignedHeaders=host&X-Amz-Signature=0000000000000000000000000000000000000000000000000000000000000000",
        "metadata": {
          "test": "value"
        },
        "metadataVisibility": null,
        "organizationType": {
          "displayName": "display_name_53",
          "id": "00000000-0000-4000-8000-000000000028"
        },
        "organizationTypeVisibility": null,
        "profileName": "18profile-name",
        "socialNetworks": [
          {
            "type": "FACEBOOK",
            "url": "https://test-sm54.not",
            "visibility": null
          }
        ],
        "specialties": [
          {
            "description": null,
            "title": "Telecommunications"
          }
        ],
        "specialtiesVisibility": null,
        "subscriptionSettings": null,
        "subscriptionTopics": [
          {
            "id": "00000000-0000-4000-8000-000000000029",
            "name": "topic_55"
          },
          {
            "id": "00000000-0000-4000-8000-000000000030",
            "name": "topic_56"
          }
        ],
        "taxIds": [],
        "telephoneNumbers": [
          {
            "number": "57",
            "types": [
              "HEADQUARTERS"
            ],
            "visibility": null
          }
        ],
        "trustedDomains": null,
        "verified": true,
        "verticalType": {
          "description": "description_58",
          "displayName": "display_name_59",
          "id": "00000000-0000-4000-8000-000000000031"
        },
        "verticalTypeVisibility": null,
        "webpages": [
          {
            "type": "WEBPAGE",
            "url": "https://test-webpage60.not",
            "visibility": null
          }
        ],
        "yearFounded": 2000,
        "yearFoundedVisibility": null
      }
    ]
  }
}
```