Impact the future of visa services.

Build your custom app
Looking for developer opportunities in an niche market?

Provide your users with extensive visa services at no operational cost
Integrate visa services
Run your own travel or legal business?

Expand your business opportunities by bundling visa services with yours
Use pre-built plugins
Need a quick launch without a developer?

Customize and install our ready-to-go plugins just by pasting the JS code into your website
Explore API requests
Get a list of visa offers
Get Application Form
Save Order
Submit the Order
Upload Documents
Check Order Status
//insert code here
POST https://bvhq11p.visahq.org/v0/services/5/search

// HTTP request headers
{
    "Date": "", /*Thu, 01 Aug 2019 09:35:33 GMT*/
    "Token": "",
    "Authorization": "",
}

// HTTP request body
{
    "residency": "CN",  //customer’s residency
    "citizenship": "CN", //customer’s citizenship
    "destination": enum ("TR","LK","IN","KH","VN","MM","TJ","GE","KG","AM","AZ","…"), //destinations alpha2 code
    "visa_group": 68, //visa type (tourist, business, etc.)
}

//response example
{
    "id":,
    "service_id":,
    "residency":"",
    "citizenship":"",
    "destination":"",
    "visa_group":,
    "Prices":[
    // bold selection below is iterative and shows all available combinations of visa processing times
    // and visa types. Cost information should be ignored
/strong        {
/strong            "keys":{
/strong                "proc_time":{
/strong                    "id":4,
/strong                    "name":"2-3 business days",
/strong                    "days_count":3
/strong                },
/strong                "visa_type":{
/strong                    "id":3,
/strong                    "name":"90 days Multiple Entry"
/strong                }
/strong            },
/strong            "fields":[
/strong                {
/strong                    "id":"0",
/strong                    "label":"Embassy fee",
/strong                    "Value":88
/strong                },
/strong                {
/strong                    "id":"1",
/strong                    "label":"Service fee",
/strong                    "value":35.7
/strong                }]
/strong        }/end_strong]
}
//end code

Returns 404 if no application available

//insert code here   (/strong  - bold line.  End  /end_strong)
// service_item_id is a value received from previous (Get a list of visa offers) request
GET https://bvhq11p.visahq.org/v0/services/5/items//application

//Simplified response example. Full responses can be found in archive
{
    "service_id":,
    "service_item_id":,
    "items":[ # Questions section
        {
            "label":"Traveler contacts",
            "items":[ # Questions group
                {
                    "is_iterated":false,
                    "conditions":[
                        {
                            "question_id": "refused"
                            "value": "true",
                            "operator":"="
                        }
                    ],
                    "items":[ # Questions
                        {
                            "id":"homeaddress",
                            "is_required":false,
                            "label":"Home address",
                            "help":"Please provide address where you currently reside.",
                            "view":"text"
                        }
                    ]
                }
            ]
        }
    ]
}
//end code
//insert code here   (/strong  - bold line)
//Simplified request example. Full request can be found in archive
//price object need to be an exact copy of the proper element from the prices array received from Get Application 
// ID function
POST https://bvhq11p.visahq.org/v0/basket/add-service
{
    "price":{
        "keys":{
            "proc_time":{
                "id":4,
                "name":"2-3 business days",
                "Days_count":3
            },
            "visa_type":{
                "id":3,
                "name":"90 days Multiple Entry"
            }
        },
        "fields":[
            {
                "id":"0",
                "label":"Embassy fee",
                "value":88
            },
            {
                "id":"1",
                "label":"Service fee",
                "value":35.7
            }
        ]
    },
    "service":,
    "service_item":,
    "application":{
        "first-name":["John"],
        "last-name":["Doe"]
    }
}

// Simplified response example. Full responses can be found in archive
{
    "":{
        
    }
}
//end code
//insert code here   (/strong  - bold line)
POST https://bvhq11p.visahq.org/v0/basket/finish
{
    "Invoice":{}
}

//Full Response can be found in archive

{
    "id": 1503,
    "invoice": "DE1385",
    "user_id": "13041",
    "status": "unpaid",
    "created": "2017-12-28T11:38:50.786+00:00",
    "updated": "2017-12-28T11:38:50.897+00:00",
    "total": 219,
    "service_list": [..]
}

//Make sure you save order_id. It will be used in further calls
//end code
//insert code here   (/strong  - bold line)
POST https://bvhq11p.visahq.org//v0/orders/{orderId}/files

// Request body contains a file that needs to be uploaded
// Note: only one file per request

{
    "id":123,
    "date": "2017-12-28T11:29:25.657+00:00",
    "author":"John Smith",
    "url":"https://bvhq11p.visahq.org/v0/orders/{orderId}/downloads/123"
}
//end code
//insert code here   (/strong  - bold line)
GET  https://bvhq11p.visahq.org//v0/external-orders/{orderId}

//The response is the same as in Submit Order call

{
    "id": 1503,
    "invoice": "DE1385",
    "user_id": "13041",
    "status": "unpaid",
    "created": "2017-12-28T11:38:50.786+00:00",
    "updated": "2017-12-28T11:38:50.897+00:00",
    "total": 219,
    "service_list": [
        {
            "id": 1480,
            "order_id": 1503,
            "currency": {
                "code": "EUR",
                "numeric": "978",
                "label": "Euro"
            },
            "total": 219,
            "created": "2017-12-28T11:38:50.790+00:00",
            "updated": "2017-12-28T11:38:50.790+00:00",
            "status": "pending",
            //……..
        }
    ]
}

//Application status located at service_list[0].status
//end code
Check API Reference
VisaHQ has dozens of endpoints for all the touchpoints of visa services. If you already have something in mind, this extensive API reference is the right place to start.
Getting Started
Need step-by-step guidance to explore all the features?
Proceed with an extensive ‘Getting Started’ Guide to start exploring.
Start providing visa services in just days!