{"id":"id-kind","title":"Identify an identifier's kind: UUID version, ULID, KSUID, snowflake, Stripe/GitHub/AWS prefix, EVM address, email, E.164","description":"Classifies up to 100 identifier strings by format and, where it can be read, decodes the embedded timestamp, for an agent that must not pass an id of the wrong kind to a payment, ledger or API call. Recognises UUID (RFC 9562 version and variant, nil and max), ULID, KSUID, Discord and Twitter snowflakes, EIP-55 EVM addresses (checksum verified), email (WHATWG syntax and RFC 5321 length limits), E.164 shape, Stripe object prefixes (cus_, pi_, ch_ ...), GitHub token prefixes and AWS IAM unique-id prefixes, each match citing its source. Several valid readings (an all-digit 19-digit id is both a Discord and a Twitter snowflake) return unknown with every reading; with `expect` the answer is pass or fail for that kind. A prefix match is a candidate, not proof of the vendor; nothing is looked up in any registry. Credential-shaped values (GitHub tokens, AWS access keys) are never echoed.","roi":"Sending a customer id where a payment-intent id belongs, or a checksum-less address, is a real-money error. 100 ids per $0.005, each with the source of its rule.","audience":"business","package":"money-math-kit","channels":["x402","mcp"],"endpoint":{"method":"POST","url":"https://agents.writerslogic.com/api/v1/id-kind","path":"/api/v1/id-kind","contentType":"application/json"},"price":{"amount":"0.005","currency":"USDC","network":"base","perCall":true,"failedCallsCharged":false},"inputSchema":{"type":"object","additionalProperties":false,"required":["items"],"properties":{"items":{"type":"array","minItems":1,"maxItems":100,"items":{"type":"object","required":["value"],"properties":{"value":{"type":"string","minLength":1,"maxLength":256},"expect":{"type":"string","enum":["uuid","ulid","ksuid","snowflake","evm-address","email","e164","stripe-object-id","github-token","aws-iam-unique-id"],"description":"The kind the caller needs. Then the answer is pass if the value is a valid id of that kind, fail otherwise."}},"additionalProperties":false}}}},"resultSchema":{"type":"object","properties":{"status":{"type":"string","enum":["pass","fail","unknown","unsupported"],"description":"pass: every rule held. fail: a rule was violated (see witnesses). unknown: the input lacks the evidence to decide. unsupported: outside what this engine covers. Missing evidence is never a pass."},"items":{"type":"array","items":{"type":"object","properties":{"index":{"type":"integer"},"status":{"type":"string","enum":["pass","fail","unknown","unsupported"]},"credential":{"type":"boolean","description":"True when the value looks like a secret; it is then not echoed anywhere."},"matches":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string"},"valid":{"type":"boolean"},"detail":{"type":"string"},"source":{"type":"string"},"attributes":{"type":"object","description":"Decoded fields: version, variant, timestamp, checksum, scheme, prefix, object."}}}}}}},"witnesses":{"type":"array","items":{"type":"object","properties":{"ruleId":{"type":"string"},"detail":{"type":"string"},"path":{"type":"string","description":"JSON pointer or dotted path into the input."},"offset":{"type":"integer"},"index":{"type":"integer"},"expected":{"description":"What the rule required."},"actual":{"description":"What the input had."}}}},"versions":{"type":"object","description":"Every semantic dependency of this answer (engine, tables and their as-of dates, tokenizer, calendar, rounding profile)."},"limits":{"type":"array","items":{"type":"string"}},"deterministic":{"type":"boolean","description":"Always true: pure code, no model."}}},"outputSchema":{"type":"object","properties":{"data":{"type":"object","properties":{"status":{"type":"string","enum":["pass","fail","unknown","unsupported"],"description":"pass: every rule held. fail: a rule was violated (see witnesses). unknown: the input lacks the evidence to decide. unsupported: outside what this engine covers. Missing evidence is never a pass."},"items":{"type":"array","items":{"type":"object","properties":{"index":{"type":"integer"},"status":{"type":"string","enum":["pass","fail","unknown","unsupported"]},"credential":{"type":"boolean","description":"True when the value looks like a secret; it is then not echoed anywhere."},"matches":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string"},"valid":{"type":"boolean"},"detail":{"type":"string"},"source":{"type":"string"},"attributes":{"type":"object","description":"Decoded fields: version, variant, timestamp, checksum, scheme, prefix, object."}}}}}}},"witnesses":{"type":"array","items":{"type":"object","properties":{"ruleId":{"type":"string"},"detail":{"type":"string"},"path":{"type":"string","description":"JSON pointer or dotted path into the input."},"offset":{"type":"integer"},"index":{"type":"integer"},"expected":{"description":"What the rule required."},"actual":{"description":"What the input had."}}}},"versions":{"type":"object","description":"Every semantic dependency of this answer (engine, tables and their as-of dates, tokenizer, calendar, rounding profile)."},"limits":{"type":"array","items":{"type":"string"}},"deterministic":{"type":"boolean","description":"Always true: pure code, no model."}}},"_provenance":{"type":"object","description":"C2PA-aligned manifest and W3C VC 2.0 (eddsa-jcs-2022) issued by the hub DID; verify at POST /api/v1/verify-provenance"}},"required":["data","_provenance"]},"example":{"items":[{"value":"018f3b1a-7c2e-7a1b-9d3e-0123456789ab"},{"value":"cus_NffrFeUfNV2Hib","expect":"stripe-object-id"},{"value":"175928847299117063"},{"value":"pi_3MtwBwLkdIwHu7ix28a3tqPa","expect":"uuid"}]},"openapiOperation":{"operationId":"id_kind","summary":"Identify an identifier's kind: UUID version, ULID, KSUID, snowflake, Stripe/GitHub/AWS prefix, EVM address, email, E.164","description":"Classifies up to 100 identifier strings by format and, where it can be read, decodes the embedded timestamp, for an agent that must not pass an id of the wrong kind to a payment, ledger or API call. Recognises UUID (RFC 9562 version and variant, nil and max), ULID, KSUID, Discord and Twitter snowflakes, EIP-55 EVM addresses (checksum verified), email (WHATWG syntax and RFC 5321 length limits), E.164 shape, Stripe object prefixes (cus_, pi_, ch_ ...), GitHub token prefixes and AWS IAM unique-id prefixes, each match citing its source. Several valid readings (an all-digit 19-digit id is both a Discord and a Twitter snowflake) return unknown with every reading; with `expect` the answer is pass or fail for that kind. A prefix match is a candidate, not proof of the vendor; nothing is looked up in any registry. Credential-shaped values (GitHub tokens, AWS access keys) are never echoed.\n\nPrice: 0.005 USDC on Base (x402).","x-x402-price-usdc":"0.005","x-x402-amount":"5000","x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.005"}},"x-audience":"business","x-sample-url":"https://agents.writerslogic.com/api/v1/samples/id-kind","security":[{"x402":[]},{"apiKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["items"],"properties":{"items":{"type":"array","minItems":1,"maxItems":100,"items":{"type":"object","required":["value"],"properties":{"value":{"type":"string","minLength":1,"maxLength":256},"expect":{"type":"string","enum":["uuid","ulid","ksuid","snowflake","evm-address","email","e164","stripe-object-id","github-token","aws-iam-unique-id"],"description":"The kind the caller needs. Then the answer is pass if the value is a valid id of that kind, fail otherwise."}},"additionalProperties":false}}}},"example":{"items":[{"value":"018f3b1a-7c2e-7a1b-9d3e-0123456789ab"},{"value":"cus_NffrFeUfNV2Hib","expect":"stripe-object-id"},{"value":"175928847299117063"},{"value":"pi_3MtwBwLkdIwHu7ix28a3tqPa","expect":"uuid"}]}}}},"responses":{"200":{"description":"Paid result with provenance","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"status":{"type":"string","enum":["pass","fail","unknown","unsupported"],"description":"pass: every rule held. fail: a rule was violated (see witnesses). unknown: the input lacks the evidence to decide. unsupported: outside what this engine covers. Missing evidence is never a pass."},"items":{"type":"array","items":{"type":"object","properties":{"index":{"type":"integer"},"status":{"type":"string","enum":["pass","fail","unknown","unsupported"]},"credential":{"type":"boolean","description":"True when the value looks like a secret; it is then not echoed anywhere."},"matches":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string"},"valid":{"type":"boolean"},"detail":{"type":"string"},"source":{"type":"string"},"attributes":{"type":"object","description":"Decoded fields: version, variant, timestamp, checksum, scheme, prefix, object."}}}}}}},"witnesses":{"type":"array","items":{"type":"object","properties":{"ruleId":{"type":"string"},"detail":{"type":"string"},"path":{"type":"string","description":"JSON pointer or dotted path into the input."},"offset":{"type":"integer"},"index":{"type":"integer"},"expected":{"description":"What the rule required."},"actual":{"description":"What the input had."}}}},"versions":{"type":"object","description":"Every semantic dependency of this answer (engine, tables and their as-of dates, tokenizer, calendar, rounding profile)."},"limits":{"type":"array","items":{"type":"string"}},"deterministic":{"type":"boolean","description":"Always true: pure code, no model."}}},"_provenance":{"type":"object","description":"C2PA-aligned manifest and W3C VC 2.0 (eddsa-jcs-2022) issued by the hub DID; verify at POST /api/v1/verify-provenance"}},"required":["data","_provenance"]}}}},"400":{"description":"Invalid request (no payment consumed)","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"401":{"description":"Invalid X-API-KEY","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"402":{"description":"Payment required or invalid","content":{"application/json":{"schema":{"type":"object","description":"x402 v2 PaymentRequired (also base64 in the PAYMENT-REQUIRED header)","properties":{"x402Version":{"type":"integer"},"error":{"type":"string"},"code":{"type":"string"},"resource":{"type":"object"},"accepts":{"type":"array","items":{"type":"object"}},"extensions":{"type":"object"}}}}}},"502":{"description":"Upstream failure; the payment is released or not settled","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}}}},"links":{"docs":"https://agents.writerslogic.com/docs/id-kind/","docsJson":"https://agents.writerslogic.com/docs/id-kind.json","sample":"https://agents.writerslogic.com/api/v1/samples/id-kind","openapi":"https://agents.writerslogic.com/openapi.json","catalog":"https://agents.writerslogic.com/api/v1/catalog","verifyProvenance":"https://agents.writerslogic.com/api/v1/verify-provenance","index":"https://agents.writerslogic.com/docs/index.json"}}