> ## 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 creació d'aplicacions: Aplicacions programàtiques

> POST /organizations/me/{org_id}/applications/ per crear una aplicació de Didit per client, marca, entorn o unitat de negoci. Retorna client_id i api_key.



Prompt per crear una aplicació
        Copia el prompt al porta-retalls



      
      

\<pre>

\`Create a new Didit application inside one of your organizations — each application has its own client_id and api_key, isolating sessions, webhooks, branding, and billing from sibling applications.

Endpoint:
POST https://apx.didit.me/auth/v2/organizations/me/{org_id}/applications/

Authentication:
Authorization: Bearer <access_token>
The access token must belong to an OWNER or ADMIN of the target organization. Get one via POST /programmatic/login/ or POST /programmatic/verify-email/.

Path parameter:
\- org_id (UUID, required) — Organization that will own the new application. Discover yours via GET /organizations/me/.

Request body (ALL fields optional — omit the body to get a default-named app):
\- name (string, optional) — Display name. Defaults to "<organization name> App".
\- website_url (string, URL, optional) — Public homepage shown in the verification flow.
\- redirect_uris (array of strings, optional) — Allowlisted OAuth-style redirect URIs.
\- terms_url (string, URL, optional) — Terms-of-service link shown in the verification UI.
\- privacy_url (string, URL, optional) — Privacy policy link shown in the verification UI.
\- description (string, optional) — Internal note. Not shown to end users.
\- data_location (string, optional) — Where the application's verification data is stored and processed: "eu" (European Union, Ireland), the default. "au" (Australia, Sydney) and "mx" (Mexico) are coming soon and answer 400 today. Chosen once: it can't be changed after the application is created.

When to call:
\- Resellers — one application per end customer to fully isolate credentials, branding, webhooks, and billing.
\- Multi-brand / multi-product — one application per brand, product, region, or environment (dev / staging / prod).
\- Use-case separation — e.g. one application for ID + selfie KYC, another for AML screening only.

curl example:
curl -X POST "https://apx.didit.me/auth/v2/organizations/me/<ORG_ID>/applications/" \
-H "Authorization: Bearer <ACCESS_TOKEN>" \
-H "Content-Type: application/json" \
-d '{
"name": "Acme Customer App",
"website_url": "https://acme.example",
"redirect_uris": ["https://acme.example/callback"],
"terms_url": "https://acme.example/terms",
"privacy_url": "https://acme.example/privacy",
"data_location": "eu"
}'

Response (201 Created):
\{
"uuid": "b2c3d4e5-6789-...",
"name": "Acme Customer App",
"client_id": "S9LIYGSoWNuGMLHsvEt9dQ",
"api_key": "sk_live_example_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"website_url": "https://acme.example",
"redirect_uris": ["https://acme.example/callback"],
"terms_url": "https://acme.example/terms",
"privacy_url": "https://acme.example/privacy",
"description": null,
"created_at": "2025-06-01T10:00:00Z",
"data_location": "eu",
"products": [
\{ "product": "identity", "status": "enabled", "modules": { "user_verification": true, "business_verification": true, "case_management": true } },
\{ "product": "transactions", "status": "disabled", "modules": { "travel_rule": true, "case_management": true } },
\{ "product": "authentication", "status": "disabled", "modules": {} }
]
}

What to do with the response:
\- PERSIST api_key SECURELY — use it as the x-api-key header on every https://verification.didit.me/v3/... call (sessions, workflows, billing).
\- Persist uuid (app_id) — required for /organizations/me/{org_id}/applications/{app_id}/ reads and updates.
\- If you lose the api_key, recover it later via GET /organizations/me/{org_id}/applications/{app_id}/ — see /auth-api/get-credentials.
\- products is read-only and always lists identity, transactions and authentication in that order. A new application has identity enabled with every module on, and transactions and authentication disabled. A products key in the request body is ignored.

Failure modes:
\- 400 — { "<field>": ["Enter a valid URL."] } for malformed website_url / redirect_uris / terms_url / privacy_url.
\- 400 — { "data_location": ["This data location is not available yet."] } for "au" or "mx", and { "data_location": ["\\"us\\" is not a valid choice."] } for a location that does not exist. Nothing is created.
\- 401: { "detail": "Invalid access token" } or { "detail": "Expired access token" } when the token is malformed or expired.
\- 403: { "detail": "Only organization owners and admins can manage applications." } when you are a member of the organization but not an owner or admin.
\- 403: { "detail": "Your access to this organization is suspended." } when your membership in the organization is suspended.
\- 403: { "detail": "You do not have permission to perform this action." } when the request has no Authorization header.
\- 404: { "detail": "Organization not found." } when the organization does not exist or you are not a member of it.

Next steps:
\- Configure a workflow inside the new application via POST /v3/workflows/ — see /management-api/workflows/create.
\- Update application metadata later via PATCH /organizations/me/{org_id}/applications/{app_id}/ — see /auth-api/update-application.

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

\</pre>



      
      

Enganxa a

Utilitza aquest endpoint quan necessitis separar el trànsit de verificació, les credencials, la marca o els informes dins de la mateixa organització.Això és especialment útil per als **revenedors** que creen una aplicació per cada client. També va molt bé quan la teva empresa té diversos productes, marques, regions, entorns de proves/producció o casos d'ús que no han de compartir la mateixa clau d'API ni la configuració a nivell d'aplicació.> [!NOTE]
>
> Tots els endpoints de l'API d'autenticació utilitzen `https://apx.didit.me/auth/v2`. Utilitza el `api_key` retornat com a `x-api-key` quan cridis els endpoints de `https://verification.didit.me/v3/...`, com les sessions i els fluxos de treball.## Ubicació de les dadesCada aplicació emmagatzema i processa les seves dades de verificació en una única ubicació, la seva ubicació de les dades, que es tria en crear-la amb `data_location`.
Avui l'única ubicació disponible és `eu`, la Unió Europea (Irlanda), que també és la predeterminada si omets el camp.
Austràlia (Sydney, `au`) i Mèxic (`mx`) estan previstes properament: una sol·licitud que les indiqui respon amb 400 `This data location is not available yet.` i no crea res.
Cada lectura de l'aplicació retorna el seu `data_location`, i no es pot canviar després de crear-la.
Consulta [Ubicació de les dades](https://docs.didit.me/ca/console/applications.md#ubicació-de-les-dades).


## OpenAPI

````yaml ca/openapi-auth.json POST /organizations/me/{org_id}/applications/
openapi: 3.0.0
info:
  version: 1.0.0
  title: Didit Auth API
  description: >-
    API de registre i autenticació programàtica per a desenvolupadors i agents
    d'IA. Registra't en 2 crides d'API -- sense necessitat de navegador. La
    plataforma de verificació d'identitat més adaptada a agents.


    ## Base URL


    Tots els endpoints d'aquesta especificació estan allotjats a
    `https://apx.didit.me/auth/v2`. És un amfitrió diferent del de l'API de
    verificació (`https://verification.didit.me/v3`). Tingues-ho en compte:
    aquest amfitrió d'autenticació emet els teus **tokens d'accés JWT** i et
    permet llistar i gestionar les teves **organitzacions** i **aplicacions**.
    L'amfitrió de verificació és on crides sessions, fluxos de treball, AML,
    etc., i t'hi autentiques amb la **`api_key`** que retorna aquesta API.


    ## Com funciona el flux d'autenticació


    1. `POST /programmatic/register/` — envia correu electrònic + contrasenya.

    2. Rep un codi alfanumèric de 6 caràcters per correu electrònic.

    3. `POST /programmatic/verify-email/` — envia el codi. Reps com a resposta
    un `access_token` JWT, un `refresh_token`, una organització i una aplicació
    predeterminada amb `client_id` + `api_key`.

    4. Guarda la `api_key`. Fes-la servir com a `x-api-key` per a cada crida a
    `https://verification.didit.me/v3/...`.

    5. Des de qualsevol màquina en el futur, `POST /programmatic/login/`
    bescanvia el teu correu electrònic + contrasenya per un JWT nou; després
    crida `GET /organizations/me/` i els endpoints d'aplicació per recuperar o
    rotar credencials.


    El JWT només és necessari per als endpoints de **Gestió de comptes**
    d'aquesta especificació; el trànsit de l'API de verificació utilitza la
    `api_key` de llarga durada, no el JWT.


    ## Convencions


    - Tots els cossos de sol·licitud i resposta són JSON (`Content-Type:
    application/json`).

    - **Utilitza una adreça de correu electrònic real i que pugui rebre
    missatges quan provis `POST /programmatic/register/`.** L'endpoint envia el
    codi de verificació de manera síncrona, de manera que les adreces en dominis
    de prova reservats (`@example.com`, `@example.org`, `@*.test`, `@*.example`,
    `@*.invalid`) són rebutjades pel lliurament de correu i la sol·licitud
    retorna un `500`. Substitueix el marcador de posició `you@yourdomain.com`
    dels exemples per una bústia d'entrada que puguis llegir realment.

    - Els errors de validació retornen HTTP `400` amb un d'aquests dos formats:
    `{"field": ["message", ...]}` per a problemes a nivell de camp, o
    `{"detail": "message"}` per a errors de regles de negoci. Alguns validadors
    (robustesa de la contrasenya en registrar-se, caducitat del codi en
    verificar el correu) responen actualment amb una matriu simple `["message"]`
    en lloc del format amb clau de camp -- es tracta d'una inconsistència
    coneguda del servidor, de manera que el codi del client hauria d'acceptar
    ambdós formats.

    - Els errors d'autenticació es retornen com a `{"detail": "..."}` amb HTTP
    `401` (token de portador no vàlid) o `403` (manca el token de portador /
    privilegis insuficients).

    - Les respostes de límit de freqüència inclouen un camp `wait` amb el temps
    d'espera en segons.
servers:
  - url: https://apx.didit.me/auth/v2
    description: Servidor d'autenticació de producció
security: []
tags:
  - name: Programmatic Auth
    description: >-
      Cicle de vida del compte amb correu electrònic i contrasenya: registre,
      verificació, inici de sessió. Retorna el `access_token` JWT que utilitzes
      amb els endpoints de Gestió de comptes, a més (en verificar) del
      `client_id` i la `api_key` de la teva primera aplicació.
  - name: Account Management
    description: >-
      Endpoints autenticats (Bearer JWT) que llisten organitzacions i creen,
      obtenen o actualitzen aplicacions. Utilitza'ls per recuperar o rotar la
      `api_key` amb la qual autentiques les crides a l'API de verificació.
paths:
  /organizations/me/{org_id}/applications/:
    post:
      tags:
        - Account Management
      summary: Crear aplicació
      description: >-
        Crea una aplicació dins d'una organització, a la ubicació de les dades
        que triïs (`data_location`, la Unió Europea per defecte; no es pot
        modificar posteriorment). La resposta inclou `api_key`; desa-la ara (es
        pot recuperar mitjançant GET). Requereix un JWT de
        propietari/administrador.
      operationId: create_organization_application
      parameters:
        - name: org_id
          in: path
          required: true
          description: UUID de l'organització. Consulta'l amb `GET /organizations/me/`.
          schema:
            type: string
            format: uuid
            example: a1b2c3d4-5678-90ab-cdef-111111111111
      requestBody:
        required: false
        description: >-
          Tots els camps són opcionals. Ometre el cos crea una aplicació amb el
          nom per defecte `"<organization name> App"` i sense URL públiques
          configurades.
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ApplicationCreateRequest'
            examples:
              ResellerCustomer:
                summary: Distribuïdor que inicialitza una aplicació d'àmbit de client
                value:
                  name: Acme Customer App
                  website_url: https://acme.example
                  redirect_uris:
                    - https://acme.example/callback
                  terms_url: https://acme.example/terms
                  privacy_url: https://acme.example/privacy
                  data_location: eu
              Minimal:
                summary: 'Creació mínima: accepta tots els valors per defecte'
                value:
                  name: Sandbox App
              Empty:
                summary: Sense cos -- el valor per defecte és <org name> App
                value: {}
      responses:
        '201':
          description: >-
            Aplicació creada. La resposta inclou la `api_key` de llarga durada;
            desa-la ara i fes-la servir com a capçalera `x-api-key` a cada crida
            a `https://verification.didit.me/v3/...`.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Application'
              examples:
                Success:
                  value:
                    uuid: b2c3d4e5-6789-01bc-defg-222222222222
                    name: Acme Customer App
                    client_id: S9LIYGSoWNuGMLHsvEt9dQ
                    api_key: sk_live_example_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
                    website_url: https://acme.example
                    redirect_uris:
                      - https://acme.example/callback
                    terms_url: https://acme.example/terms
                    privacy_url: https://acme.example/privacy
                    description: null
                    created_at: '2025-06-01T10:00:00Z'
                    data_location: eu
                    products:
                      - product: identity
                        status: enabled
                        modules:
                          user_verification: true
                          business_verification: true
                          case_management: true
                      - product: transactions
                        status: disabled
                        modules:
                          travel_rule: true
                          case_management: true
                      - product: authentication
                        status: disabled
                        modules: {}
        '400':
          description: >-
            Error de validació al cos de la sol·licitud: per exemple, un URI de
            redirecció mal format, un `data_location` que encara no està
            disponible (`au`, `mx`) o un que no existeix. No es crea res.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ValidationError'
              examples:
                InvalidUrl:
                  value:
                    website_url:
                      - Enter a valid URL.
                DataLocationNotAvailable:
                  summary: Una ubicació de dades que estarà disponible properament
                  value:
                    data_location:
                      - This data location is not available yet.
                UnknownDataLocation:
                  summary: Una ubicació de dades que no existeix
                  value:
                    data_location:
                      - '"us" is not a valid choice.'
        '401':
          description: >-
            El token d'accés està mal format, no és vàlid o ha caducat. Obtén-ne
            un de nou amb `POST /programmatic/login/`.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AuthError'
              examples:
                InvalidToken:
                  value:
                    detail: Invalid access token
                ExpiredToken:
                  value:
                    detail: Expired access token
        '403':
          description: >-
            No pots crear aplicacions en aquesta organització. Un membre de
            l'organització que no sigui propietari o administrador rep `Only
            organization owners and admins can manage applications.` Un
            propietari o administrador amb l'accés suspès a l'organització rep
            `Your access to this organization is suspended.` Una sol·licitud
            sense capçalera `Authorization` rep `You do not have permission to
            perform this action.` Durant les 72 hores posteriors a la
            recuperació del compte, la sol·licitud es rebutja amb el `code`
            `recovery_hold` i `until`, que indica el moment en què finalitza la
            retenció.
          content:
            application/json:
              schema:
                oneOf:
                  - $ref: '#/components/schemas/AuthError'
                  - $ref: '#/components/schemas/RecoveryHoldError'
              examples:
                NotOwnerOrAdmin:
                  summary: Membre que no és ni propietari ni administrador
                  value:
                    detail: >-
                      Only organization owners and admins can manage
                      applications.
                Suspended:
                  summary: Membresia suspesa
                  value:
                    detail: Your access to this organization is suspended.
                MissingToken:
                  summary: Sense capçalera Authorization
                  value:
                    detail: You do not have permission to perform this action.
                RecoveryHold:
                  summary: Compte recuperat fa menys de 72 hores
                  value:
                    detail: This action is on hold because you recovered your account.
                    code: recovery_hold
                    until: '2026-11-04T10:15:00+00:00'
        '404':
          description: L'organització no existeix o no en sou membre.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AuthError'
              examples:
                OrganizationNotFound:
                  summary: No s'ha trobat l'organització, o no en ets membre
                  value:
                    detail: Organization not found.
      security:
        - BearerAuth: []
      x-codeSamples:
        - lang: curl
          label: cURL
          source: >-
            curl -X POST
            "https://apx.didit.me/auth/v2/organizations/me/$ORG_ID/applications/"
            \
              -H "Authorization: Bearer $ACCESS_TOKEN" \
              -H "Content-Type: application/json" \
              -d '{
                "name": "Acme Customer App",
                "website_url": "https://acme.example",
                "redirect_uris": ["https://acme.example/callback"],
                "data_location": "eu"
              }'
        - lang: python
          label: Python
          source: |-
            from didit import Didit

            # Use the access token that account.login returns.
            client = Didit(account_token="YOUR_ACCESS_TOKEN")

            result = client.account.applications.create(
                "a1b2c3d4-5678-90ab-cdef-111111111111",
                name="Acme Customer App",
                website_url="https://acme.example",
                redirect_uris=["https://acme.example/callback"],
                terms_url="https://acme.example/terms",
                privacy_url="https://acme.example/privacy",
                data_location="eu",
            )
            print(result)
        - lang: javascript
          label: Node.js
          source: >-
            import Didit from "@didit-protocol/sdk-node";


            // Use the access token that account.login returns.

            const didit = new Didit({ accountToken: "YOUR_ACCESS_TOKEN" });


            const result = await
            didit.account.applications.create("a1b2c3d4-5678-90ab-cdef-111111111111",
            {
              name: "Acme Customer App",
              website_url: "https://acme.example",
              redirect_uris: ["https://acme.example/callback"],
              terms_url: "https://acme.example/terms",
              privacy_url: "https://acme.example/privacy",
              data_location: "eu",
            });

            console.log(result);
        - lang: go
          label: Go
          source: "ctx := context.Background()\n// Use the access token that account.login returns.\nclient := didit.NewClient(option.WithAccountToken(\"YOUR_ACCESS_TOKEN\"))\n\nresult, err := client.Account.Applications.Create(ctx, \"a1b2c3d4-5678-90ab-cdef-111111111111\", didit.ApplicationCreateRequest{\n\tName:         didit.String(\"Acme Customer App\"),\n\tWebsiteURL:   didit.String(\"https://acme.example\"),\n\tRedirectURIs: didit.Some([]string{\"https://acme.example/callback\"}),\n\tTermsURL:     didit.String(\"https://acme.example/terms\"),\n\tPrivacyURL:   didit.String(\"https://acme.example/privacy\"),\n\tDataLocation: didit.Some(didit.ApplicationDataLocation(\"eu\")),\n})\nif err != nil {\n\tlog.Fatal(err)\n}\nfmt.Printf(\"%+v\\n\", result)"
        - lang: java
          label: Java
          source: >-
            import java.util.List;

            import me.didit.Didit;

            import me.didit.types.ApplicationCreateRequest;

            import me.didit.types.ApplicationDataLocation;


            // Use the access token that account.login returns.

            Didit client =
            Didit.builder().accountToken("YOUR_ACCESS_TOKEN").build();


            var result =
            client.account().applications().create("a1b2c3d4-5678-90ab-cdef-111111111111",
            ApplicationCreateRequest.builder()
                    .name("Acme Customer App")
                    .websiteUrl("https://acme.example")
                    .redirectUris(List.of("https://acme.example/callback"))
                    .termsUrl("https://acme.example/terms")
                    .privacyUrl("https://acme.example/privacy")
                    .dataLocation(ApplicationDataLocation.of("eu"))
                    .build());
            System.out.println(result);
        - lang: php
          label: PHP
          source: >-
            <?php


            require 'vendor/autoload.php';


            use Didit\DiditClient;


            // Use the access token that account.login returns.

            $didit = new DiditClient(accountToken: 'YOUR_ACCESS_TOKEN');


            $result =
            $didit->account->applications->create('a1b2c3d4-5678-90ab-cdef-111111111111',
            [
                'name' => 'Acme Customer App',
                'website_url' => 'https://acme.example',
                'redirect_uris' => ['https://acme.example/callback'],
                'terms_url' => 'https://acme.example/terms',
                'privacy_url' => 'https://acme.example/privacy',
                'data_location' => 'eu',
            ]);

            print_r($result->toArray());
        - lang: ruby
          label: Ruby
          source: |-
            require "didit"

            # Use the access token that account.login returns.
            didit = Didit::Client.new(account_token: "YOUR_ACCESS_TOKEN")

            result = didit.account.applications.create(
              "a1b2c3d4-5678-90ab-cdef-111111111111",
              name: "Acme Customer App",
              website_url: "https://acme.example",
              redirect_uris: ["https://acme.example/callback"],
              terms_url: "https://acme.example/terms",
              privacy_url: "https://acme.example/privacy",
              data_location: "eu"
            )
            puts result.to_h
        - lang: csharp
          label: .NET
          source: >-
            using System;

            using System.Text.Json;

            using Didit;


            // Use the access token that account.login returns.

            using var client = new DiditClient(new DiditClientOptions {
            AccountToken = "YOUR_ACCESS_TOKEN" });


            var result = await
            client.Account.Applications.CreateAsync("a1b2c3d4-5678-90ab-cdef-111111111111",
            new ApplicationCreateRequest

            {
                Name = "Acme Customer App",
                WebsiteUrl = "https://acme.example",
                RedirectUris = new string[] { "https://acme.example/callback" },
                TermsUrl = "https://acme.example/terms",
                PrivacyUrl = "https://acme.example/privacy",
                DataLocation = new ApplicationDataLocation("eu"),
            });

            Console.WriteLine(JsonSerializer.Serialize(result));
components:
  schemas:
    ApplicationCreateRequest:
      type: object
      description: >-
        Tots els camps són opcionals. Enviar un cos buit crea una aplicació amb
        un nom per defecte, a la Unió Europea.
      properties:
        name:
          type: string
          description: >-
            Nom visible de l'aplicació. Per defecte és `"<organization name>
            App"`.
          example: Acme Customer App
        website_url:
          type: string
          description: URL del lloc web o de l'aplicació associada a aquesta aplicació.
          example: https://acme.example
        redirect_uris:
          type: array
          items:
            type: string
          description: >-
            URI de redirecció permeses per a fluxos de redirecció de verificació
            i d'estil OAuth.
          example:
            - https://acme.example/callback
        terms_url:
          type: string
          description: >-
            URL de les condicions del servei que es mostra al flux de
            verificació.
          example: https://acme.example/terms
        privacy_url:
          type: string
          description: >-
            URL de la política de privadesa que es mostra al flux de
            verificació.
          example: https://acme.example/privacy
        description:
          type: string
          description: Descripció interna de l'aplicació (no es mostra als usuaris finals).
        data_location:
          $ref: '#/components/schemas/ApplicationDataLocation'
    Application:
      type: object
      description: >-
        Registre complet de l'aplicació. `uuid`, `client_id` i `api_key` no
        canvien mai després de la creació. `data_location` tampoc no canvia,
        excepte un sol cop a l'aplicació de producció creada amb la teva
        organització, abans d'utilitzar-la (consulta la sol·licitud
        d'actualització).
      properties:
        uuid:
          type: string
          format: uuid
          description: >-
            UUID de l'aplicació. Utilitza'l com a `{app_id}` en les crides
            posteriors.
          example: b2c3d4e5-6789-01bc-defg-222222222222
        name:
          type: string
          description: Nom visible de l'aplicació que es mostra a la consola de Didit.
          example: Acme Production App
        client_id:
          type: string
          description: >-
            Identificador públic de client, segur per incrustar en fluxos
            d'estil OAuth.
          example: S9LIYGSoWNuGMLHsvEt9dQ
        api_key:
          type: string
          description: >-
            Secret de llarga durada (també anomenat `client_secret`). Utilitza'l
            com a capçalera `x-api-key` per a cada crida a
            `https://verification.didit.me/v3/...` (sessions, fluxos de treball,
            AML, etc.). Tracta'l com una credencial; no l'exposis mai al costat
            del client. Les claus noves comencen amb `sk_live_` (aplicació de
            producció) o `sk_test_` (aplicació de sandbox), seguits de 43
            caràcters segurs per a URL (lletres, dígits, `-` i `_`). Les claus
            creades abans d'aquest format no tenen prefix i continuen funcionant
            sense canvis. Durant les 72 hores posteriors a la recuperació del
            teu compte, les operacions de llistar, consultar i actualitzar
            retornen una cadena buida aquí en lloc de la clau.
          example: sk_live_example_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
        website_url:
          type: string
          nullable: true
          description: URL del lloc web o de l'aplicació associada a aquesta aplicació.
          example: https://acme.example
        redirect_uris:
          type: array
          items:
            type: string
          description: >-
            URI de redirecció permeses per a fluxos de redirecció de verificació
            i d'estil OAuth.
          example:
            - https://acme.example/callback
        terms_url:
          type: string
          nullable: true
          description: >-
            URL de les condicions del servei que es mostra al flux de
            verificació.
          example: https://acme.example/terms
        privacy_url:
          type: string
          nullable: true
          description: >-
            URL de la política de privadesa que es mostra al flux de
            verificació.
          example: https://acme.example/privacy
        description:
          type: string
          nullable: true
          description: Descripció interna de l'aplicació (no es mostra als usuaris finals).
        created_at:
          type: string
          format: date-time
          example: '2025-06-01T10:00:00Z'
        data_location:
          $ref: '#/components/schemas/ApplicationDataLocation'
        products:
          type: array
          readOnly: true
          description: >-
            Els productes de l'aplicació. Sempre tots tres, en aquest ordre:
            `identity`, `transactions`, `authentication`. Una nova aplicació té
            `identity` habilitat amb tots els mòduls activats, i `transactions`
            i `authentication` inhabilitats. Només lectura: s'ignora la clau
            `products` en un cos de creació o actualització.
          items:
            $ref: '#/components/schemas/ApplicationProduct'
          example:
            - product: identity
              status: enabled
              modules:
                user_verification: true
                business_verification: true
                case_management: true
            - product: transactions
              status: disabled
              modules:
                travel_rule: true
                case_management: true
            - product: authentication
              status: disabled
              modules: {}
    ValidationError:
      description: >-
        Cos de l'error de validació. L'embolcall previst és un mapa `{field:
        ["message", ...]}` per a errors a nivell de camp o un embolcall d'una
        sola clau `{detail: "..."}` per a errors de regles de negoci. Uns quants
        validadors (força de la contrasenya durant el registre, validesa del
        codi a verify-email) responen actualment amb una matriu simple
        `["message"]` -- una inconsistència coneguda del costat del servidor.
        L'esquema següent manté aquesta branca de matriu simple perquè el codi
        client generat a partir d'aquesta especificació deserialitzi les
        respostes actuals, però el nou codi client l'hauria de tractar com el
        format amb clau de camp rellevant (`{password: [...]}` o `{code:
        [...]}`) i el contracte del servidor convergirà cap a aquesta 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.
    AuthError:
      type: object
      description: Embolcall d'error d'autenticació / autorització / de recurs no trobat.
      properties:
        detail:
          type: string
          example: Invalid access token
    RecoveryHoldError:
      type: object
      description: >-
        Retornat durant 72 hores després que el compte s'hagi recuperat (s'han
        restablert els mètodes d'inici de sessió perduts). Les accions que creen
        organitzacions, aplicacions o secrets es rebutgen fins a `until`; les
        operacions de lectura continuen funcionant.
      required:
        - detail
        - code
        - until
      properties:
        detail:
          type: string
          example: This action is on hold because you recovered your account.
        code:
          type: string
          enum:
            - recovery_hold
          example: recovery_hold
        until:
          type: string
          format: date-time
          description: >-
            Quan finalitza el bloqueig (ISO 8601). Reintenta la sol·licitud
            després d'aquesta hora.
          example: '2026-11-04T10:15:00+00:00'
    ApplicationDataLocation:
      type: string
      enum:
        - eu
        - au
        - mx
      description: >-
        On s'emmagatzemen i es processen les dades de verificació de
        l'aplicació, que se selecciona en crear l'aplicació. `eu` és la Unió
        Europea (Irlanda), l'opció per defecte. `au` (Austràlia, Sydney) i `mx`
        (Mèxic) estaran disponibles properament: una sol·licitud que els indiqui
        respon 400 `This data location is not available yet.` L'aplicació de
        sandbox d'una organització sempre és a la Unió Europea.
      example: eu
    ApplicationProduct:
      type: object
      description: >-
        Un producte d'una aplicació i el seu estat. Només de lectura: els
        endpoints de l'aplicació el retornen i l'ignoren al cos de la
        sol·licitud.
      properties:
        product:
          type: string
          enum:
            - identity
            - transactions
            - authentication
          description: >-
            `identity` (Verificació d'identitat), `transactions` (Monitoratge de
            transaccions) o `authentication` (Autenticació).
          example: identity
        status:
          type: string
          enum:
            - enabled
            - early_access
            - disabled
          description: >-
            Si el producte està activat per a aquesta aplicació. `early_access`
            només s'aplica a `authentication`, que Didit activa per tu.
          example: enabled
        modules:
          type: object
          additionalProperties:
            type: boolean
          description: >-
            Interruptors de mòduls del producte, cadascun `true` o `false`.
            `identity` conté `user_verification`, `business_verification` i
            `case_management`. `transactions` conté `travel_rule` i
            `case_management`. `authentication` no en conté cap (`{}`).
            `case_management` és un sol paràmetre de configuració mostrat tant a
            `identity` com a `transactions`, de manera que té el mateix valor a
            tots dos.
          example:
            user_verification: true
            business_verification: true
            case_management: true
      required:
        - product
        - status
        - modules
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: >-
        `access_token` JWT signat amb RS256 retornat per `POST
        /programmatic/login/` o `POST /programmatic/verify-email/`. Envia'l com
        a `Authorization: Bearer <access_token>`. La durada per defecte és de
        86400 segons (24 h). Aquest token només és vàlid per als endpoints de
        gestió de comptes a `apx.didit.me/auth/v2`. L'API de verificació
        (`verification.didit.me/v3`) utilitza en el seu lloc la `api_key` de
        llarga durada com a `x-api-key`.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.