---
title: "Lookup"
method: GET
path: "/entity-match/entity/{id}"
tags: ["Lookup"]
---

# Lookup

`GET /entity-match/entity/{id}`

## Request

- Base URL: `https://api.recordedfuture.com`
- URL: `https://api.recordedfuture.com/entity-match/entity/{id}`
- 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 an RF entity ID to its name, type, and aliases.

## Path parameters

- `id` string, required

## Response `200`

OK

- EntityLookupResponse: Metadata for a single entity resolved by its Recorded Future ID.
  - `data` object, required: Entity summary
    - `id` string, required: Entity ID
    - `type` string, required: Entity type
    - `attributes` object, required: Entity attributes
      - `name` string, required: Primary display name
      - `common_names` string[], required: Well-known alternative names
      - `alias` string[], required: All known aliases
      - `is_threat_actor` boolean, required: Whether this entity is classified as a threat actor

## Other responses

- `401`: Unauthorized
- `404`: Entity not found

---

[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)