Market packs
Market packs: the language facts Kenso writes each locale with, and the cold email notes of the countries it covers.
Headers
The endpoints on this page take these headers. Each endpoint's curl shows the ones it sends.
| Name | In | Type | Required | Description |
|---|---|---|---|---|
Ken-Version | header | string, one of: 2026-11-02, 1.1 | optional | The API version, a date in YYYY-MM-DD form. 1.1 is another name for the first dated version. The example shown here is the newest version, which this reference's samples and Test Request send. Leave it out to use your API key's pinned version. Keys created in the Kenso app are pinned to the newest version; keys minted by the CLI login are not. A key with no pinned version and no header gets the legacy shape where the path has one, and 404 where the path exists only in this version. A date that is not a version answers 400 unsupported_version; any other value that is not a version is treated as legacy. |
List market packs
/v1/marketsmarkets.list- Permission
- Any signed-in caller
- Rate limit
- 12,000 requests a minute per API key
Returns every market pack Kenso offers, ordered by locale. Use it to show the languages a campaign can turn on.
Each item has the pack's locale, language, name, status and the countries it writes for. Read GET /v1/markets/{locale} for the whole pack. Page with limit and cursor: pass nextCursor as cursor to read the next page.
Errors:
400 validation_failed:limitis not from 1 to 200, orcursoris not a cursor from this list.
Open to any signed-in caller, including an API key limited to a permission template.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
limit | query | integer (int32) | optional | Number of market packs per page, from 1 to 200, default 50. |
cursor | query | string | optional | The nextCursor from the previous page. Omit it for the first page. |
curl -X GET "https://api.ken.so/v1/markets?limit=50" \
-H "Authorization: Bearer $KENSO_API_KEY" \
-H "Ken-Version: 2026-11-02"Response 200
data is a list of MarketSummary. Each item has these fields. The response also carries pagination.
Show the 5 response fields and an example
The fields and an example are also on this endpoint's Markdown page.
Get a market pack
/v1/markets/{locale}markets.get- Permission
- Any signed-in caller
- Rate limit
- 12,000 requests a minute per API key
Returns one market pack in full, with the countries it writes for and each country's cold email rules. Use it to read the writing rules Kenso follows for a locale.
locale is a pack locale such as fr-FR, in any letter case and with - or _: FR-fr and fr_FR both read as fr-FR. pack holds the whole pack: formality, greetings, sign-offs, style, banned and spam phrases, and examples. countries lists the countries the pack writes for, each with its languages and coldEmail. coldEmail.regime is opt_out, consent or unresolved, and coldEmail.requiresAcknowledgement is true when a member must acknowledge the country's rules before a campaign with contacts there launches. Every cold email note ends with "Not legal advice."
Errors:
404 not_found: no pack has this locale. A bare language such asfris not a locale.
Open to any signed-in caller, including an API key limited to a permission template.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
locale | path | string | required | Locale of the pack, such as fr-FR. |
curl -X GET "https://api.ken.so/v1/markets/fr-FR" \
-H "Authorization: Bearer $KENSO_API_KEY" \
-H "Ken-Version: 2026-11-02"Response 200
data is a Market.
Show the 6 response fields and an example
The fields and an example are also on this endpoint's Markdown page.
More in Campaigns:CampaignsEmail sequencesLinkedIn sequencesSegment email sequencesSegment LinkedIn sequencesSequence variablesSequences with conditionsSequence importSegmentsLead listsShare linksClient approvalsSending capacityAuto-pausesCampaign languagesLocalized stepsText translationCountry complianceCampaign imagesAll resources