---
title: "Search for entities"
method: GET
path: "/v2/entities"
tags: ["Entities"]
---

# Search for entities

`GET /v2/entities`

Resolves a query into an entity by querying our entity resolution system. 
    The parameters `name` and `website` are mutually exclusive. Calls to this endpoint using 
    the `name` parameter are billed the same way transactions are.

## Query parameters

- `name` string, nullable — The name of the entity to resolve
- `website` string, nullable — The website of the entity to resolve
- `location` string, nullable — A location string of the entity to resolve

## Response `200`

Entity

- EntitySearchOut
  - `id` string, nullable
  - `name` string, nullable
  - `website` string, nullable
  - `logo` string, nullable
  - `location` string, nullable
  - `location_structured` LocationStructuredPublic
    - `address` string, nullable
    - `city` string, nullable
    - `state` string, nullable
    - `postcode` string, nullable
    - `country` string, nullable
    - `country_name` string, nullable
    - `latitude` number, nullable
    - `longitude` number, nullable
    - `google_maps_url` string, nullable
    - `apple_maps_url` string, nullable
    - `store_number` string, nullable
    - `house_number` string, nullable
  - `confidence` number, nullable

## Other responses

- `400` — Bad request.
- `422` — Validation Error
- `423` — Not enough credits.

---

[API](https://skmtc.net/ntropy/apis/ntropy-transaction-api.md) · [All operations](https://skmtc.net/ntropy/apis/ntropy-transaction-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ntropy/ntropy-transaction-api/revisions/47be508488c1/schema)