> ## Documentation Index > Fetch the complete documentation index at: https://docs.didit.me/llms.txt > Use this file to discover all available pages before exploring further. # API de autenticación: registro programático de cuentas > Crea organizaciones de Didit por programa con la Auth API, sin navegador. Infraestructura KYC de subcuentas, pago por llamada y sin contratos. Prompt de registro programático Copiar el prompt al portapapeles \

\``Programmatically create a pending Didit account — step 1 of the two-step onboarding (no browser, no console).

Endpoint:
POST https://apx.didit.me/auth/v2/programmatic/register/

Authentication:
None. This is a public endpoint. (Don't confuse the Auth API host `apx.didit.me/auth/v2` with the verification host `verification.didit.me/v3`.)

Request body:
\- email (string, required) — Any real, deliverable email (personal, work, alias). The verification code is mailed synchronously, so reserved test domains (`@example.com`, `@example.org`, `@*.test`, `@*.example`, `@*.invalid`) get rejected by mail delivery and the call returns `500` — substitute the placeholder with an inbox you can read.
\- password (string, required) — Must satisfy ALL of: minimum 8 characters, ≥1 uppercase letter (A-Z), ≥1 lowercase letter (a-z), ≥1 digit (0-9), ≥1 special character from !@#$%^&*()_+-=[]{}|;:,.<>?. Rules are validated one at a time and the first failure short-circuits.

curl example (replace `you@yourdomain.com` with a real inbox):
curl -X POST https://apx.didit.me/auth/v2/programmatic/register/ \
-H "Content-Type: application/json" \
-d '{
"email": "you@yourdomain.com",
"password": "MyStr0ng!Pass"
}'

Response (201 Created):
\- message (string) — "Registration successful. Check your email for the verification code."
\- email (string) — echoed back.

What happens server-side:
\- A pending account is created (NOT usable yet).
\- A 6-character alphanumeric code (e.g. "A3K9F2") is emailed to the supplied address.
\- The code is valid for 15 minutes. After expiry the registration must be redone.

Failure modes (all 400 unless noted):
\- Field-level: { "email": ["Enter a valid email address."] } or { "password": ["Ensure this field has at least 8 characters."] }.
\- Password-strength failures CURRENTLY return as a BARE ARRAY (no field key), one rule at a time: ["Password must contain at least one uppercase letter."] / lowercase / digit / special character. Known server-side inconsistency — treat as { "password": [...] } client-side.
\- Duplicate email: { "detail": "An account with this email already exists." }
\- 429 — { "detail": "Too many registration attempts. Please try again later.", "wait":  } when more than 5 registrations from the same IP within an hour.
\- 500 — returned (with an HTML body, not JSON) when mail delivery to the supplied address fails synchronously. Most commonly triggered by reserved test domains; use a real inbox.

Rate limits:
5 registrations per IP per hour.

Next step:
After receiving the email, call POST https://apx.didit.me/auth/v2/programmatic/verify-email/ with { "email", "code" } to get your access_token and api_key — see /auth-api/verify-email.

For end-to-end Didit integration, paste in the full prompt at /integration/integration-prompt.``

\
Pegar en ## OpenAPI ````yaml es/openapi-auth.json POST /programmatic/register/ openapi: 3.0.0 info: version: 1.0.0 title: Didit Auth API description: >- API de registro y autenticación programáticos para desarrolladores y agentes de IA. Regístrate en 2 llamadas a la API, sin necesidad de navegador. La plataforma de verificación de identidad más adaptada a los agentes. ## URL base Todos los endpoints de esta especificación están alojados en `https://apx.didit.me/auth/v2`. Es un host distinto al de la API de verificación (`https://verification.didit.me/v3`). No los confundas: este host de autenticación emite tus **tokens de acceso JWT** y te permite listar y gestionar tus **organizaciones** y **aplicaciones**. El host de verificación es donde llamas a sesiones, flujos, AML, etc., autenticándote con la **`api_key`** que devuelve esta API. ## Cómo funciona el flujo de autenticación 1. `POST /programmatic/register/`: envía el correo electrónico y la contraseña. 2. Recibe por correo electrónico un código alfanumérico de 6 caracteres. 3. `POST /programmatic/verify-email/`: envía el código. Recibes un `access_token` JWT, un `refresh_token`, una organización y una aplicación predeterminada con `client_id` y `api_key`. 4. Guarda la `api_key`. Úsala como `x-api-key` en cada llamada a `https://verification.didit.me/v3/...`. 5. Desde cualquier equipo en el futuro, `POST /programmatic/login/` intercambia tu correo electrónico y contraseña por un JWT nuevo; después llama a `GET /organizations/me/` y a los endpoints de aplicaciones para recuperar o rotar las credenciales. El JWT solo es necesario para los endpoints de **gestión de la cuenta** de esta especificación; el tráfico de la API de verificación usa la `api_key` de larga duración, no el JWT. ## Convenciones - Todos los cuerpos de solicitud y respuesta son JSON (`Content-Type: application/json`). - **Usa una dirección de correo electrónico real y que pueda recibir mensajes cuando pruebes `POST /programmatic/register/`.** El endpoint envía el código de verificación de forma síncrona, por lo que el servicio de entrega de correo rechaza las direcciones de dominios de prueba reservados (`@example.com`, `@example.org`, `@*.test`, `@*.example`, `@*.invalid`) y la solicitud devuelve un `500`. Sustituye el marcador `you@yourdomain.com` de los ejemplos por una bandeja de entrada que puedas leer. - Los errores de validación devuelven HTTP `400` con uno de dos formatos: `{"field": ["message", ...]}` para problemas a nivel de campo, o `{"detail": "message"}` para errores de reglas de negocio. Algunos validadores (la robustez de la contraseña en el registro y la caducidad del código en verify-email) responden actualmente con un array simple `["message"]` en lugar del formato con claves por campo; es una incoherencia conocida del servidor, por lo que el código cliente debe aceptar ambos formatos. - Los errores de autenticación se devuelven como `{"detail": "..."}` con HTTP `401` (token bearer no válido) o `403` (falta el token bearer o los privilegios son insuficientes). - Las respuestas de límite de solicitudes incluyen un campo `wait` con el tiempo de espera en segundos. servers: - url: https://apx.didit.me/auth/v2 description: Servidor de autenticación de producción security: [] tags: - name: Programmatic Auth description: >- Ciclo de vida de la cuenta con correo electrónico y contraseña: registro, verificación e inicio de sesión. Devuelve el `access_token` JWT que usas con los endpoints de gestión de cuentas y, además (al verificar), el `client_id` y la `api_key` de tu primera aplicación. - name: Account Management description: >- Endpoints autenticados (JWT bearer) que listan organizaciones y crean, obtienen o actualizan aplicaciones. Úsalos para recuperar o rotar la `api_key` con la que autenticas las llamadas a la API de verificación. paths: /programmatic/register/: post: tags: - Programmatic Auth summary: Registrar cuenta description: >- Paso 1 del onboarding programático. Crea una cuenta pendiente y envía por correo electrónico un código de 6 caracteres (válido durante 10 min). La dirección se comprueba antes de crear ninguna cuenta: una dirección que no puede recibir el código devuelve 400 `email_undeliverable`. Límites de solicitudes: 5 por IP por hora, más un cupo horario compartido por red (/24 para IPv4, /64 para IPv6). operationId: programmatic_register requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/RegisterRequest' examples: Gmail: summary: Registrarse con un Gmail personal value: email: you@yourdomain.com password: MyStr0ng!Pass Work: summary: Registrarse con un correo electrónico de trabajo value: email: you@yourcompany.com password: C0mplex#Pass1 responses: '201': description: >- Registro correcto. Se envió un código de verificación alfanumérico de 6 caracteres (p. ej., `A3K9F2`) a la dirección de correo electrónico indicada, válido durante 10 minutos. A continuación, llama a `POST /programmatic/verify-email/`. content: application/json: schema: $ref: '#/components/schemas/RegisterResponse' examples: Success: value: message: >- Registration successful. Check your email for the verification code. email: you@yourdomain.com '400': description: >- Error de validación. El formato previsto es `{"field": ["..."]}` para los errores de campo y `{"detail": "..."}` para los errores de reglas de negocio (por ejemplo, un correo electrónico duplicado). Las reglas de seguridad de la contraseña responden actualmente con un array simple `["..."]`, una regla cada vez; es una inconsistencia conocida del servidor, así que trátalo como `{"password": ["..."]}` hasta que se corrija. Cuando la dirección no puede recibir el código (dominio desechable, reservado o de prueba, sin servidor de correo, un probable error tipográfico o una dirección que ya ha rebotado antes), el cuerpo es `EmailUndeliverableError` con `code: "email_undeliverable"`; no se crea ni se modifica ninguna cuenta. content: application/json: schema: oneOf: - $ref: '#/components/schemas/ValidationError' - $ref: '#/components/schemas/EmailUndeliverableError' examples: MissingFields: summary: Cuerpo vacío value: email: - This field is required. password: - This field is required. InvalidEmail: summary: Correo electrónico con formato incorrecto value: email: - Enter a valid email address. PasswordTooShort: summary: Contraseña de menos de 8 caracteres value: password: - Ensure this field has at least 8 characters. PasswordMissingUppercase: summary: Contraseña sin ninguna letra mayúscula value: - Password must contain at least one uppercase letter. PasswordMissingLowercase: summary: Contraseña sin ninguna letra minúscula value: - Password must contain at least one lowercase letter. PasswordMissingDigit: summary: Contraseña sin ningún dígito value: - Password must contain at least one digit. PasswordMissingSpecial: summary: Contraseña sin ningún carácter especial value: - >- Password must contain at least one special character (!@#$%^&*()_+-=[]{}|;:,.<>?). Duplicate: summary: El correo electrónico ya tiene una cuenta value: detail: An account with this email already exists. EmailUndeliverable: summary: >- La dirección no puede recibir correo electrónico (dominio desechable) value: detail: >- This email can't receive messages. Please use a different email address. code: email_undeliverable reason: disposable_domain EmailLikelyTypo: summary: Probable error tipográfico en el dominio value: detail: >- This email can't receive messages. Please use a different email address. code: email_undeliverable reason: possible_typo suggestion: gmail.com '429': description: >- Límite de solicitudes alcanzado. Hubo más de 5 intentos de registro desde la misma IP en la última hora, o se agotó el cupo por hora de la red del llamante (/24 para IPv4, /64 para IPv6, compartido por el registro y los reenvíos de código). Ambos casos incluyen `Retry-After: 3600`. También se devuelve, con un encabezado `Retry-After: 5`, cuando el servicio está comprobando en ese momento tantas contraseñas o códigos como puede a la vez; reintenta después del número de segundos indicado. content: application/json: schema: $ref: '#/components/schemas/RateLimitError' examples: RateLimited: value: detail: Too many registration attempts. Please try again later. PasswordChecksBusy: summary: Demasiadas comprobaciones de contraseña en curso value: detail: >- Too many sign-in attempts are being processed right now. Please try again in a few seconds. security: - {} x-codeSamples: - lang: curl label: cURL source: |- curl -X POST https://apx.didit.me/auth/v2/programmatic/register/ \ -H "Content-Type: application/json" \ -d '{ "email": "you@yourdomain.com", "password": "MyStr0ng!Pass" }' - lang: python label: Python source: |- from didit import Didit # This call needs no API key. client = Didit() result = client.account.register( email="you@yourdomain.com", password="MyStr0ng!Pass", ) print(result) - lang: javascript label: Node.js source: |- import Didit from "@didit-protocol/sdk-node"; // This call needs no API key. const didit = new Didit(); const result = await didit.account.register({ email: "you@yourdomain.com", password: "MyStr0ng!Pass", }); console.log(result); - lang: go label: Go source: "ctx := context.Background()\n// This call needs no API key.\nclient := didit.NewClient()\n\nresult, err := client.Account.Register(ctx, didit.RegisterRequest{\n\tEmail: \"you@yourdomain.com\",\n\tPassword: \"MyStr0ng!Pass\",\n})\nif err != nil {\n\tlog.Fatal(err)\n}\nfmt.Printf(\"%+v\\n\", result)" - lang: java label: Java source: |- import me.didit.Didit; import me.didit.types.RegisterRequest; // This call needs no API key. Didit client = new Didit(); var result = client.account().register(RegisterRequest.builder() .email("you@yourdomain.com") .password("MyStr0ng!Pass") .build()); System.out.println(result); - lang: php label: PHP source: |- account->register([ 'email' => 'you@yourdomain.com', 'password' => 'MyStr0ng!Pass', ]); print_r($result->toArray()); - lang: ruby label: Ruby source: |- require "didit" # This call needs no API key. didit = Didit::Client.new result = didit.account.register( email: "you@yourdomain.com", password: "MyStr0ng!Pass" ) puts result.to_h - lang: csharp label: .NET source: |- using System; using System.Text.Json; using Didit; // This call needs no API key. using var client = new DiditClient(); var result = await client.Account.RegisterAsync(new RegisterRequest { Email = "you@yourdomain.com", Password = "MyStr0ng!Pass", }); Console.WriteLine(JsonSerializer.Serialize(result)); components: schemas: RegisterRequest: type: object required: - email - password properties: email: type: string format: email description: >- Cualquier dirección de correo electrónico válida (personal, del trabajo, alias). Se usa como identificador único de la cuenta. example: you@yourdomain.com password: type: string minLength: 8 description: >- Mínimo 8 caracteres. Debe contener al menos una letra mayúscula (`A-Z`), una letra minúscula (`a-z`), un dígito (`0-9`) y un carácter especial de `!@#$%^&*()_+-=[]{}|;:,.<>?`. La validación informa de una regla incumplida a la vez. example: MyStr0ng!Pass RegisterResponse: type: object properties: message: type: string description: Confirmación legible de que se envió el código de verificación. example: Registration successful. Check your email for the verification code. email: type: string format: email description: El correo electrónico al que se envió el código de verificación. example: you@yourdomain.com ValidationError: description: >- Cuerpo del error de validación. El formato previsto es un mapa `{field: ["message", ...]}` para los errores a nivel de campo o un formato de una sola clave `{detail: "..."}` para los errores de reglas de negocio. Algunos validadores (la seguridad de la contraseña en el registro y la validez del código en la verificación del correo electrónico) responden actualmente con un array simple `["message"]`: es una inconsistencia conocida del servidor. El esquema siguiente conserva esa variante de array simple para que el código cliente generado a partir de esta especificación deserialice las respuestas actuales, pero el código cliente nuevo debe tratarla como la forma indexada por el campo correspondiente (`{password: [...]}` o `{code: [...]}`), y el contrato del servidor convergerá en esa forma. oneOf: - type: object additionalProperties: type: array items: type: string example: email: - Enter a valid email address. - type: object properties: detail: type: string example: detail: An account with this email already exists. - type: array items: type: string example: - Invalid or expired verification code. EmailUndeliverableError: type: object description: >- Lo devuelve `POST /programmatic/register/` cuando la dirección no puede recibir el código de verificación. La comprobación se ejecuta antes de crear o modificar ninguna cuenta, así que no queda nada pendiente. required: - detail - code - reason properties: detail: type: string description: Mensaje legible. example: >- This email can't receive messages. Please use a different email address. code: type: string enum: - email_undeliverable description: Siempre `email_undeliverable`. reason: type: string enum: - invalid_address - reserved_domain - no_mail_records - disposable_domain - possible_typo - suppressed description: >- Por qué se rechazó la dirección: `invalid_address` (no es una dirección válida), `reserved_domain` (un dominio reservado o de prueba como `example.com`), `no_mail_records` (el dominio no tiene servidor de correo), `disposable_domain` (un proveedor de buzones desechables), `possible_typo` (un probable error tipográfico de un proveedor común; consulta `suggestion`), `suppressed` (la dirección rebotó o presentó una queja anteriormente). suggestion: type: string description: >- El dominio que probablemente se quería usar, presente solo cuando el dominio parece una errata (por ejemplo, `gmail.com` para `gmial.com`). La API no acepta una confirmación: vuelve a registrar la dirección corregida. example: gmail.com RateLimitError: type: object description: >- Respuesta de límite de solicitudes o de bloqueo progresivo. `wait` es el tiempo de espera en segundos. properties: detail: type: string example: >- Too many login attempts from this IP address. Please wait before trying again. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.