Consumer API Reference

Explore the details of the Stytch API. Our authentication API is organized around REST principles and has resource-oriented URLs, returns JSON-encoded responses, and uses standard HTTP response codes, authentication, and verbs.

All API resources are scoped to the Project of the API keys you provide.

API keys

The Stytch API uses basic authentication with your project_id and secret from the API Keys section in the Dashboard. You'll need to pass these values into the Authorization request header for every Stytch API call.


For every Stytch project, there are two environments, TEST and LIVE, and each have their own API root URLs, and respectively.

All resources and data objects are tied to the environment they were created in. Also, the ids include their respective environment. For example, user-test-16d9ba61-97a1-4ba4-9720-b03761dc50c6 indicates a User was created in the TEST environment.