{"uid":"cap_2-y2hQ5-ZyT0senzh9ZNV","slug":"locale-and-formatting-tools-list-formatter-a4067158","name":"Locale and Formatting Tools – List Formatter","description":"Join items into a natural-language and/or list for a locale ('a, b, and c' in en, 'a, b y c' in es).","url":"https://locale-tools.x402tookit.com/list-format?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["items"],"properties":{"type":{"type":"string","description":"conjunction (and, default), disjunction (or) or unit (no word)"},"items":{"type":"string","description":"Items separated by | or newline, or a JSON array of strings; at most 100 items of 100 characters"},"style":{"type":"string","description":"long (default), short or narrow"},"locale":{"type":"string","description":"BCP47 tag such as en-US, en-GB, es, de (default en-US)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"asOf":{"type":["null","string"]},"locale":{"type":["null","string"]},"source":{"type":["null","string"]},"reasons":{"type":["array","null"]},"summary":{"type":["null","string"]},"verdict":{"type":["null","string"]},"degraded":{"type":["boolean","null"]},"formatted":{"type":["null","string"]},"itemCount":{"type":["null","number"]},"disclaimer":{"type":["null","string"]},"icuVersion":{"type":["null","string"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"cldrVersion":{"type":["null","string"]},"resolvedLocale":{"type":["null","string"]},"unicodeVersion":{"type":["null","string"]}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_ErTEm7PV90fxc6BsBgXKF","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Joins a list of items into a natural-language list string (e.g. 'a, b, and c' or 'a, b, or c') formatted according to a specified locale and style.","exampleAgentPrompt":"Format the list ['apples', 'bananas', 'cherries'] as a natural-language conjunction list in Spanish (es) using the long style — give me the 'a, b y c' style output.","exampleUseCases":[{"title":"Localized product feature list","prompt":"I have a list of product features — 'Fast delivery', 'Free returns', 'Price match guarantee' — and I need them joined into a single sentence fragment with 'and' for a German (de) audience. Can you format that as a natural-language list?"},{"title":"Multilingual UI copy generation","prompt":"Can you take these options — 'Email', 'SMS', 'Push notification' — and format them as an 'or' disjunction list for an en-GB locale so I can drop it into UI copy like 'Choose Email, SMS, or Push notification'?"},{"title":"Narrow-style list for Japanese locale","prompt":"Join these items — '東京', '大阪', '京都' — into a short-style natural-language list for the ja locale. I need the compact narrow format for a mobile UI label."}],"resultDescription":"Returns a formatted string (e.g. 'a, b, and c') along with metadata including the resolved locale, item count, ICU version, CLDR version, Unicode version, and any degradation notices or disclaimers.","failureModes":["More than 100 items submitted — items list exceeds the maximum allowed count","Individual item exceeds 100 characters — truncation or rejection","Invalid BCP47 locale tag — locale may fall back to en-US or return an error","Invalid conjunction type or style value — defaults may be applied or error returned","Malformed items string — missing pipe/newline delimiters or invalid JSON array"],"whenToPreferThis":"Choose this endpoint when you need locale-aware natural-language list formatting (conjunction or disjunction) across multiple languages and locales, particularly when Unicode CLDR rules matter. Prefer this over simple string join operations when the output must be grammatically correct for a specific language (e.g. Spanish 'y', German 'und', Japanese list styles) or when you need short/narrow style variants for compact UIs.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-02T12:31:12.067Z","isFirstParty":false,"canonicalSlug":"locale-and-formatting-tools-list-formatter-a4067158"}