{"uid":"cap_rlMyfTLeIR1-vdQoNv8Yo","slug":"emoji-tools-skin-tone-variants-ddbbcb55","name":"Emoji Tools – Skin Tone Variants","description":"The five skin-tone variants (light to dark) of a base emoji with code points and names, or why it has none.","url":"https://emoji-tools.x402tookit.com/emoji-skin-tones?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":["emoji"],"properties":{"emoji":{"type":"string","description":"A base emoji (the waving hand), or one of its toned variants, or its name"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"asOf":{"type":["null","string"]},"base":{"type":["null","object"],"properties":{"name":{"type":["null","string"]},"emoji":{"type":["null","string"]},"group":{"type":["null","string"]},"status":{"type":["null","string"]},"subgroup":{"type":["null","string"]},"codepoints":{"type":["array","null"],"items":{"type":"string"}},"emojiVersion":{"type":["null","string"]}}},"source":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"summary":{"type":["null","string"]},"verdict":{"type":["null","string"]},"degraded":{"type":["boolean","null"]},"variants":{"type":["array","null"],"items":{"type":"object","properties":{"name":{"type":["null","string"]},"tone":{"type":["null","string"]},"emoji":{"type":["null","string"]},"codepoints":{"type":["array","null"],"items":{"type":"string"}}}}},"modifiers":{"type":["array","null"],"items":{"type":"object","properties":{"tone":{"type":["null","string"]},"modifier":{"type":["null","string"]},"codepoint":{"type":["null","string"]},"fitzpatrick":{"type":["null","string"]}}}},"disclaimer":{"type":["null","string"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"attribution":{"type":["null","string"]},"mixedToneVariantCount":{"type":["null","number"]},"supportsToneModifiers":{"type":["boolean","null"]}}}}}}},"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_XbHXDxnnAMFExcRTOdfsG","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":"Returns the five skin-tone variants (light to dark) of a base emoji, including their codepoints and names, or explains why the emoji does not support skin-tone modifiers.","exampleAgentPrompt":"What are all five skin-tone variants of the waving hand emoji 👋 — give me each variant's name, character, and codepoints, or tell me if it doesn't support tone modifiers.","exampleUseCases":[{"title":"Accessibility audit for emoji picker","prompt":"I'm building an emoji picker and need to know all five skin-tone variants of the thumbs up emoji 👍 — can you list each one with its name and Unicode codepoints?"},{"title":"Checking if an emoji supports tones","prompt":"Does the 🌍 globe emoji support skin-tone modifiers? If not, explain why."},{"title":"Resolving a toned variant back to its base","prompt":"I have the emoji 🙏🏾 — can you tell me the skin-tone variants available for its base emoji, along with the Fitzpatrick modifier codepoints used?"}],"resultDescription":"Returns an object containing the base emoji's metadata, a list of up to five skin-tone variants each with their emoji character, tone label, name, and codepoints, the Fitzpatrick modifier codepoints used, a boolean indicating whether tone modifiers are supported, and if not supported, an array of reasons explaining why.","failureModes":["Emoji not recognized — returns null base or error if the input string is not a valid emoji or name","No skin-tone variants — returns supportsToneModifiers: false with reasons array if the emoji inherently cannot be skin-toned","Input is already a toned variant — endpoint resolves to the base and still returns all five variants","Malformed query param — missing or empty 'emoji' param returns a validation error","Degraded response — partial data returned with degraded: true flag if upstream Unicode data is incomplete"],"whenToPreferThis":"Use this endpoint when you specifically need the full set of five Fitzpatrick skin-tone variants for a single emoji, including their individual codepoints and names, or when you need to determine programmatically whether a given emoji supports skin-tone modification and why. Prefer it over general emoji lookup endpoints (which return single-emoji facts) when your task involves rendering, accessibility review, or building an emoji picker that must enumerate tone variants.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-02T12:30:50.264Z","isFirstParty":false,"canonicalSlug":"emoji-tools-skin-tone-variants-ddbbcb55"}