---
title: "List custom emojis"
method: GET
path: "/v1/custom_emojis"
tags: ["Custom emojis"]
---

# List custom emojis

`GET /v1/custom_emojis`

## Query parameters

- `start_cursor` string — If supplied, this endpoint will return a page of results starting after the cursor provided. If not supplied, this endpoint will return the first page of results.
- `page_size` integer — The number of items from the full list desired in the response. Maximum: 100
- `name` string — If supplied, filters custom emojis by exact name match. Useful for resolving a custom emoji name to its ID.

## Headers

- `Notion-Version` '2026-03-11', required

## Response `200`

- object
  - `object` 'list', required — Always `list`
  - `type` 'custom_emoji', required — Always `custom_emoji`
  - `results` CustomEmojiResponse[], required — The list of custom emojis.
    - `id` string, uuid, required
    - `name` string, required — The name of the custom emoji.
    - `url` string, required — The URL of the custom emoji.
  - `has_more` boolean, required — Whether there are more results available.
  - `next_cursor` string, uuid, required

## Other responses

- `400`
- `401`
- `403`
- `404`
- `406`
- `409`
- `429`
- `500`
- `503`
- `504`
- `529`

---

[API](https://skmtc.net/notion/apis/notion-api.md) · [All operations](https://skmtc.net/notion/apis/notion-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/notion/notion-api/versions/551da43bb186/schema)