API-Based Integration

Connect the OCI Card Verification API with an existing application using the endpoint, authentication method, and request format specified in the FinAnalyz documentation.

Flexible Input Handling

Submit the identifier, document, or other details accepted by the selected endpoint. Supported inputs may differ by implementation.

Automated Document Processing

Use document extraction or OCR functionality where available to reduce manual entry of OCI card details.

Structured Response Handling

Process the returned verification status and available information according to the documented response schema.

Error Handling

Handle invalid inputs, authentication failures, mismatched details, unsupported documents, and service errors according to the API’s documented responses.

Secure Integration Practices

Use HTTPS where supported, protect API credentials, restrict access to personal information, and avoid storing unnecessary identity or passport data.

Suggested Input JSON (Illustrative Only)

The following example is conceptual and is not a confirmed production request schema. The actual input depends on the supported endpoint.

{
  "oci_card_number": "<OCI_CARD_NUMBER>",
  "passport_number": "<PASSPORT_NUMBER>"
}

Suggested Output JSON (Illustrative Only)

This example demonstrates a possible response structure only. The actual fields and verification status must be confirmed in the FinAnalyz API documentation.

{
  "success": true,
  "message": "Verification request processed",
  "data": {
    "verification_status": "<STATUS>",
    "oci_card_number": "<OCI_CARD_NUMBER>",
    "name_match": "<TRUE_OR_FALSE>",
    "passport_match": "<TRUE_OR_FALSE>"
  }
}

Important Integration Note: Confirm the production endpoint, accepted inputs, authentication requirements, verification source, jurisdiction coverage, response fields, and error codes before implementation. Document extraction or matching of submitted fields does not, by itself, prove that an OCI card is genuine or currently valid. The Government of India’s official OCI Services Portal provides OCI-related services and cardholder information, but access to government records through a third-party API should not be assumed.