PII inquiry without OTP: submit by transaction

POST

/api/FRAServices/CheckIdAndFRAByTransaction

POST

/api/FRAServices/CheckIdAndFRAByTransaction

curl -X POST https://api.vlenseg.com/api/FRAServices/CheckIdAndFRAByTransaction \
     -H "ApiKey: <apiKey>" \
     -H "Content-Type: application/json" \
     -d '{
  "phoneNumber": "01000000000",
  "transactionId": "9c1f0e2a-7b3d-4f5a-8c6e-1d2b3a4c5d6e"
}'

200FRA Services_postFraservicesCheckidandfrabytransaction_example

{
  "data": {
    "phoneNumberOwnerOutput": {
      "isMatched": true,
      "errorCode": 0,
      "errorKey": null,
      "errorMessage": null
    },
    "idFrontOutput": {
      "services": {
        "Validations": {
          "validation_errors": []
        },
        "spoofing": {
          "fake": false
        },
        "classification": {
          "doc_type": "id_front"
        },
        "liveness": null,
        "AML": {
          "AML_matched": false,
          "data": []
        },
        "SRC": null
      },
      "data": {
        "name": "محمد على حسن ابراهيم",
        "first_name": "محمد",
        "last_names": "على حسن ابراهيم",
        "name_english": "Mohamed Ali Hassan Ibrahim",
        "first_name_english": "Mohamed",
        "last_names_english": "Ali Hassan Ibrahim",
        "idNumber": "29001011234567",
        "idKey": "AB1234567",
        "dateOfBirth": "1990-01-01T00:00:00",
        "gender": null,
        "govern": "القاهرة",
        "govern_english": "Cairo",
        "city": "القاهرة",
        "district": "المعادي",
        "address": "١٢ شارع النيل-المعادي القاهرة",
        "address_1": "١٢ شارع النيل",
        "address_2": "المعادي القاهرة",
        "address_english": "12 Nile Street-Maadi Cairo",
        "address_1_english": "12 Nile Street",
        "address_2_english": "Maadi Cairo",
        "client_transaction_id": null,
        "request_id": "00000000-0000-0000-0000-000000000000",
        "transaction_id": "9c1f0e2a-7b3d-4f5a-8c6e-1d2b3a4c5d6e"
      },
      "error_code": null,
      "error_message": null,
      "error_descriptions": null
    },
    "idBackOutput": {
      "services": {
        "Validations": {
          "validation_errors": []
        },
        "spoofing": {
          "fake": false
        },
        "classification": {
          "doc_type": "id_back"
        },
        "liveness": null,
        "AML": null,
        "SRC": null
      },
      "data": {
        "maritalStatus": "متزوج",
        "marital_status_english": "married",
        "job": "مهندس",
        "job_english": "Engineer",
        "jobTitle": "",
        "job_title_english": null,
        "religion": "مسلم",
        "religion_english": "muslim",
        "husbandName": "",
        "husbandName_english": null,
        "releaseDate": "2023-04-01T00:00:00",
        "idExpiry": "2030-04-29T00:00:00",
        "idNumber": "29001011234567",
        "gender": "ذكر",
        "gender_english": "male",
        "client_transaction_id": null,
        "request_id": "00000000-0000-0000-0000-000000000000",
        "transaction_id": "9c1f0e2a-7b3d-4f5a-8c6e-1d2b3a4c5d6e"
      },
      "error_code": null,
      "error_message": null,
      "error_descriptions": null
    },
    "csoOutput": {
      "isValid": true,
      "errorCode": 0,
      "errorMessage": null
    },
    "criminalRecordValidationOutput": null
  },
  "error_code": null,
  "error_message": null,
  "error_descriptions": null
}

Runs the PII inquiry against the ID images of an existing transaction — an earlier OCR or Digital Identity capture — instead of resending the images.

This is the no-OTP variant: no phone-ownership proof is required. To prove the user controls the phone number first, use the with OTP variant of this endpoint — same URL, plus otpRequestId and otpCode.

Runs the PII inquiry against the ID images of an existing transaction — an earlier OCR or Digital Identity capture — instead of resending the images. This is the no-OTP variant: no phone-ownership proof is required. To prove the user controls the phone number first, use the [**with OTP** variant of this endpoint](/api-reference/vlens-api/fra-services/post-fraservices-checkidandfrabytransaction-with-otp) — same URL, plus `otpRequestId` and `otpCode`.

Authentication

ApiKeystring

Static API key issued to your tenant. Required on every request.

AuthorizationBearer

End-user JWT from registration or login. Required for verification, signing, and user-scoped operations.

Request

This endpoint expects an object.

phoneNumberstringRequired

The phone number being validated.

transactionIdstringRequiredformat: "uuid"

The transaction whose ID front and back were already processed.

Response

PII inquiry result.

dataobjectOptional

error_codeinteger or nullOptional

error_messagestring or nullOptional

error_descriptionslist of strings or nullOptional