---
title: "Match"
method: POST
path: "/entity-match/match"
tags: ["Match"]
---

# Match

`POST /entity-match/match`

## Request

- Base URL: `https://api.recordedfuture.com`
- URL: `https://api.recordedfuture.com/entity-match/match`
- Auth: one of:
  - API key in header `X-RFToken`
  - OAuth 2
    - Authorization code: `https://id.recordedfuture.com/authorize`
    - Token URL: `https://id.recordedfuture.com/token`

Resolve human-readable entity names to Recorded Future entity IDs using fuzzy matching, with an optional type filter to narrow results to specific entity categories.

## Request body

- object
  - `name` string, required: This mandatory free text search field is used to match against entity names.
  - `type` string[]: An array of types is optional. If in use, the **Match** operation will only try to match on entities that meet **any** of the "type" criteria. See the list of [Available Entity Types](https://recorded-future.readme.io/reference/available-entity-types).
  - `limit` integer: This optional field is used to limit the max number of responses returned (maximum 100).

## Response `200`

Successful request - Returns a list of items or an empty list if no items were found.

- EntityMatchResponse[]
  - `id` string, required: Recorded Future entity ID (use with Lookup and other endpoints)
  - `name` string, required: Entity display name (may differ from search term)
  - `type` string, required: Entity type (e.g., CyberVulnerability, Malware, IpAddress, InternetDomainName)

## Other responses

- `400`: Bad request
- `401`: Unauthorized

---

[API](https://skmtc.dev/recordedfuture/apis/entity-match-api.md) - [All operations](https://skmtc.dev/recordedfuture/apis/entity-match-api/llms.txt) - [OpenAPI document](https://skmtc.dev/recordedfuture/apis/entity-match-api/revisions/f697fb1fa7b6?raw)