---
title: "Get Identifiers"
method: GET
path: "/api/v1/identifiers"
tags: ["Basics"]
---

# Get Identifiers

`GET /api/v1/identifiers`

## Request

- Base URL: `https://api.athenahq.ai`
- URL: `https://api.athenahq.ai/api/v1/identifiers`
- Auth: API key in header `x-api-key`
- TypeScript: <https://skmtc.dev/athenahq/apis/athenahq-api/docs/api/v1/identifiers/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns the identifiers of a website's own brand, or of one of its competitors when you pass `competitor_id`: the names, aliases and domains Athena looks for in AI responses to count a mention. `default_identifiers` holds the name and domain, which are always matched. `identifiers` holds every other value the Competitors page shows, so the two lists together are the full set. `case_sensitive` tells whether matching respects letter case. `entity` says what the identifiers belong to, with `type` set to `brand` or `competitor`.

## Query parameters

- `website_id` string, required
- `competitor_id` string

## Response `200`

Successful response with the identifiers

- object
  - `entity` object, required
    - `type` 'brand' | 'competitor', required
    - `id` string, required
    - `name` string, required
    - `url` string, required
  - `default_identifiers` string[], required
  - `identifiers` string[], required
  - `case_sensitive` boolean, required

## Other responses

- `400`: Bad request - Invalid parameters
- `401`: Unauthorized - Invalid or missing API key
- `403`: Forbidden - You don't have access to this website
- `404`: Not found - The competitor doesn't exist on this website
- `429`: Rate limit exceeded
- `500`: Internal server error

## Changes

- **2026-11-05** `89758441cf66`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/athenahq/apis/athenahq-api/changes/api/v1/identifiers/get.md)

---

[API](https://skmtc.dev/athenahq/apis/athenahq-api.md) - [All operations](https://skmtc.dev/athenahq/apis/athenahq-api/llms.txt) - [OpenAPI document](https://skmtc.dev/athenahq/apis/athenahq-api/revisions/87b53707fb7a?raw)