> ## Documentation Index > Fetch the complete documentation index at: https://www.cashfree.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Mobile 360 Verify OTP > Use this API to extract multiple identity types from mobile number. The following table outlines the key data fields returned in the OTP verification response: | **Field** | **Description** | | ---------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | PERSONAL\_DETAILS | Provides personal information such as full name, gender, date of birth, age, income, and occupation. | | RELATIVE\_DETAILS | Provides information about family members, including their names and relationships. | | BANK\_ACCOUNT\_DETAILS | Contains banking information such as the masked account number, IFSC code, bank address, and associated account linkage. The unmasked account number can be made available to regulated entities after a successful penny drop verification. | | UAN\_EMPLOYMENT\_DETAILS | Contains employment records linked to a UAN, including member ID, establishment ID, joining and exit dates, and Aadhaar linkage status. | | RECENT\_EMPLOYMENT\_DETAILS | Provides recent employment history, including employee and employer details, EPFO verification, and PF filing data. | | PAN | Contains the PAN number associated with the individual. | | PAN\_METADATA | Provides metadata related to the PAN, such as the registered name, name on the card, type, and Aadhaar linkage status. | | PHONE\_LIST | Lists phone numbers associated with the individual, including the number type and linkage source. | | EMAIL\_LIST | Lists email addresses associated with the individual and their linkage sources. | | PASSPORT\_NUMBER | Contains the passport number and associated linkage information. | | AADHAAR\_NUMBER | Provides a masked Aadhaar number and its source of linkage. | | RATION\_CARD | Contains the ration card number and linkage information. | | DRIVING\_LICENSE | Contains the driving license number and associated linkage. | | VOTER\_ID | Contains the voter ID and its linkage information. | | ADDRESS\_LIST | Lists known addresses, including full address, city, state, pincode, and linkage source. | | MOBILE\_NUMBER\_INTELLIGENCE | Provides key insights about the mobile number, including its validity, connection status, and service provider details. | | CREDIT\_SCORE | Provides the individual's credit score as a numeric value. | | RISK\_INTELLIGENCE | Provides risk insights about the mobile number, including is safe, risk level, reason, description, and relevant timestamps. | ## OpenAPI ````yaml post /mobile360/otp/verify openapi: 3.0.0 info: license: name: Apache 2.0 url: https://www.apache.org/licenses/LICENSE-2.0.html contact: email: developers@cashfree.com name: API Support url: https://discord.com/invite/QdZkNSxXsB title: Cashfree Verification API's. version: '2023-12-18' description: >- Cashfree's Verification APIs provide different types of verification to our merchants. servers: - description: Sandbox Server url: https://sandbox.cashfree.com/verification - description: Production Server url: https://api.cashfree.com/verification security: [] tags: - name: Aadhaar description: Operations related to Aadhaar verification. - name: BAV V2 description: Operations related to Bank account verification v2. - name: PAN description: Operations related to PAN verification. - name: Digilocker description: Operations related to Digilocker verification. - name: E-sign description: Operations related to E-sign verification. - name: Reverse Penny Drop description: Operations related to Reverse Penny Drop verification. - name: UPI Penny Drop description: Operations related to UPI Penny Drop verification. - name: Mobile Penny Drop description: Operations related to Mobile Penny Drop verification. - name: IP description: Operation related to IP verification. - name: UPI description: Operations related to UPI verification. - name: Passport description: Operation related to Passport verification. - name: CIN description: Operation related to CIN verification. - name: Name Match description: Operation related to Name Match verification. - name: PAN to GSTIN description: Operation related to PAN to GSTIN. - name: Face Match description: Operation related to Face Match verification. - name: Voter ID description: Operation related to Voter ID verification. - name: Reverse Geocoding description: Operation related to Reverse Geocoding. - name: Vehicle RC description: Operation related to Vehicle RC verification. - name: Driving License description: Operation related to Driving License verification. - name: GSTIN description: Operation related to GSTIN verification. - name: Account Aggregator description: Operations related to Account aggregator. - name: OTPLess description: Operations related to OTPLess Verification. - name: 1-Click description: Operations related to 1-Click. - name: Smart OCR description: Operations related to Smart OCR. - name: Geocoding description: Operations related to Geocoding. - name: Udyam description: Operation related to Udyam verification. - name: PAN to Udyam description: Operation related to PAN to Udyam. paths: /mobile360/otp/verify: post: tags: - Mobile 360 OTP Flow summary: Mobile 360 Verify OTP description: Use this API to extract multiple identity types from mobile number. operationId: VrsMobile360ConsentBasedVerification parameters: - $ref: '#/components/parameters/x_cf_signature' - $ref: '#/components/parameters/global_x_api_version' requestBody: $ref: '#/components/requestBodies/Mobile360VerifyOtpRequest' responses: '200': $ref: '#/components/responses/Mobile360VerifyOtpResponse' '400': $ref: '#/components/responses/Response400Mobile360VerifyOtp' '401': $ref: '#/components/responses/Response401' '403': $ref: '#/components/responses/Response403' '409': $ref: '#/components/responses/Response409DuplicateId' '422': $ref: '#/components/responses/Response422' '500': $ref: '#/components/responses/Response500V2' '502': $ref: '#/components/responses/Response502V2' security: - XClientID: [] XClientSecret: [] components: parameters: x_cf_signature: description: >- Send the signature if two-factor authentication is selected as Public Key. [More details](https://www.cashfree.com/docs/api-reference/vrs/getting-started#2fa-api-signature-generation). name: x-cf-signature in: header required: false schema: type: string example: '' global_x_api_version: description: API version to be used. Format is in YYYY-MM-DD. name: x-api-version in: header required: true schema: type: string default: '2024-12-01' example: '2024-12-01' example: '2024-12-01' requestBodies: Mobile360VerifyOtpRequest: description: Find the request parameters for Mobile 360 Verify OTP. required: true content: application/json: schema: $ref: '#/components/schemas/Mobile360VerifyOtpRequestSchema' responses: Mobile360VerifyOtpResponse: description: Response for Mobile360 Verify OTP. content: application/json: schema: $ref: '#/components/schemas/Mobile360VerifyOtpResponseSchema' examples: SUCCESS: value: verification_id: test_verification_id_99 reference_id: 1234567 status: SUCCESS personal_details: full_name: JOHN SNOW gender: MALE total_income: 1000000 occupation: Software Engineer age: 30 dob: '1996-10-02' relatives_details: - relation: FATHER relative_name: Alice Doe phone_numbers: - type: HOME phone: '9999996655' linked_to: CREDIT - type: MOBILE phone: '9999999999' linked_to: PAN - type: MOBILE phone: '9988775566' linked_to: UAN emails: - email: johnsnow@example.com linked_to: CREDIT - email: abc@gmail.com linked_to: PAN - email: johndoe@gmail.com linked_to: UAN passport_details: - passport_number: PA123456 linked_to: CREDIT ration_card_details: - ration_card_number: TN1234567890 linked_to: CREDIT voter_details: - voter_id: UAI4574761 linked_to: CREDIT pan_details: - pan_number: ABCPV1234D metadata: registered_name: JOHN SNOW name_pan_card: JOHN SNOW type: Individual or Person aadhaar_linked: true driving_license_details: - driving_license_number: KA0120198900984 linked_to: CREDIT aadhaar_details: - masked_aadhaar_number: XXXXXXXX8848 linked_to: PAN addresses: - address: Flat 404, Green Towers, MG Road, Mumbai 400001 type: Primary state: MAHARASTHRA pincode: '400001' city: Mumbai street: ' MG Road' country: India linked_to: PAN bank_account_details: - bank_account: '20329012345' ifsc: SBIN0012345 bank_address: STATE BANK OF INDIA,KATANGA BENGALURU linked_to: CREDIT employment_details: uan: - uan: '200123456789' member_id: XYZAB00123450000005678 establishment_id: XYZAB0012345000 exit_date: null joining_date: '2018-05-10' leave_reason: null establishment_name: ABC TECHNOLOGIES PVT LTD uan_linked_aadhaar: true recent_employment_details: employee_details: member_id: XYZAB00123450000005678 exit_date: null joining_date: '2018-05-10' uan: '200123456789' epfo: recent: true name_unique: true pf_filings_details: true employed: true employee_name_match: true exit_date_marked: false employer_details: establishment_id: XYZAB0012345000 establishment_name: ABC TECHNOLOGIES PVT LTD setup_date: '2012-03-15' ownership_type: Private Limited Company employer_confidence_score: 85 employer_name_match: true pf_filing_details: - total_amount: 32145678 employees_count: 5678 wage_month: JAN-25 - total_amount: 31456789 employees_count: 5600 wage_month: DEC-24 - total_amount: 30987654 employees_count: 5500 wage_month: NOV-24 mobile_number_intelligence: is_valid_number: true subscriber_status: CONNECTED connection_type: PREPAID current_service_provider: AIRTEL original_service_provider: AIRTEL network_region: India is_ported: false credit_score: 805 risk_intelligence: is_safe: false risk_level: LOW risk_reason: Inactive SIM risk_description: SIM inactive or unused for an extended period added_on: '2025-06-23T12:42:10Z' last_updated_on: '2025-09-09T17:00:11Z' No Data Found: value: verification_id: test_verification_id reference_id: 123456 status: DETAILS_NOT_FOUND personal_details: null phone_numbers: [] emails: [] passport_details: [] bank_account_details: [] aadhaar_details: [] ration_card_details: [] driving_license_details: [] voter_details: [] pan_details: [] addresses: [] employment_details: {} credit_score: null risk_intelligence: null Response400Mobile360VerifyOtp: description: Validation errors for Mobile360. content: application/json: schema: $ref: '#/components/schemas/ErrorResponseSchema' examples: Verification ID Missing: $ref: '#/components/examples/VerificationIdMissing' OTP Missing: value: type: validation_error code: otp_empty message: otp is missing in the request. OTP Invalid: value: type: validation_error code: otp_value_invalid message: provided otp is not valid. OTP Expired: value: type: validation_error code: otp_expired message: provided otp is expired Max Attempt Expired: value: type: validation_error code: otp_retry_limit_exhaust message: verify otp retry limit is exhausted Response401: description: Invalid client ID and client secret combination. content: application/json: schema: $ref: '#/components/schemas/ErrorResponseSchema' examples: Invalid client ID and client secret combination: value: type: authentication_error code: authentication_failed message: Invalid clientId and clientSecret combination Response403: description: Authentication error (IP not whitelisted). content: application/json: schema: $ref: '#/components/schemas/ErrorResponseSchema' examples: IP not whitelisted: value: type: authentication_error code: ip_validation_failed message: >- IP not whitelisted your current ip is 106.51.91.104.For IP whitelisting assistance, visit our guide at https://www.cashfree.com/docs/secure-id/get-started/integration/ip-whitelisting-verification x-cf-signature header missing: value: type: validation_error code: authentication_failed message: x-cf-signature missing in the request header Response409DuplicateId: description: Conflict error. content: application/json: schema: $ref: '#/components/schemas/ErrorResponseSchema' examples: Conflict Error: value: type: validation_error code: verification_id_already_exists message: verification ID already exists Response422: description: >- Validation error because of insufficient balance to process this request. content: application/json: schema: $ref: '#/components/schemas/ErrorResponseSchema' examples: Insufficient balance: value: type: validation_error code: insufficient_balance message: Insufficient balance to process this request Response500V2: description: Internal error. content: application/json: schema: $ref: '#/components/schemas/ErrorResponseSchema' examples: Internal Server Error: value: type: internal_error code: verification_failed message: something went wrong Response502V2: description: Gateway error. content: application/json: schema: $ref: '#/components/schemas/ErrorResponseSchema' examples: Bad Gateway: value: type: internal_error code: verification_failed message: verification attempt failed schemas: Mobile360VerifyOtpRequestSchema: type: object example: verification_id: test_verification_id otp: '123456' required: - verification_id - otp properties: verification_id: type: string description: >- The same unique ID provided during the [Send OTP](https://www.cashfree.com/docs/api-reference/vrs/v2/mobile-360-otp-flow/mobile-360-send-otp-request) request. example: test_verification_id default: test_verification_id otp: type: string description: >- The OTP sent to the mobile number provided in the [Send OTP](https://www.cashfree.com/docs/api-reference/vrs/v2/mobile-360-otp-flow/mobile-360-send-otp-request) request. example: '123456' default: '123456' Mobile360VerifyOtpResponseSchema: type: object properties: verification_id: type: string description: Unique ID of the verification request. example: test_verification_id_123 reference_id: type: integer description: Unique reference ID for the transaction. example: 987654 status: type: string description: >- It displays the status of the API request. Possible values are - `SUCCESS`: Data has been successfully fetched using the provided mobile number. - `DETAILS_NOT_FOUND`: No data for the given mobile number could be retrieved. example: SUCCESS personal_details: type: object description: Personal information of the individual. properties: full_name: type: string description: Full name of the individual. example: JOHN SNOW gender: type: string description: Gender of the individual. example: MALE total_income: type: string description: Total income of the individual. example: '500000' occupation: type: string description: Occupation of the individual. example: Software Engineer age: type: string description: Age of the individual. example: 30 dob: type: string description: Date of birth of the individual. example: '1994-05-10' relatives_details: type: array items: type: object properties: relation: type: string example: FATHER relative_name: type: string example: Alice Doe phone_numbers: type: array items: type: object properties: type: type: string example: MOBILE phone: type: string example: '9999999999' linked_to: type: string example: CREDIT emails: type: array items: type: object properties: email: type: string example: john.doe@example.com linked_to: type: string example: PAN passport_details: type: array items: type: object properties: passport_number: type: string example: PA123456 linked_to: type: string example: CREDIT bank_account_details: type: array items: type: object properties: bank_account: type: string example: '123456789012' ifsc: type: string example: HDFC0001234 bank_address: type: string example: MG Road, Bangalore linked_to: type: string example: UAN aadhaar_details: type: array items: type: object properties: masked_aadhaar_number: type: string example: XXXXXXXX8848 linked_to: type: string example: PAN ration_card_details: type: array items: type: object properties: ration_card_number: type: string example: TN1234567890 linked_to: type: string example: CREDIT driving_license_details: type: array items: type: object properties: driving_license_number: type: string example: KA0120198900984 linked_to: type: string example: CREDIT voter_details: type: array items: type: object properties: voter_id: type: string example: UAI4574761 linked_to: type: string example: CREDIT pan_details: type: array items: type: object properties: pan_number: type: string example: ABCDE1234F metadata: type: object properties: registered_name: type: string example: JOHN SNOW name_pan_card: type: string example: JOHN SNOW type: type: string example: Individual or Person aadhaar_linked: type: boolean example: true addresses: type: array items: type: object properties: address: type: string example: 123, 4th Cross, MG Road type: type: string example: Primary state: type: string example: Karnataka pincode: type: string example: '560001' city: type: string example: Bangalore street: type: string example: MG Road country: type: string example: India linked_to: type: string example: PAN employment_details: type: object description: Employment details of the individual. properties: uan: type: array items: type: object properties: uan: type: string example: '200123456789' member_id: type: string example: XYZAB00123450000005678 establishment_id: type: string example: XYZAB0012345000 exit_date: type: string nullable: true example: null joining_date: type: string example: '2018-05-10' leave_reason: type: string nullable: true example: null establishment_name: type: string example: ABC TECHNOLOGIES PVT LTD uan_linked_aadhaar: type: boolean example: true recent_employment_details: type: object properties: employee_details: type: object properties: member_id: type: string example: XYZAB00123450000005678 exit_date: type: string nullable: true example: null joining_date: type: string example: '2018-05-10' uan: type: string example: '200123456789' epfo: type: object properties: recent: type: boolean example: true name_unique: type: boolean example: true pf_filings_details: type: boolean example: true employed: type: boolean example: true employee_name_match: type: boolean example: true exit_date_marked: type: boolean example: false employer_details: type: object properties: establishment_id: type: string example: XYZAB0012345000 establishment_name: type: string example: ABC TECHNOLOGIES PVT LTD setup_date: type: string example: '2012-03-15' ownership_type: type: string example: Private Limited Company employer_confidence_score: type: number format: float example: 85.5 employer_name_match: type: boolean example: true pf_filing_details: type: array items: type: object properties: total_amount: type: integer example: 32145678 employees_count: type: integer example: 5678 wage_month: type: string example: JAN-25 mobile_number_intelligence: type: object description: Provides intelligence on mobile number. properties: is_valid_number: type: boolean description: Whether the provided phone number is valid. example: true subscriber_status: type: string description: Current network status of the subscriber. example: CONNECTED connection_type: type: string description: Type of mobile connection. example: PREPAID current_service_provider: type: string description: Name of the current mobile network provider. example: AIRTEL original_service_provider: type: string description: Name of the original mobile network provider before any porting. example: AIRTEL network_region: type: string description: Region or location associated with the mobile number. example: India is_ported: type: boolean description: >- Indicates whether the number has been ported to a different service provider. example: false credit_score: type: integer description: Credit score of the individual. example: 805 risk_intelligence: type: object description: Provides risk intelligence analysis for the mobile number. properties: is_safe: type: boolean description: >- Indicates whether the mobile number is considered safe from a risk perspective. example: false risk_level: type: string description: |- The assessed risk level of the mobile number. Possible values: - `VERY_HIGH` - `MEDIUM` - `LOW` example: LOW risk_reason: type: string description: |- Reason for the risk assessment. Possible values: - `Cyber Crime` - `Forged KYC` - `Non-compliant KYC` - `Fraud Suspension` - `Other Complaints` - `Inactive SIM` example: Inactive SIM risk_description: type: string description: >- Detailed description of the identified risk factors. Possible values: - `Flagged by law enforcement (I4C/NCRB) for scams, phishing, or fraud` - `SIM issued using forged or fraudulent documents` - `Subscriber KYC found non-compliant by DoT or TSP` - `Suspended by telecom provider due to internal fraud checks` - `Other DoT-reported compliance issues` - `SIM inactive or unused for an extended period` example: SIM inactive or unused for an extended period added_on: type: string format: date-time description: Timestamp when the risk intelligence data was first added. example: '2025-06-23T12:42:10Z' last_updated_on: type: string format: date-time description: Timestamp when the risk intelligence data was last updated. example: '2025-09-09T17:00:11Z' ErrorResponseSchema: type: object properties: code: type: string example: x-client-id_missing error: type: object example: ref_id: 102 message: type: string example: x-client-id is missing in the request. description: It displays the outcome of the error. type: type: string example: validation_error description: It displays the type of error. examples: VerificationIdMissing: value: type: validation_error code: verification_id_missing message: verification_id is missing in the request. securitySchemes: XClientID: type: apiKey in: header name: x-client-id description: >- Your unique client identifier issued by Cashfree. You can find this in your [Merchant Dashboard](https://merchant.cashfree.com/verificationsuite/developers/api-keys). XClientSecret: type: apiKey in: header name: x-client-secret description: >- The secret key associated with your client ID. Use this to authenticate your API requests. You can find this in your [Merchant Dashboard](https://merchant.cashfree.com/verificationsuite/developers/api-keys). ````