AOP Services

Vehicle RC Validation API Documentation

POST https://api.aopay.co.in/api/AOP/V1/Validation/RC

The RC Validation API retrieves vehicle registration details associated with a given Registration Certificate (RC) number. It requires two mandatory inputs: the RC Number and the Registration ID. Upon successful validation, the API fetches the corresponding vehicle registration information and returns the response in JSON format.

Body Parameters

{  
 "RegistrationID":"AOP-XXX",
 "RCNumber":"UPXXBSXXXX"                           
}

Request Parameters

Name	Type	Mandatory	Description
RegistrationID	String	Yes	Registration ID provided during partner onboarding.
RCNumber	String	Yes	Vehicle RC Number. No special characters are allowed (Min Length: 6 Max Length: 10) Pattern: "^[A-Z]{2}\d[A-Z]{2}\d{4}$\|^[A-Z]{2}\d{2}[A-Z0-9]{2}\d{3,4}$\| ^[A-Z]{2}\d{2}[A-Z]\d{4}$\|^[A-Z]{2}\d{6}$\|^[A-Z]{3}\d{4}\|^[A- Z]{2}\d{1}[A-Z]{3}\d{3,4}$\|^[A-Z]{2}\d{1}[A-Z]{1}\d{4}\|^[A-Z]{ 2}\d{2}[A-Z]{1}\d{3}$\|^[A-Z]{2}\d[A-Z]{3}\d{4}$\|^[A-Z]{2}\d{2 }[A-Z]{1,2}\d{2}$\|^[0-9]{2}[B,H]{2}[0-9]{4}[A-Z]{1,2}$"

Responses

200

Response

200

RESPONSE BODY

object

Response

401

RESPONSE BODY

returnMessage string

401

412

Response

412

RESPONSE BODY

returnMessage string

Did this page help you? Yes No

Language

Shell

Python

Node

PHP

cURL

curl --location 'https://api.aopay.co.in/api/AOP/V1/Validation/RC' \
--header 'Content-Type: application/json' \
--data  '{
   "RegistrationID": "AOP-XXX",
   "RCNumber": "UPXXBSXXXX"
}'

import requests
import json

url = 'https://api.aopay.co.in/api/AOP/V1/Validation/RC'
payload = json.dumps({
    "RegistrationID": "AOP-XXX",
    "RCNumber": "UPXXBSXXXX"
}) 

headers = {
  "Content-type" : "application/json"
}

response = requests.request("POST", url, headers=headers, data=payload)

print (response.text)

var requests = require("request");
var options = { 
  "method" : "POST",
  "url" : 'https://api.aopay.co.in/api/AOP/V1/Validation/RC',
  "headers" : {
    "Content-Type" : 'application/json'
  },
  body: JSON.stringify({
    "RegistrationID": "AOP-XXX",
    "RCNumber": "UPXXBSXXXX"
  }) 
}; 
request(options, function(error, response){
   if(error) throw new Error(error);
   console.log(response.body); 
});

var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Post,'https://api.aopay.co.in/api/AOP/V1/Validation/RC')
var content = new StringContent(
  "{
    "RegistrationID": "AOP-XXX",
    "RCNumber": "UPXXBSXXXX"
  }",
  null,"application/json"
); 

request.Content = content;
var response =  await client.SendAsync(request);
response.EnsureSuccessStatusCode();
Console.WriteLine(await response.Content.ReadAsStringAsync());

<?php
$curl =  curl_init();
curl_setopt_array($curl, array(
  CURLOPT_URL =>  'https://api.aopay.co.in/api/AOP/V1/Validation/RC',
  CURLOPT_RETURNTRANSFER =>  true,
  CURLOPT_ENCODING =>  '',
  CURLOPT_MAXREDIRS =>  "10",
  CURLOPT_TIMEOUT =>  0,
  CURLOPT_FOLLOWLOCATION =>  true,
  CURLOPT_HTTP_VERSION =>  CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST =>  'POST',
  CURLOPT_POSTFIELDS =>  '{
    "GSTNumber": "07ABCXXXXX1ZX",
    "RegistrationID": "AOP-XXX"
  }',
  CURLOPT_HTTPHEADER =>  array(
    'Content-Type: application/json'
  ),
));
$response =  curl_exec($curl);
curl_close($curl);
echo $response;

RESPONSE

{
    "http_response_code": 200,
    "client_ref_num": "TERFXXXXX",
    "request_id": "8887XXXX-85XX-11XX-9fXX-c923aeXXXXXX",
    "result_code": 101,
    "result": {
      "reg_no": "UPXXBSXXXX",
      "class": "M-XXXXX/SXXXXXX(2Wn)",
      "chassis": "XXXXX11ALE9LXXXXX",
      "engine": "XXXXXJELXXXXX",
      "vehicle_manufacturer_name": "XXXXXXX XXXX Ltd",
      "model": "XX DeXXXX",
      "vehicle_colour": "XXX/XXX",
      "type": "Petrol",
      "norms_type": "EURO 2",
      "body_type": "Solo",
      "owner_count": "1",
      "owner_name": "RXXXXXX",
      "owner_father_name": "",
      "mobile_number": "",
      "status": "Active",
      "status_as_on": "XX-XX-XXXX", 
      "reg_authority": "XXXXXXX XXXX",
      "reg_date": "XX-XX-XXXX",
      "vehicle_manufacturing_month_year": "XX/XXXX", 
      "rc_expiry_date": "XX-XX-XXXX",
      "vehicle_tax_upto": "XX-XX-XXXX",
      "vehicle_insurance_company_name": "IcXXX XXXXXXX",
      "vehicle_insurance_upto": "XX-XX-XXXX",
      "vehicle_insurance_policy_number": "259XXXXX",
      "rc_financer": "",
      "present_address": "XXXXX",
      "split_present_address": {
          "district": [],
          "state": [],
          "city": [],
          "pincode": "XXX9XX",
          "country": [],
          "address_line": "XXXXX"
        },
      "permanent_address": "XXXXX",
      "split_permanent_address": {
          "district": [],
          "state": [],
          "city": [],
          "pincode": "XXX9XX",
          "country": [],
          "address_line": "XXXXX"
        },
      "vehicle_cubic_capacity": "9XXX",
      "gross_vehicle_weight": "2XX",
      "unladen_weight": "1XX",
      "vehicle_category": "2XX",
      "rc_standard_cap": "",
      "vehicle_cylinders_no": "X",
      "vehicle_seat_capacity": "X",
      "vehicle_sleeper_capacity": "",
      "vehicle_standing_capacity": "X",
      "wheelbase": "1XXX",
      "pucc_number": "",
      "pucc_upto": "",
      "blacklist_status": "",
      "blacklist_details": [],
      "challan_details": [],
      "permit_issue_date": "",
      "permit_number": "",
      "permit_type": "",
      "permit_valid_from": "",
      "permit_valid_upto": "",
      "non_use_status": "",
      "non_use_from": "",
      "non_use_to": "",
      "national_permit_number": "",
      "national_permit_upto": "",
      "national_permit_issued_by": "",
      "is_commercial": "",
      "noc_details": "",
      "rto_code": "UXXX",
      "financed": false
     },
    "error": null,
    "Status": "True",
    "message": "RC Details Validate Successfully",
    "Value": ""                             
}

 
{
    "returnMessage": "Unauthorized access. Please log in again."
}

 
{
   "returnMessage": "Invalid registration ID"
}

 
{
   "returnMessage": "Precondition failed. Please try again."
}