POST
/
recognition
Recognize and verify ID document
curl --request POST \
  --url https://idverify-api.argosidentity.com/modules/recognition \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '{
  "idImage": "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNkYPhfDwAChwGA60e6kgAAAABJRU5ErkJggg==",
  "idBackImage": "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNkYPhfDwAChwGA60e6kgAAAABJRU5ErkJggg==",
  "issuingCountry": "USA",
  "idType": "government_id",
  "callbackUrl": "https://your-domain.com/callback"
}'
{
  "apiType": "global_id_recognition",
  "transactionId": "txn_123456789",
  "result": {
    "documentInfo": {
      "documentType": "National ID",
      "issuingCountry": "USA",
      "documentNumber": "123456789",
      "issueDate": "2020-01-15",
      "expiryDate": "2030-01-15",
      "issuingAuthority": "Department of Motor Vehicles"
    },
    "personalInfo": {
      "fullName": "John Michael Smith",
      "firstName": "John",
      "middleName": "Michael",
      "lastName": "Smith",
      "dateOfBirth": "1985-03-15",
      "gender": "M",
      "nationality": "USA",
      "address": {
        "street": "123 Main Street",
        "city": "Springfield",
        "state": "IL",
        "zipCode": "62701",
        "country": "USA"
      }
    },
    "verificationStatus": {
      "isValid": true,
      "confidence": 0.95,
      "verificationScore": 0.92,
      "securityFeatures": {
        "hologram": true,
        "uvElements": true,
        "microprinting": true
      }
    },
    "ocrData": {
      "extractedText": "Complete extracted text from document",
      "confidence": 0.98,
      "processingTime": 2.5
    }
  }
}

​
Global ID Recognition API

The Global ID Recognition API processes and verifies identification documents by analyzing both the front and back images of the ID, along with the issuing country and ID type. This API ensures the authenticity and validity of the provided ID through detailed OCR (Optical Character Recognition) and provides comprehensive results.

​
API Overview

The Global ID Recognition API provides a powerful tool for worldwide ID document processing with the following capabilities:
  • Worldwide Support: Process ID documents from multiple countries
  • Automatic Recognition: Automatically detect ID type and issuing country
  • OCR Technology: Advanced optical character recognition for text extraction
  • Data Extraction: Extract structured data from ID documents
  • Verification: Verify document authenticity and validity
  • Multi-Format Support: Handle various ID document formats

​
Request Parameters

​
Required Parameters

  • idImage: Image of the front side of the ID document in base64 format
  • issuingCountry: The ISO 3 Alpha Country Code of the issuing country for the ID document
  • idType: The type of the ID document

​
Optional Parameters

  • idBackImage: Image of the back side of the ID document in base64 format
  • callbackUrl: The URL where the recognition results will be sent upon completion

​
Optional Parameters

  • callbackUrl: The URL where the recognition results will be sent upon completion

​
Authentication

  • x-api-key: API key essential for authentication and access control purposes

​
Response Format

The API returns detailed recognition results including:
  • apiType: API type identifier
  • transactionId: Unique identifier for each request
  • result: Object containing the processing result
    • documentInfo: Extracted document information
    • personalInfo: Extracted personal information
    • verificationStatus: Document verification status

​
Supported Countries and ID Types

​
Countries

  • USA: United States
  • CAN: Canada
  • MEX: Mexico
  • BRA: Brazil
  • ARG: Argentina
  • GBR: United Kingdom
  • DEU: Germany
  • FRA: France
  • ESP: Spain
  • ITA: Italy
  • KOR: South Korea
  • JPN: Japan
  • CHN: China
  • AUS: Australia
  • NZL: New Zealand

​
ID Types

  • government_id: An official identification document issued by a government, typically used for verifying the identity of an individual
  • passport: An official travel document issued by a government, certifying the holder’s identity and nationality, primarily used for international travel
  • drivers_license: An official document permitting a specific individual to operate one or more types of motorized vehicles, such as motorcycles, cars, trucks, or buses
  • residence_permit: An official document that allows a foreign individual to reside in a country for a certain period, typically issued by the immigration authority
  • vehicle_registration_certificate: An official document providing proof of registration of a vehicle, including details about the vehicle and the owner
  • visa: An official endorsement placed in a passport indicating that the holder is allowed to enter, leave, or stay for a specified period in a country
  • aadhaar: A unique 12-digit identification number issued by the Indian government to residents of India, based on their biometric and demographic data
  • pancard: A permanent account number (PAN) card issued by the Indian government to individuals and entities, used primarily for tax purposes

​
Use Cases

  • KYC Processes: Streamline customer identity verification
  • Banking: Verify customer identity for account opening
  • Travel: Process travel documents and visas
  • Employment: Verify employee identity and work permits
  • Government Services: Process official identification documents

​
Processing Modes

​
Synchronous Processing

  • Immediate response with recognition results
  • Best for real-time applications
  • Direct API response

​
Asynchronous Processing

  • Use callback URL for delayed results
  • Better for batch processing
  • Detailed callback response format

​
Image Requirements

​
File Size

  • Recommended: Less than 10MB
  • Maximum: 50MB

​
Image Quality

  • Resolution: Minimum 300 DPI recommended
  • Format: High contrast, well-lit images work best
  • Orientation: Document should be properly oriented

​
Supported Formats

  • JPEG (.jpg, .jpeg)
  • PNG (.png)

​
Error Handling

​
Common Error Scenarios

Status CodeError TypeDescription
400Bad RequestInvalid image format or corrupted data
401UnauthorizedInvalid or missing API key
413Payload Too LargeImage file too large
415Unsupported Media TypeUnsupported file format
429Too Many RequestsRate limit exceeded
500Internal Server ErrorServer processing error

Authorizations

​
x-api-key
string
header
required

Body

application/json

Response

200
application/json

Successful ID recognition

The response is of type object.