> ## 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: client_id और api_key प्राप्त करें > Didit का client_id और api_key प्राप्त करें। सभी API कॉल में api_key को x-api-key हेडर में भेजें। प्रति उपयोग भुगतान, कोई अनुबंध नहीं। एप्लिकेशन क्रेडेंशियल प्राप्त करने का प्रॉम्प्ट प्रॉम्प्ट को क्लिपबोर्ड पर कॉपी करें \

\`Read one application's full record — including its client_id and api_key (client_secret). Use this to RECOVER an api_key you've misplaced.

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

Authentication:
Authorization: Bearer 
Get a token via POST /programmatic/login/.

Path parameters:
\- org_id (UUID, required) — Organization that owns the application. Get via GET /organizations/me/.
\- app_id (UUID, required) — Application UUID. Returned by POST /programmatic/verify-email/ (in the application.uuid field), by POST /organizations/me/{org_id}/applications/, or visible in the Didit console.

curl example:
curl "https://apx.didit.me/auth/v2/organizations/me//applications//" \
-H "Authorization: Bearer "

Response (200 OK):
\{
"uuid": "b2c3d4e5-6789-...",
"name": "My App",
"client_id": "S9LIYGSoWNuGMLHsvEt9dQ",
"api_key": "sk_live_example_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"website_url": "https://example.com",
"redirect_uris": ["https://example.com/callback"],
"terms_url": "https://example.com/terms",
"privacy_url": "https://example.com/privacy",
"description": "Production application",
"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": {} }
]
}

How to use the response:
\- api_key → set as the x-api-key header on EVERY call to https://verification.didit.me/v3/... (sessions, workflows, questionnaires, AML monitoring, billing, etc.).
\- client_id → shown alongside api_key for OAuth-style introspection scenarios. Routine verification calls only need api_key.
\- data_location → where the application's verification data is stored and processed: "eu" (European Union, Ireland). Chosen when the application is created; "au" (Australia, Sydney) and "mx" (Mexico) are coming soon.
\- products → read-only. Always all three products in this order: identity, transactions, authentication. Each has a status (enabled, early_access or disabled) and its module switches (true or false). identity modules: user_verification, business_verification, case_management. transactions modules: travel_rule, case_management. authentication has none ({}).

Failure modes:
\- 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, or { "detail": "Application not found." } when the application is not in that organization.

When to call:
\- After programmatic login from a new machine — you have an access_token but not the api_key, and you need x-api-key to start calling verification.didit.me.
\- Auditing your applications — list all apps with GET /organizations/me/{org_id}/applications/, then read each.

Note:
This endpoint does not rotate the credential. It returns the application's current api_key on every GET, so there is no "show api_key once" model.

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

\
यहाँ पेस्ट करें ## OpenAPI ````yaml hi/openapi-auth.json GET /organizations/me/{org_id}/applications/{app_id}/ openapi: 3.0.0 info: version: 1.0.0 title: Didit Auth API description: >- डेवलपर्स और AI एजेंट्स के लिए प्रोग्रामेटिक रजिस्ट्रेशन और प्रमाणीकरण API। 2 API कॉल्स में रजिस्टर करें -- किसी ब्राउज़र की आवश्यकता नहीं। सबसे अधिक एजेंट-अनुकूल पहचान सत्यापन प्लेटफ़ॉर्म। ## बेस URL इस विनिर्देश के सभी endpoints `https://apx.didit.me/auth/v2` पर होस्ट किए गए हैं। यह सत्यापन API (`https://verification.didit.me/v3`) से एक अलग होस्ट है। इनका अंतर स्पष्ट रखें: यह ऑथ होस्ट आपके **JWT access tokens** जारी करता है और आपको अपने **संगठनों** और **एप्लिकेशन्स** को सूचीबद्ध और प्रबंधित करने की अनुमति देता है। सत्यापन होस्ट वह जगह है जहां आप इस API द्वारा लौटाए गए **`api_key`** के साथ प्रमाणित होकर सत्रों, वर्कफ़्लो, AML आदि को कॉल करते हैं। ## ऑथ फ़्लो कैसे काम करता है 1. `POST /programmatic/register/` — ईमेल + पासवर्ड सबमिट करें। 2. ईमेल द्वारा 6-वर्णों का अल्फ़ान्यूमेरिक कोड प्राप्त करें। 3. `POST /programmatic/verify-email/` — कोड सबमिट करें। आपको एक JWT `access_token`, एक `refresh_token`, एक संगठन और `client_id` + `api_key` के साथ एक डिफ़ॉल्ट एप्लिकेशन वापस मिलता है। 4. `api_key` को सहेजें। `https://verification.didit.me/v3/...` पर प्रत्येक कॉल के लिए इसे `x-api-key` के रूप में उपयोग करें। 5. भविष्य में किसी भी मशीन से, `POST /programmatic/login/` आपके ईमेल + पासवर्ड के बदले एक नया JWT प्राप्त करता है, फिर क्रेडेंशियल्स को रिकवर या रोटेट करने के लिए `GET /organizations/me/` और एप्लिकेशन endpoints को कॉल करें। JWT केवल इस विनिर्देश में **Account Management** endpoints के लिए आवश्यक है; सत्यापन API ट्रैफ़िक लंबी अवधि वाले `api_key` का उपयोग करता है, न कि JWT का। ## कन्वेंशन - सभी अनुरोध और रिस्पॉन्स बॉडी JSON (`Content-Type: application/json`) हैं। - **`POST /programmatic/register/` का परीक्षण करते समय वास्तविक, डिलीवर होने योग्य ईमेल पते का उपयोग करें।** endpoint सत्यापन कोड को सिंक्रोनस रूप से भेजता है, इसलिए आरक्षित परीक्षण डोमेन (`@example.com`, `@example.org`, `@*.test`, `@*.example`, `@*.invalid`) पर पतों को मेल डिलीवरी द्वारा अस्वीकार कर दिया जाता है और अनुरोध `500` लौटाता है। नमूनों में दिए गए `you@yourdomain.com` प्लेसहोल्डर को ऐसे इनबॉक्स से बदलें जिसे आप वास्तव में पढ़ सकते हैं। - सत्यापन त्रुटियां दो में से किसी एक एन्वेलप के साथ HTTP `400` लौटाती हैं: फ़ील्ड-स्तरीय समस्याओं के लिए `{"field": ["message", ...]}` या व्यावसायिक-नियम त्रुटियों के लिए `{"detail": "message"}`। कुछ वैलिडेटर (रजिस्टर पर पासवर्ड की मजबूती, verify-email पर कोड की समय-सीमा समाप्ति) वर्तमान में फ़ील्ड-की वाले फ़ॉर्म के बजाय केवल एक ऐरे `["message"]` के साथ रिस्पॉन्स देते हैं -- यह एक ज्ञात सर्वर-साइड विसंगति है, इसलिए क्लाइंट कोड को दोनों प्रारूपों को स्वीकार करना चाहिए। - प्रमाणीकरण त्रुटियां HTTP `401` (अमान्य bearer token) या `403` (अनुपलब्ध bearer token / अपर्याप्त विशेषाधिकार) के साथ `{"detail": "..."}` के रूप में वापस आती हैं। - रेट लिमिट रिस्पॉन्स में सेकंड में कूलडाउन के साथ एक `wait` फ़ील्ड शामिल होता है। servers: - url: https://apx.didit.me/auth/v2 description: प्रोडक्शन ऑथ सर्वर security: [] tags: - name: Programmatic Auth description: >- ईमेल-और-पासवर्ड खाता जीवनचक्र: रजिस्टर करें, सत्यापित करें, लॉगिन करें। यह JWT `access_token` लौटाता है जिसका उपयोग आप खाता प्रबंधन endpoints के लिए करते हैं, साथ ही (सत्यापन पर) आपके पहले एप्लिकेशन की `client_id` और `api_key` भी। - name: Account Management description: >- प्रमाणित endpoints (JWT bearer) जो संगठनों को सूचीबद्ध करते हैं और एप्लिकेशन बनाते, प्राप्त करते या अपडेट करते हैं। इनका उपयोग उस `api_key` को पुनर्प्राप्त या रोटेट करने के लिए करें जिसके साथ आप सत्यापन API कॉल को प्रमाणित करते हैं। paths: /organizations/me/{org_id}/applications/{app_id}/: get: tags: - Account Management summary: एप्लिकेशन क्रेडेंशियल प्राप्त करें description: >- `client_id` और `api_key` सहित किसी एक एप्लिकेशन का पूरा रिकॉर्ड पढ़ें। खोई हुई `api_key` को पुनः प्राप्त करने के लिए इसका उपयोग करें। operationId: get_application_credentials parameters: - name: org_id in: path required: true description: उस संगठन का UUID जो एप्लिकेशन का स्वामी है। schema: type: string format: uuid example: a1b2c3d4-5678-90ab-cdef-111111111111 - name: app_id in: path required: true description: उस एप्लिकेशन का UUID जिसके क्रेडेंशियल्स आप पढ़ना चाहते हैं। schema: type: string format: uuid example: b2c3d4e5-6789-01bc-defg-222222222222 responses: '200': description: इसके `client_id` और `api_key` सहित एप्लिकेशन रिकॉर्ड। content: application/json: schema: $ref: '#/components/schemas/Application' examples: Success: value: uuid: b2c3d4e5-6789-01bc-defg-222222222222 name: My App client_id: S9LIYGSoWNuGMLHsvEt9dQ api_key: sk_live_example_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx website_url: https://example.com redirect_uris: - https://example.com/callback terms_url: https://example.com/terms privacy_url: https://example.com/privacy description: Production application 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: {} '401': description: >- एक्सेस token विकृत, अमान्य या समय-सीमा समाप्त है। `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: >- आप इस एप्लिकेशन को पढ़ नहीं सकते। संगठन का एक सदस्य जो स्वामी या व्यवस्थापक नहीं है, उसे `Only organization owners and admins can manage applications.` प्राप्त होता है। एक स्वामी या व्यवस्थापक जिसकी संगठन तक पहुँच निलंबित है, उसे `Your access to this organization is suspended.` प्राप्त होता है। बिना `Authorization` हेडर वाले अनुरोध को `You do not have permission to perform this action.` प्राप्त होता है। content: application/json: schema: $ref: '#/components/schemas/AuthError' examples: NotOwnerOrAdmin: summary: सदस्य जो स्वामी या व्यवस्थापक नहीं है value: detail: >- Only organization owners and admins can manage applications. Suspended: summary: सदस्यता निलंबित value: detail: Your access to this organization is suspended. MissingToken: summary: कोई Authorization हेडर नहीं value: detail: You do not have permission to perform this action. '404': description: >- संगठन मौजूद नहीं है या आप इसके सदस्य नहीं हैं, या उस संगठन में एप्लिकेशन मौजूद नहीं है। content: application/json: schema: $ref: '#/components/schemas/AuthError' examples: OrganizationNotFound: summary: संगठन नहीं मिला, या आप सदस्य नहीं हैं value: detail: Organization not found. ApplicationNotFound: summary: इस संगठन में ऐसा कोई एप्लिकेशन नहीं है value: detail: Application not found. security: - BearerAuth: [] x-codeSamples: - lang: curl label: cURL source: >- curl "https://apx.didit.me/auth/v2/organizations/me/$ORG_ID/applications/$APP_ID/" \ -H "Authorization: Bearer $ACCESS_TOKEN" - 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.retrieve( "a1b2c3d4-5678-90ab-cdef-111111111111", "b2c3d4e5-6789-01bc-defg-222222222222", ) 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.retrieve( "a1b2c3d4-5678-90ab-cdef-111111111111", "b2c3d4e5-6789-01bc-defg-222222222222", ); 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.Retrieve(ctx, \"a1b2c3d4-5678-90ab-cdef-111111111111\", \"b2c3d4e5-6789-01bc-defg-222222222222\")\nif err != nil {\n\tlog.Fatal(err)\n}\nfmt.Printf(\"%+v\\n\", result)" - lang: java label: Java source: >- import me.didit.Didit; // Use the access token that account.login returns. Didit client = Didit.builder().accountToken("YOUR_ACCESS_TOKEN").build(); var result = client.account().applications().retrieve("a1b2c3d4-5678-90ab-cdef-111111111111", "b2c3d4e5-6789-01bc-defg-222222222222"); System.out.println(result); - lang: php label: PHP source: >- account->applications->retrieve('a1b2c3d4-5678-90ab-cdef-111111111111', 'b2c3d4e5-6789-01bc-defg-222222222222'); 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.retrieve( "a1b2c3d4-5678-90ab-cdef-111111111111", "b2c3d4e5-6789-01bc-defg-222222222222" ) 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.RetrieveAsync("a1b2c3d4-5678-90ab-cdef-111111111111", "b2c3d4e5-6789-01bc-defg-222222222222"); Console.WriteLine(JsonSerializer.Serialize(result)); components: schemas: Application: type: object description: >- पूर्ण एप्लिकेशन रिकॉर्ड। निर्माण के बाद `uuid`, `client_id`, और `api_key` कभी नहीं बदलते। `data_location` भी नहीं बदलता, सिवाय आपके संगठन के साथ बनाए गए लाइव एप्लिकेशन पर उपयोग किए जाने से पहले एक बार (अपडेट अनुरोध देखें)। properties: uuid: type: string format: uuid description: एप्लिकेशन UUID। बाद के कॉलों में `{app_id}` के रूप में उपयोग करें। example: b2c3d4e5-6789-01bc-defg-222222222222 name: type: string description: Didit कंसोल में दिखाया जाने वाला एप्लिकेशन प्रदर्शन नाम। example: Acme Production App client_id: type: string description: >- सार्वजनिक क्लाइंट पहचानकर्ता, OAuth-शैली फ़्लो में एम्बेड करने के लिए सुरक्षित। example: S9LIYGSoWNuGMLHsvEt9dQ api_key: type: string description: >- दीर्घकालिक सीक्रेट (जिसे `client_secret` भी कहा जाता है)। `https://verification.didit.me/v3/...` (सत्र, वर्कफ़्लो, AML, आदि) के प्रत्येक कॉल के लिए `x-api-key` हेडर के रूप में उपयोग करें। इसे क्रेडेंशियल की तरह रखें; क्लाइंट-साइड पर कभी भी उजागर न करें। नई कुंजियाँ `sk_live_` (लाइव एप्लिकेशन) या `sk_test_` (सैंडबॉक्स एप्लिकेशन) से शुरू होती हैं, जिसके बाद 43 URL-सुरक्षित वर्ण (अक्षर, अंक, `-` और `_`) होते हैं। इस प्रारूप से पहले बनाई गई कुंजियों में कोई उपसर्ग नहीं होता है और वे बिना किसी बदलाव के काम करती रहती हैं। आपके द्वारा अपना खाता पुनर्प्राप्त करने के 72 घंटों तक, सूचीबद्ध करना, प्राप्त करना और अपडेट करना कुंजी के स्थान पर यहाँ एक खाली स्ट्रिंग लौटाते हैं। example: sk_live_example_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx website_url: type: string nullable: true description: इस एप्लिकेशन से संबद्ध वेबसाइट या ऐप URL। example: https://acme.example redirect_uris: type: array items: type: string description: >- OAuth-शैली और सत्यापन रीडायरेक्ट फ़्लो के लिए स्वीकृत रीडायरेक्ट URI। example: - https://acme.example/callback terms_url: type: string nullable: true description: सत्यापन फ़्लो में दिखाया गया सेवा की शर्तों का URL। example: https://acme.example/terms privacy_url: type: string nullable: true description: सत्यापन फ़्लो में दिखाया गया गोपनीयता नीति URL। example: https://acme.example/privacy description: type: string nullable: true description: >- एप्लिकेशन के लिए आंतरिक विवरण (अंतिम उपयोगकर्ताओं को नहीं दिखाया जाता)। 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: >- एप्लिकेशन के उत्पाद। हमेशा तीनों, इसी क्रम में: `identity`, `transactions`, `authentication`। एक नए एप्लिकेशन में प्रत्येक मॉड्यूल चालू होने के साथ `identity` सक्षम होती है, और `transactions` व `authentication` अक्षम होते हैं। केवल-पढ़ने योग्य: निर्माण या अपडेट बॉडी में `products` कुंजी को अनदेखा कर दिया जाता है। 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: {} AuthError: type: object description: प्रमाणीकरण / प्राधिकरण / नहीं-मिला त्रुटि एनवलप। properties: detail: type: string example: Invalid access token ApplicationDataLocation: type: string enum: - eu - au - mx description: >- एप्लिकेशन का सत्यापन डेटा कहाँ संग्रहीत और संसाधित किया जाता है, जिसे एप्लिकेशन बनाते समय चुना जाता है। `eu` यूरोपीय संघ (आयरलैंड) है, जो डिफ़ॉल्ट है। `au` (ऑस्ट्रेलिया, सिडनी) और `mx` (मेक्सिको) जल्द ही आ रहे हैं: उनका नाम देने वाला अनुरोध 400 `This data location is not available yet.` उत्तर देता है। किसी संगठन का सैंडबॉक्स एप्लिकेशन हमेशा यूरोपीय संघ में होता है। example: eu ApplicationProduct: type: object description: >- किसी एप्लिकेशन का एक उत्पाद और उसकी स्थिति। केवल-पठन: एप्लिकेशन endpoint इसे लौटाते हैं और अनुरोध बॉडी में इसे अनदेखा करते हैं। properties: product: type: string enum: - identity - transactions - authentication description: >- `identity` (पहचान सत्यापन), `transactions` (लेन-देन निगरानी) या `authentication` (प्रमाणीकरण)। example: identity status: type: string enum: - enabled - early_access - disabled description: >- क्या इस एप्लिकेशन के लिए प्रोडक्ट चालू है। `early_access` केवल `authentication` पर लागू होता है, जिसे Didit आपके लिए चालू करता है। example: enabled modules: type: object additionalProperties: type: boolean description: >- उत्पाद के मॉड्यूल स्विच, प्रत्येक `true` या `false`। `identity` में `user_verification`, `business_verification` और `case_management` हैं। `transactions` में `travel_rule` और `case_management` हैं। `authentication` में कोई नहीं है (`{}`)। `case_management` एक सेटिंग है जो `identity` और `transactions` दोनों के अंतर्गत दिखाई जाती है, इसलिए दोनों पर इसका मान समान होता है। example: user_verification: true business_verification: true case_management: true required: - product - status - modules securitySchemes: BearerAuth: type: http scheme: bearer bearerFormat: JWT description: >- `POST /programmatic/login/` या `POST /programmatic/verify-email/` द्वारा लौटाया गया RS256-हस्ताक्षरित JWT `access_token`। `Authorization: Bearer ` के रूप में भेजें। डिफ़ॉल्ट जीवनकाल 86400 सेकंड (24 घंटे) है। यह token केवल `apx.didit.me/auth/v2` पर खाता प्रबंधन endpoints के लिए मान्य है। सत्यापन API (`verification.didit.me/v3`) इसके बजाय `x-api-key` के रूप में दीर्घकालिक `api_key` का उपयोग करता है। ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.