{"api_name":"Clerk APIs","docs_url":"https://clerk.com/docs/reference/api/overview","domain":"clerk.com","generated_at":"2026-10-05T21:05:20.746894+00:00","agent_readiness_score":70,"certification_level":"Yoofooz Ready","agent_commerce_score":20,"agent_commerce_level":"Agent Commerce Not Yet Detected","agent_commerce":{"generated_at":"2026-10-05T21:05:20.590725+00:00","agent_commerce_score":20,"agent_commerce_level":"Agent Commerce Not Yet Detected","machine_payment_capable":false,"detected_protocols":[],"category_scores":{"mcp_support":0,"agent_identity_auth":5,"machine_payments":0,"machine_pricing":0,"budget_controls":5,"agent_rate_controls":0,"deterministic_errors":0,"auditability":0,"agent_security":5,"agent_observability":5},"strengths":[],"gaps":["MCP support","Machine-native payments","Machine-readable consumption pricing","Agent rate and quota controls","Deterministic machine-readable errors","Auditability / receipts / traceability"],"matched_signals":{"mcp_support":{"score":0,"matched_terms":[]},"agent_identity_auth":{"score":5,"matched_terms":["oauth","authorization","scopes","access token"]},"machine_payments":{"score":0,"matched_terms":[]},"machine_pricing":{"score":0,"matched_terms":["pricing"]},"budget_controls":{"score":5,"matched_terms":["spend","limit"]},"agent_rate_controls":{"score":0,"matched_terms":[]},"deterministic_errors":{"score":0,"matched_terms":["errors"]},"auditability":{"score":0,"matched_terms":[]},"agent_security":{"score":5,"matched_terms":["security","permissions","policy","scopes"]},"agent_observability":{"score":5,"matched_terms":["metrics","usage","dashboard","monitoring"]}},"evidence_signals":{"agent_identity_auth":[{"source_url":"https://clerk.com/docs/reference/api/overview","matched_terms":["authorization"],"snippet":",\\\\\\\"description\\\\\\\":\\\\\\\"Clerk is a user management platform providing drop-in UI components, flexible APIs, and admin dashboards for authentication, authorization, and billing.\\\\\\\",\\\\\\\"url\\\\\\\":\\\\\\\"https://clerk.com\\\\\\\",\\\\\\\"logo\\\\\\\": ,\\\\\\\"contactPoint\\\\\\\":[ ,{\\\\\\\"@type\\\\\\\":\\\\\\\"ContactPoint\\\\\\\",\\\\\\\"contactT"},{"source_url":"https://clerk.com/docs/reference/frontend-api","matched_terms":["oauth","authorization","scopes","access token"],"snippet":"nown endpoints like JWKS, deep linking, and openid-configuration.\\n - name: Health\\n description: Used to get the health status of the API.\\n - name: OAuth2 Identity Provider\\n description: Requests for the OAuth2 authorization flow.\\n - name: OAuth2 Callbacks\\n description: Used to receive callbacks from successful..."}],"machine_pricing":[{"source_url":"https://clerk.com/user-authentication","matched_terms":["pricing"],"snippet":"Skip to main content Products Docs Changelog Company AI Pricing Sign in Sign up Sign out Dashboard User Authentication User Authentication Enterprise Authentication Multi-tenancy Billing Components Docs Waitlist The easiest way to bu"},{"source_url":"https://clerk.com/react-authentication","matched_terms":["pricing"],"snippet":"Skip to main content Products Docs Changelog Company AI Pricing Sign in Sign up Sign out Dashboard React Authentication Authentication optimized for React Implement authentication and user management the React way - with hooks and co"}],"budget_controls":[{"source_url":"https://clerk.com/docs/reference/frontend-api","matched_terms":["limit"],"snippet":"Must be registered for\\n the OAuth application.\\n schema:\\n type: string\\n format: uri\\n - name: scope\\n in: query\\n required: false\\n style: spaceDelimited\\n explode: false\\n description: \\u003e\\n Space-separated list of scopes being requested.\\n\\n Available scopes are `email`, `profile`, `openid`,\\n..."},{"source_url":"https://clerk.com/docs/reference/backend-api","matched_terms":["limit"],"snippet":"eprecated and will be removed in future\\n versions.\\n parameters:\\n - $ref: \\\"#/components/parameters/Paginated\\\"\\n - $ref: \\\"#/components/parameters/LimitParameter\\\"\\n - $ref: \\\"#/components/parameters/OffsetParameter\\\"\\n responses:\\n \\\"200\\\":\\n $ref: \\\"#/components/responses/Client.List\\\"\\n \\\"400\\\":\\n $ref:..."}],"deterministic_errors":[{"source_url":"https://clerk.com/docs/reference/frontend-api","matched_terms":["errors"],"snippet":"[]\\n tags:\\n - Well Known\\n responses:\\n \\\"200\\\":\\n $ref: \\\"#/components/responses/WellKnown.JWKS\\\"\\n \\\"500\\\":\\n $ref: \\\"#/components/responses/ClerkErrors\\\"\\n /.well-known/apple-app-site-association:\\n get:\\n summary: Apple App Site Association\\n description: Retrieve the Apple App Site Association file of the..."},{"source_url":"https://clerk.com/docs/reference/backend-api","matched_terms":["errors"],"snippet":"/parameters/OffsetParameter\\\"\\n responses:\\n \\\"200\\\":\\n $ref: \\\"#/components/responses/Client.List\\\"\\n \\\"400\\\":\\n $ref: \\\"#/components/responses/ClerkErrors\\\"\\n \\\"401\\\":\\n $ref: \\\"#/components/responses/AuthenticationInvalid\\\"\\n \\\"410\\\":\\n $ref: \\\"#/components/responses/DeprecatedEndpoint\\\"\\n \\\"422\\\":\\n $ref:..."}],"agent_security":[{"source_url":"https://clerk.com/docs/reference/api/overview","matched_terms":["security","policy"],"snippet":"tups Students LLM Leaderboard Company About Careers Blog Contact Brand assets Articles Legal Terms and conditions Privacy policy Website terms of use Security Legal Resources Do Not Sell or Share My Personal Information Cookie manager © 2026 Clerk, Inc. Support Copy as markdown Copy as markdown..."},{"source_url":"https://clerk.com/docs/reference/frontend-api","matched_terms":["security","scopes"],"snippet":"erview).\\n\\n\\n Using the Try It Console\\n\\n\\n The `Try It` feature of the docs only works for **Development Instances**\\n when using the `DevBrowser` security scheme.\\n\\n To use it, first generate a dev instance token from the `/v1/dev_browser`\\n endpoint.\\n\\n\\n Please see https://clerk.com/docs for more..."}],"agent_observability":[{"source_url":"https://clerk.com/docs/reference/api/overview","matched_terms":["dashboard"],"snippet":"Skip to main content Docs Core 3 Core 3 Core 2 Core 1 Search documentation Ask AI Dashboard Dashboard Sign Up Sign Up Select your SDK Next.js React Expo TanStack React Start React Router Express Android Astro Chrome Extension C# Electron Fastify Go iOS Java JS"},{"source_url":"https://clerk.com/docs/reference/backend-api","matched_terms":["usage"],"snippet":"tity\\\"\\n /email_addresses/ :\\n get:\\n operationId: GetEmailAddress\\n x-speakeasy-group: emailAddresses\\n x-speakeasy-name-override: get\\n x-speakeasy-usage-example: true\\n tags:\\n - Email Addresses\\n summary: Retrieve an email address\\n description: Returns the details of an email address.\\n parameters:\\n - name:..."}]},"scoring_signals":{"docs_fetched":true,"pages_fetched":11,"candidate_pages":11,"fetched_urls":["https://clerk.com/docs/reference/api/overview","https://clerk.com/docs/reference/api/overview.md","https://clerk.com/docs/reference/frontend-api","https://clerk.com/docs/reference/backend-api","https://clerk.com/docs/reference/platform-api","https://clerk.com/user-authentication","https://clerk.com/react-authentication","https://clerk.com/docs/reference/components/authentication/sign-in","https://clerk.com/docs/reference/components/authentication/oauth-consent","https://clerk.com/docs/nextjs/reference/components/authentication/oauth-consent","https://clerk.com/docs/react/reference/components/authentication/oauth-consent"],"scoring_source":"YoofoozBot bounded crawl"},"methodology":{"separate_from_agent_readiness":true,"category_count":10,"category_scale":[0,5,10],"max_score":100,"evidence_required_for_public_claims":true}},"category_scores":{"documentation_clarity":10,"machine_readable_spec":10,"authentication_clarity":10,"error_handling":10,"rate_limit_clarity":0,"agent_safe_workflow_support":0,"sandbox_availability":0,"webhook_event_support":10,"commercial_trust":10,"developer_experience":10},"strengths":["Documentation clarity","Machine-readable specification (OpenAPI/Swagger)","Authentication model clarity","Error handling and status codes","Webhook / event support","Commercial trust (status, SLA, compliance)","Developer experience (SDKs, quickstart, CLI)"],"risks":["Rate-limit / quota behavior signal not detected in docs.","Agent-safe workflow primitives (idempotency, retries) signal not detected in docs.","Sandbox / test-mode availability signal not detected in docs."],"recommended_next_steps":["Document rate limits, quota behavior, 429 responses, and Retry-After guidance.","Document idempotency keys, test mode, dry runs, and safe retry semantics for agents.","Provide a sandbox / test mode with test API keys for safe agent testing."],"scoring_signals":{"docs_fetched":true,"docs_chars_used":90741,"pages_fetched":11,"candidate_pages":11,"fetched_urls":["https://clerk.com/docs/reference/api/overview","https://clerk.com/docs/reference/api/overview.md","https://clerk.com/docs/reference/frontend-api","https://clerk.com/docs/reference/backend-api","https://clerk.com/docs/reference/platform-api","https://clerk.com/user-authentication","https://clerk.com/react-authentication","https://clerk.com/docs/reference/components/authentication/sign-in","https://clerk.com/docs/reference/components/authentication/oauth-consent","https://clerk.com/docs/nextjs/reference/components/authentication/oauth-consent","https://clerk.com/docs/react/reference/components/authentication/oauth-consent"],"scoring_source":"yoofoozbot_crawl_documents"},"matched_signals":{"documentation_clarity":{"score":10,"matched_terms":["quickstart","parameters","request","response","examples","docs","guide","reference","overview"]},"machine_readable_spec":{"score":10,"matched_terms":["openapi","api reference","endpoints","schema"]},"authentication_clarity":{"score":10,"matched_terms":["oauth","access token","secret key","client secret","publishable key","scopes","authentication","authorization","api key","keys"]},"error_handling":{"score":10,"matched_terms":["400","401","403","404","409","500","errors"]},"rate_limit_clarity":{"score":0,"matched_terms":[]},"agent_safe_workflow_support":{"score":0,"matched_terms":["metadata"]},"sandbox_availability":{"score":0,"matched_terms":[]},"webhook_event_support":{"score":10,"matched_terms":["webhooks","webhook","events","callback","subscriptions"]},"commercial_trust":{"score":10,"matched_terms":["soc 2","support","changelog","versioning","security","compliance"]},"developer_experience":{"score":10,"matched_terms":["quickstart","sdk","cli","guides","dashboard"]}},"evidence_signals":{"documentation_clarity":[{"source_url":"https://clerk.com/docs/reference/api/overview","matched_terms":["quickstart","request","response","docs","guide","reference","overview"],"snippet":"...hildren\\\":[[\\\"precomputecode\\\",\\\"~\\\",\\\"d\\\",[\\\"navigation\\\",\\\"api\\\",\\\"atlas-public-chat\\\",\\\"feedback\\\",\\\"images\\\",\\\"links.json\\\",\\\"llms.txt\\\",\\\"md\\\",\\\"quickstart-prompt\\\",\\\"raw\\\",\\\"reference\\\",\\\"revalidate\\\",\\\"search.json\\\",\\\"search.md\\\"]],{\\\"children\\\":[[\\\"slugsegments\\\",\\\"reference/api/overview\\\",\\\"oc\\\",[\\\"s..."},{"source_url":"https://clerk.com/react-authentication","matched_terms":["quickstart","response","docs","guide"],"snippet":"...with a developer-friendly react interface. you can use our components out of the box or fully customize them to match your ui. refer to the quickstart guide to get started. how easy is it to install and configure clerk’s react sdk? run npm install @clerk/react , set up your clerk publishable key as..."}],"machine_readable_spec":[{"source_url":"https://clerk.com/docs/reference/frontend-api","matched_terms":["openapi","endpoints","schema"],"snippet":"...6fyykrkrhktc.js\\\",\\\"/_next/static/immutable/chunks/11jzb72s-pyc3.js\\\",\\\"/_next/static/immutable/chunks/00badjw1wz37s.js\\\"],\\\"fapiscalar\\\"]\\n43:t97910,openapi: 3.0.3\\ninfo:\\n title: clerk frontend api\\n version: v1\\n description: \\u003e-\\n the clerk rest frontend api, meant to be accessed from a browser or..."},{"source_url":"https://clerk.com/docs/reference/backend-api","matched_terms":["openapi","endpoints","schema"],"snippet":"...6fyykrkrhktc.js\\\",\\\"/_next/static/immutable/chunks/11jzb72s-pyc3.js\\\",\\\"/_next/static/immutable/chunks/00badjw1wz37s.js\\\"],\\\"bapiscalar\\\"]\\n42:tc0c65,openapi: 3.0.3\\ninfo:\\n title: clerk backend api\\n x-logo:\\n url: https://clerk.com/_next/image?url=%2fimages%2fclerk-logo.svg\\u0026w=96\\u0026q=75\\n..."}],"authentication_clarity":[{"source_url":"https://clerk.com/docs/reference/frontend-api","matched_terms":["oauth","access token","client secret","scopes","authentication","authorization","api key","keys"],"snippet":"...endpoints like jwks, deep linking, and openid-configuration.\\n - name: health\\n description: used to get the health status of the api.\\n - name: oauth2 identity provider\\n description: requests for the oauth2 authorization flow.\\n - name: oauth2 callbacks\\n description: used to receive callbacks..."},{"source_url":"https://clerk.com/docs/reference/backend-api","matched_terms":["oauth","access token","publishable key","authentication","authorization","api key","keys"],"snippet":"...enabling you to integrate with third-party\\n services.\\n externaldocs:\\n url: https://clerk.com/docs/request-authentication/jwt-templates\\n - name: oauth applications\\n description: oauth applications contain data for clients using clerk as an\\n oauth2 identity provider.\\n - name: oauth access..."}],"error_handling":[{"source_url":"https://clerk.com/docs/reference/backend-api","matched_terms":["400","401","403","404","409","500","errors"],"snippet":"...whether to use the domain for the script url\\n schema:\\n type: boolean\\n responses:\\n \\\"200\\\":\\n description: the interstitial page markup\\n \\\"400\\\":\\n description: a required query parameter is missing\\n \\\"500\\\":\\n description: an infinite redirect loop was detected\\n /jwks:\\n get:\\n..."},{"source_url":"https://clerk.com/docs/reference/frontend-api","matched_terms":["400","401","403","404","500","errors"],"snippet":"...or an oauth\\n error.\\n\\n an invalid `resource` returns `error=invalid_target`. the redirect\\n preserves a supplied `state` and includes `iss`.\\n \\\"400\\\":\\n description: direct bad-request response used when the authorization server\\n cannot safely return the error to the client's redirect uri.\\n..."}],"agent_safe_workflow_support":[{"source_url":"https://clerk.com/docs/reference/frontend-api","matched_terms":["metadata"],"snippet":"...\\\"#/components/responses/wellknown.openidconfiguration\\\"\\n /.well-known/oauth-authorization-server:\\n get:\\n summary: oauth 2.0 authorization server metadata\\n description: get the oauth 2.0 authorization server metadata according to rfc 8414\\n operationid: getoauth2authorizationservermetadata\\n security:..."}],"webhook_event_support":[{"source_url":"https://clerk.com/docs/reference/backend-api","matched_terms":["webhooks","webhook","events"],"snippet":"...a user that has successfully signed up\\n to your application.\\n externaldocs:\\n url: https://clerk.com/docs/references/javascript/user\\n - name: webhooks\\n description: you can configure webhooks to be notified about various events that\\n happen on your instance.\\n externaldocs:\\n url:..."},{"source_url":"https://clerk.com/docs/reference/frontend-api","matched_terms":["callback","subscriptions"],"snippet":"...to get the health status of the api.\\n - name: oauth2 identity provider\\n description: requests for the oauth2 authorization flow.\\n - name: oauth2 callbacks\\n description: used to receive callbacks from successful oauth attempts.\\n - name: saml\\n description: used in authentication flows using saml.\\n -..."}],"commercial_trust":[{"source_url":"https://clerk.com/user-authentication","matched_terms":["soc 2","support","changelog","security","compliance"],"snippet":"...flow. all out-of-the-box. build with agents ❯ add clerk auth to my app: clerk.com/skill.md add clerk auth to my app: clerk.com/skill.md soc 2 your customer data is protected to the highest security and compliance standards. hipaa hipaa-compliant for safely storing your most sensitive user..."},{"source_url":"https://clerk.com/docs/reference/api/overview","matched_terms":["support","changelog","security"],"snippet":"...privacy policy website terms of use security legal resources do not sell or share my personal information cookie manager © 2026 clerk, inc. support copy as markdown copy as markdown..."}],"developer_experience":[{"source_url":"https://clerk.com/docs/reference/api/overview","matched_terms":["quickstart","sdk","cli","guides","dashboard"],"snippet":"...hildren\\\":[[\\\"precomputecode\\\",\\\"~\\\",\\\"d\\\",[\\\"navigation\\\",\\\"api\\\",\\\"atlas-public-chat\\\",\\\"feedback\\\",\\\"images\\\",\\\"links.json\\\",\\\"llms.txt\\\",\\\"md\\\",\\\"quickstart-prompt\\\",\\\"raw\\\",\\\"reference\\\",\\\"revalidate\\\",\\\"search.json\\\",\\\"search.md\\\"]],{\\\"children\\\":[[\\\"slugsegments\\\",\\\"reference/api/overview\\\",\\\"oc\\\",[\\\"s..."},{"source_url":"https://clerk.com/docs/reference/api/overview.md","matched_terms":["sdk","cli","guides"],"snippet":"# api reference while accessing clerk functionality via sdk is the easiest path, clerk offers three different http apis for you to interact with directly. [the clerk frontend..."}]},"yoofoozbot":{"run_id":"20261005T210505Z_clerk_apis_9d9e09fe","user_agent":"YoofoozBot/1.2 (+https://yoofooz.com/yoofoozbot; contact: submit@yoofooz.com)","pages_fetched":11,"total_bytes":2097152,"robots_respected":true,"crawl_record_path":"outputs/yoofoozbot/20261005T210505Z_clerk_apis_9d9e09fe.json","spec_candidates":[],"signal_summary":{"openapi":{"detected":true,"matched_terms":["openapi"]},"authentication":{"detected":true,"matched_terms":["authentication","oauth","api key"]},"errors":{"detected":false,"matched_terms":[]},"rate_limits":{"detected":false,"matched_terms":[]},"webhooks":{"detected":true,"matched_terms":["webhook"]},"sandbox":{"detected":false,"matched_terms":[]},"agent_workflows":{"detected":true,"matched_terms":["agent"]},"developer_experience":{"detected":true,"matched_terms":["sdk","quickstart","cli"]},"commercial_trust":{"detected":true,"matched_terms":["security","sla","soc 2","compliance"]},"mcp_support":{"detected":false,"matched_terms":[]},"machine_payments":{"detected":false,"matched_terms":[]},"machine_pricing":{"detected":false,"matched_terms":[]},"budget_controls":{"detected":false,"matched_terms":[]},"agent_identity":{"detected":false,"matched_terms":[]},"auditability":{"detected":false,"matched_terms":[]},"agent_observability":{"detected":false,"matched_terms":[]}},"readiness_scoring_pages":11,"readiness_scoring_source":"yoofoozbot_crawl_documents","agent_commerce_probe":{"score":20,"level":"Agent Commerce Not Yet Detected","machine_payment_capable":false,"detected_protocols":[],"evidence_categories":["agent_identity_auth","agent_observability","agent_security","budget_controls","deterministic_errors","machine_pricing"]}}}