---
title: "Search on a string"
method: GET
path: "/characters/{character_id}/search"
tags: ["Search"]
---

# Search on a string

`GET /characters/{character_id}/search`

## Request

- Base URL: `https://esi.evetech.net`
- URL: `https://esi.evetech.net/characters/{character_id}/search`
- Auth: OAuth 2
  - Authorization code: `https://login.eveonline.com/v2/oauth/authorize`
  - Token URL: `https://login.eveonline.com/v2/oauth/token` scopes: `esi-search.search_structures.v1`
- TypeScript: <https://skmtc.dev/evemonk/apis/eve-stable-infrastructure-esi-tranquility/docs/characters/:character_id/search/get.ts> (a function with typed inputs; its response is checked against the schema)

Search for entities that match a given sub-string.

## Path parameters

- `character_id` integer, required

## Query parameters

- `categories` string[], required: Type of entities to search for
- `search` string, required: The string to search on
- `strict` boolean: Whether the search should be a strict match

## Headers

- `Accept-Language` 'en' | 'de' | 'fr' | 'ja' | 'ru' | 'zh' | 'ko' | 'es'
- `If-None-Match` string
- `X-Compatibility-Date` '2025-12-16', date, required
- `X-Tenant` string

## Response `200`

OK

- CharactersCharacterIdSearchGet
  - `agent` integer[]
  - `alliance` integer[]
  - `character` integer[]
  - `constellation` integer[]
  - `corporation` integer[]
  - `faction` integer[]
  - `inventory_type` integer[]
  - `region` integer[]
  - `solar_system` integer[]
  - `station` integer[]
  - `structure` integer[]

## Other responses

- `default`: Error

---

[API](https://skmtc.dev/evemonk/apis/eve-stable-infrastructure-esi-tranquility.md) - [All operations](https://skmtc.dev/evemonk/apis/eve-stable-infrastructure-esi-tranquility/llms.txt) - [OpenAPI document](https://skmtc.dev/evemonk/apis/eve-stable-infrastructure-esi-tranquility/revisions/7bad2f0024dd?raw)
