# Get emojis by shortcodes or categories

Retrieves emojis by exact shortcodes and/or by exact categories from cache. Multiple values can be requested in a single call using comma separation. If both parameters are provided, the union of results is returned. Returns paginated response with items (current page results), total (count matching filter), and totalItems (total emojis in system).

Endpoint: GET /api/v1/custom_emojis
Version: 1.0
Security: 

## Query parameters:

  - `category` (array,null)
    Exact category name(s). Multiple values comma-separated
    Example: "Cats,Dogs"

  - `lastId` (string,null)
    Get older records (records with IDs less than this value) Alias maxId/max_id
    Example: "us_01hxcvk1hjexere4pvtrj0ymqq"

  - `limit` (integer,null)

  - `offset` (integer,null)

  - `shortcode` (array,null)
    Exact shortcode(s) of emoji. Multiple values comma-separated
    Example: "aaaa,AAAAAA"

  - `sortBy` (string,null)

  - `sortOrder` (string,null)

  - `untilId` (string,null)
    Get newer records (records with IDs greater than this value) Alias minId/min_id
    Example: "us_01hxcvk1hjexere4pvtrj0ymqq"

## Response 200 fields (application/json):

  - `items` (array, required)
    Paginated list of emojis for the current page

  - `items.shortcode` (string, required)

  - `items.category` (string,null)

  - `items.url` (string, required)

  - `items.staticUrl` (string, required)

  - `items.visibleInPicker` (boolean)

  - `total` (integer)
    Total number of emojis that satisfy the filter

  - `totalItems` (integer)
    Total number of all emojis in the system