---
title: "Get Keywords"
method: POST
path: "/get-keywords.json"
tags: ["Keywords"]
---

# Get Keywords

`POST /get-keywords.json`

Get a list of existing keywords.

## Response `200`

Successful response

- object
  - `page` object
    - `count` integer — Total count of keywords returned in the current page.
    - `number` integer — Current page number.
  - `keywords_total` integer — Total count of keywords available.
  - `keywords` object[]
    - `keyword` string — The keyword.
    - `reference` string — Reference for the keyword.
    - `number` integer — The dedicated virtual number associated with the keyword.
    - `list_id` integer — ID of the list associated with the keyword.
    - `welcome_message` string — SMS message sent to new members.
    - `member_message` string — SMS message sent to existing members.
    - `forward_url` string, uri — URL to forward messages.
    - `forward_sms` string — MSISDNs to forward messages to.
    - `forward_email` string — Email addresses to forward messages to.
    - `status` string — Status of the keyword.
    - `billing_date` string, date — Billing date associated with the keyword.
  - `error` object
    - `code` string — Error code.
    - `description` string — Description of the error.

---

[API](https://skmtc.net/kudosity/apis/transmit-sms-api.md) · [All operations](https://skmtc.net/kudosity/apis/transmit-sms-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/kudosity/transmit-sms-api/revisions/9f6c34b849af/schema)