curl -X POST https://qa-payments.mygigsters.com.au/api/v1/verify/passport \
-u "YOUR_UUID:YOUR_SECRET" \
-H "X-API-Version: 1.2" \
-H "Content-Type: application/json" \
-d '{
"birth_date": "1972-09-02",
"given_name": "John",
"family_name": "Smith",
"travel_document_number": "C5100511",
"gender": "M"
}'
const response = await fetch("https://qa-payments.mygigsters.com.au/api/v1/verify/passport", {
method: "POST",
headers: {
Authorization: "Basic " + Buffer.from("YOUR_UUID:YOUR_SECRET").toString("base64"),
"X-API-Version": "1.2",
"Content-Type": "application/json",
},
body: JSON.stringify({
"birth_date": "1972-09-02",
"given_name": "John",
"family_name": "Smith",
"travel_document_number": "C5100511",
"gender": "M"
}),
});
const data = await response.json();
console.log(data);
import requests
response = requests.post(
"https://qa-payments.mygigsters.com.au/api/v1/verify/passport",
auth=("YOUR_UUID", "YOUR_SECRET"),
headers={
"X-API-Version": "1.2",
},
json={
"birth_date": "1972-09-02",
"given_name": "John",
"family_name": "Smith",
"travel_document_number": "C5100511",
"gender": "M",
},
)
print(response.json())
require "net/http"
require "json"
require "uri"
uri = URI("https://qa-payments.mygigsters.com.au/api/v1/verify/passport")
request = Net::HTTP::Post.new(uri)
request.basic_auth("YOUR_UUID", "YOUR_SECRET")
request["X-API-Version"] = "1.2"
request["Content-Type"] = "application/json"
request.body = <<~JSON
{
"birth_date": "1972-09-02",
"given_name": "John",
"family_name": "Smith",
"travel_document_number": "C5100511",
"gender": "M"
}
JSON
response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
http.request(request)
end
puts JSON.parse(response.body)
<?php
$ch = curl_init("https://qa-payments.mygigsters.com.au/api/v1/verify/passport");
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_USERPWD => "YOUR_UUID:YOUR_SECRET",
CURLOPT_HTTPHEADER => [
"X-API-Version: 1.2",
"Content-Type: application/json",
],
CURLOPT_POSTFIELDS => <<<'JSON'
{
"birth_date": "1972-09-02",
"given_name": "John",
"family_name": "Smith",
"travel_document_number": "C5100511",
"gender": "M"
}
JSON,
]);
$response = curl_exec($ch);
curl_close($ch);
print_r(json_decode($response, true));
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.util.Base64;
public class Example {
public static void main(String[] args) throws Exception {
String credentials = Base64.getEncoder()
.encodeToString("YOUR_UUID:YOUR_SECRET".getBytes());
String body = String.join("\n",
"{",
" \"birth_date\": \"1972-09-02\",",
" \"given_name\": \"John\",",
" \"family_name\": \"Smith\",",
" \"travel_document_number\": \"C5100511\",",
" \"gender\": \"M\"",
"}"
);
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://qa-payments.mygigsters.com.au/api/v1/verify/passport"))
.header("Authorization", "Basic " + credentials)
.header("X-API-Version", "1.2")
.header("Content-Type", "application/json")
.method("POST", HttpRequest.BodyPublishers.ofString(body))
.build();
HttpResponse<String> response = HttpClient.newHttpClient()
.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
}
}
package main
import (
"fmt"
"io"
"net/http"
"strings"
)
func main() {
body := strings.NewReader(`{
"birth_date": "1972-09-02",
"given_name": "John",
"family_name": "Smith",
"travel_document_number": "C5100511",
"gender": "M"
}`)
req, err := http.NewRequest("POST", "https://qa-payments.mygigsters.com.au/api/v1/verify/passport", body)
if err != nil {
panic(err)
}
req.SetBasicAuth("YOUR_UUID", "YOUR_SECRET")
req.Header.Set("X-API-Version", "1.2")
req.Header.Set("Content-Type", "application/json")
res, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer res.Body.Close()
data, _ := io.ReadAll(res.Body)
fmt.Println(string(data))
}
using System.Net.Http.Headers;
using System.Text;
using var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Post, "https://qa-payments.mygigsters.com.au/api/v1/verify/passport");
request.Headers.Authorization = new AuthenticationHeaderValue(
"Basic", Convert.ToBase64String(Encoding.UTF8.GetBytes("YOUR_UUID:YOUR_SECRET")));
request.Headers.Add("X-API-Version", "1.2");
request.Content = new StringContent(@"{
""birth_date"": ""1972-09-02"",
""given_name"": ""John"",
""family_name"": ""Smith"",
""travel_document_number"": ""C5100511"",
""gender"": ""M""
}", Encoding.UTF8, "application/json");
var response = await client.SendAsync(request);
Console.WriteLine(await response.Content.ReadAsStringAsync());
{
"message": "Verification Result",
"data": {
"documentResult": {
"attributes": {
"i:type": "PassportResponse"
},
"ActivityId": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
"OriginatingAgencyCode": "XXXX",
"VerificationRequestNumber": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
"VerificationResultCode": "Y"
},
"documentDetails": {
"BirthDate": "Full Match",
"BirthDay": "Full Match",
"BirthMonth": "Full Match",
"BirthYear": "Full Match",
"ExpiryDay": "Full Match",
"ExpiryMonth": "Full Match",
"ExpiryYear": "Full Match",
"ExpiryDate": "Full Match",
"GivenName": "Full Match",
"MiddleName": "Full Match",
"FamilyName": "Full Match",
"TravelDocumentNumber": "Full Match",
"Gender": "Full Match",
"RegistrationState": "Full Match"
},
"status": "Y"
}
}
Document verification
Verify passport
This endpoint verifies an Australian passport against official government records. It performs a field-by-field comparison and returns match results for each submitted detail including name, birth date, travel document number, gender,…
POST
/
verify
/
passport
curl -X POST https://qa-payments.mygigsters.com.au/api/v1/verify/passport \
-u "YOUR_UUID:YOUR_SECRET" \
-H "X-API-Version: 1.2" \
-H "Content-Type: application/json" \
-d '{
"birth_date": "1972-09-02",
"given_name": "John",
"family_name": "Smith",
"travel_document_number": "C5100511",
"gender": "M"
}'
const response = await fetch("https://qa-payments.mygigsters.com.au/api/v1/verify/passport", {
method: "POST",
headers: {
Authorization: "Basic " + Buffer.from("YOUR_UUID:YOUR_SECRET").toString("base64"),
"X-API-Version": "1.2",
"Content-Type": "application/json",
},
body: JSON.stringify({
"birth_date": "1972-09-02",
"given_name": "John",
"family_name": "Smith",
"travel_document_number": "C5100511",
"gender": "M"
}),
});
const data = await response.json();
console.log(data);
import requests
response = requests.post(
"https://qa-payments.mygigsters.com.au/api/v1/verify/passport",
auth=("YOUR_UUID", "YOUR_SECRET"),
headers={
"X-API-Version": "1.2",
},
json={
"birth_date": "1972-09-02",
"given_name": "John",
"family_name": "Smith",
"travel_document_number": "C5100511",
"gender": "M",
},
)
print(response.json())
require "net/http"
require "json"
require "uri"
uri = URI("https://qa-payments.mygigsters.com.au/api/v1/verify/passport")
request = Net::HTTP::Post.new(uri)
request.basic_auth("YOUR_UUID", "YOUR_SECRET")
request["X-API-Version"] = "1.2"
request["Content-Type"] = "application/json"
request.body = <<~JSON
{
"birth_date": "1972-09-02",
"given_name": "John",
"family_name": "Smith",
"travel_document_number": "C5100511",
"gender": "M"
}
JSON
response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
http.request(request)
end
puts JSON.parse(response.body)
<?php
$ch = curl_init("https://qa-payments.mygigsters.com.au/api/v1/verify/passport");
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_USERPWD => "YOUR_UUID:YOUR_SECRET",
CURLOPT_HTTPHEADER => [
"X-API-Version: 1.2",
"Content-Type: application/json",
],
CURLOPT_POSTFIELDS => <<<'JSON'
{
"birth_date": "1972-09-02",
"given_name": "John",
"family_name": "Smith",
"travel_document_number": "C5100511",
"gender": "M"
}
JSON,
]);
$response = curl_exec($ch);
curl_close($ch);
print_r(json_decode($response, true));
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.util.Base64;
public class Example {
public static void main(String[] args) throws Exception {
String credentials = Base64.getEncoder()
.encodeToString("YOUR_UUID:YOUR_SECRET".getBytes());
String body = String.join("\n",
"{",
" \"birth_date\": \"1972-09-02\",",
" \"given_name\": \"John\",",
" \"family_name\": \"Smith\",",
" \"travel_document_number\": \"C5100511\",",
" \"gender\": \"M\"",
"}"
);
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://qa-payments.mygigsters.com.au/api/v1/verify/passport"))
.header("Authorization", "Basic " + credentials)
.header("X-API-Version", "1.2")
.header("Content-Type", "application/json")
.method("POST", HttpRequest.BodyPublishers.ofString(body))
.build();
HttpResponse<String> response = HttpClient.newHttpClient()
.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
}
}
package main
import (
"fmt"
"io"
"net/http"
"strings"
)
func main() {
body := strings.NewReader(`{
"birth_date": "1972-09-02",
"given_name": "John",
"family_name": "Smith",
"travel_document_number": "C5100511",
"gender": "M"
}`)
req, err := http.NewRequest("POST", "https://qa-payments.mygigsters.com.au/api/v1/verify/passport", body)
if err != nil {
panic(err)
}
req.SetBasicAuth("YOUR_UUID", "YOUR_SECRET")
req.Header.Set("X-API-Version", "1.2")
req.Header.Set("Content-Type", "application/json")
res, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer res.Body.Close()
data, _ := io.ReadAll(res.Body)
fmt.Println(string(data))
}
using System.Net.Http.Headers;
using System.Text;
using var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Post, "https://qa-payments.mygigsters.com.au/api/v1/verify/passport");
request.Headers.Authorization = new AuthenticationHeaderValue(
"Basic", Convert.ToBase64String(Encoding.UTF8.GetBytes("YOUR_UUID:YOUR_SECRET")));
request.Headers.Add("X-API-Version", "1.2");
request.Content = new StringContent(@"{
""birth_date"": ""1972-09-02"",
""given_name"": ""John"",
""family_name"": ""Smith"",
""travel_document_number"": ""C5100511"",
""gender"": ""M""
}", Encoding.UTF8, "application/json");
var response = await client.SendAsync(request);
Console.WriteLine(await response.Content.ReadAsStringAsync());
{
"message": "Verification Result",
"data": {
"documentResult": {
"attributes": {
"i:type": "PassportResponse"
},
"ActivityId": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
"OriginatingAgencyCode": "XXXX",
"VerificationRequestNumber": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
"VerificationResultCode": "Y"
},
"documentDetails": {
"BirthDate": "Full Match",
"BirthDay": "Full Match",
"BirthMonth": "Full Match",
"BirthYear": "Full Match",
"ExpiryDay": "Full Match",
"ExpiryMonth": "Full Match",
"ExpiryYear": "Full Match",
"ExpiryDate": "Full Match",
"GivenName": "Full Match",
"MiddleName": "Full Match",
"FamilyName": "Full Match",
"TravelDocumentNumber": "Full Match",
"Gender": "Full Match",
"RegistrationState": "Full Match"
},
"status": "Y"
}
}
Headers
string
default:"1.2"
required
The API version to use. Supported versions are
1.1 and 1.2.Request Body Parameters
string
required
Date of birth of the passport holder. Format: YYYY-MM-DD.
string
required
The first name of the passport holder.
string
required
The last name of the passport holder.
string
required
The passport/travel document number. One or two alpha characters followed by seven numeric characters, no spaces.
string
required
Gender of the passport holder. Accepted values: M, F, X.
Response Body
| Field | Type | Description |
|---|---|---|
message | string | A message describing the response status (e.g. “Verification Result”). |
dataobject | object | The passport verification result data. |
↳documentResult | object | Contains the overall verification result including ActivityId, OriginatingAgencyCode, VerificationRequestNumber, and VerificationResultCode (“Y” for verified, “N” for not verified). |
↳documentDetails | object | Field-by-field match results. Each field (GivenName, FamilyName, BirthDate, TravelDocumentNumber, Gender, ExpiryDate, etc.) will have a value of “Full Match”, “Partial Match”, or “No Match”. |
↳status | string | Overall verification status. “Y” indicates the passport is verified, “N” indicates it is not verified. |
Response Codes
| Code | Description |
|---|---|
| 200 | The passport was successfully verified and the match results are returned. |
| 400 | Bad Request. Missing or invalid parameters. |
| 401 | Unauthorized. Missing or invalid credentials. |
| 500 | Internal Server Error. |
curl -X POST https://qa-payments.mygigsters.com.au/api/v1/verify/passport \
-u "YOUR_UUID:YOUR_SECRET" \
-H "X-API-Version: 1.2" \
-H "Content-Type: application/json" \
-d '{
"birth_date": "1972-09-02",
"given_name": "John",
"family_name": "Smith",
"travel_document_number": "C5100511",
"gender": "M"
}'
const response = await fetch("https://qa-payments.mygigsters.com.au/api/v1/verify/passport", {
method: "POST",
headers: {
Authorization: "Basic " + Buffer.from("YOUR_UUID:YOUR_SECRET").toString("base64"),
"X-API-Version": "1.2",
"Content-Type": "application/json",
},
body: JSON.stringify({
"birth_date": "1972-09-02",
"given_name": "John",
"family_name": "Smith",
"travel_document_number": "C5100511",
"gender": "M"
}),
});
const data = await response.json();
console.log(data);
import requests
response = requests.post(
"https://qa-payments.mygigsters.com.au/api/v1/verify/passport",
auth=("YOUR_UUID", "YOUR_SECRET"),
headers={
"X-API-Version": "1.2",
},
json={
"birth_date": "1972-09-02",
"given_name": "John",
"family_name": "Smith",
"travel_document_number": "C5100511",
"gender": "M",
},
)
print(response.json())
require "net/http"
require "json"
require "uri"
uri = URI("https://qa-payments.mygigsters.com.au/api/v1/verify/passport")
request = Net::HTTP::Post.new(uri)
request.basic_auth("YOUR_UUID", "YOUR_SECRET")
request["X-API-Version"] = "1.2"
request["Content-Type"] = "application/json"
request.body = <<~JSON
{
"birth_date": "1972-09-02",
"given_name": "John",
"family_name": "Smith",
"travel_document_number": "C5100511",
"gender": "M"
}
JSON
response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
http.request(request)
end
puts JSON.parse(response.body)
<?php
$ch = curl_init("https://qa-payments.mygigsters.com.au/api/v1/verify/passport");
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_USERPWD => "YOUR_UUID:YOUR_SECRET",
CURLOPT_HTTPHEADER => [
"X-API-Version: 1.2",
"Content-Type: application/json",
],
CURLOPT_POSTFIELDS => <<<'JSON'
{
"birth_date": "1972-09-02",
"given_name": "John",
"family_name": "Smith",
"travel_document_number": "C5100511",
"gender": "M"
}
JSON,
]);
$response = curl_exec($ch);
curl_close($ch);
print_r(json_decode($response, true));
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.util.Base64;
public class Example {
public static void main(String[] args) throws Exception {
String credentials = Base64.getEncoder()
.encodeToString("YOUR_UUID:YOUR_SECRET".getBytes());
String body = String.join("\n",
"{",
" \"birth_date\": \"1972-09-02\",",
" \"given_name\": \"John\",",
" \"family_name\": \"Smith\",",
" \"travel_document_number\": \"C5100511\",",
" \"gender\": \"M\"",
"}"
);
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://qa-payments.mygigsters.com.au/api/v1/verify/passport"))
.header("Authorization", "Basic " + credentials)
.header("X-API-Version", "1.2")
.header("Content-Type", "application/json")
.method("POST", HttpRequest.BodyPublishers.ofString(body))
.build();
HttpResponse<String> response = HttpClient.newHttpClient()
.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
}
}
package main
import (
"fmt"
"io"
"net/http"
"strings"
)
func main() {
body := strings.NewReader(`{
"birth_date": "1972-09-02",
"given_name": "John",
"family_name": "Smith",
"travel_document_number": "C5100511",
"gender": "M"
}`)
req, err := http.NewRequest("POST", "https://qa-payments.mygigsters.com.au/api/v1/verify/passport", body)
if err != nil {
panic(err)
}
req.SetBasicAuth("YOUR_UUID", "YOUR_SECRET")
req.Header.Set("X-API-Version", "1.2")
req.Header.Set("Content-Type", "application/json")
res, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer res.Body.Close()
data, _ := io.ReadAll(res.Body)
fmt.Println(string(data))
}
using System.Net.Http.Headers;
using System.Text;
using var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Post, "https://qa-payments.mygigsters.com.au/api/v1/verify/passport");
request.Headers.Authorization = new AuthenticationHeaderValue(
"Basic", Convert.ToBase64String(Encoding.UTF8.GetBytes("YOUR_UUID:YOUR_SECRET")));
request.Headers.Add("X-API-Version", "1.2");
request.Content = new StringContent(@"{
""birth_date"": ""1972-09-02"",
""given_name"": ""John"",
""family_name"": ""Smith"",
""travel_document_number"": ""C5100511"",
""gender"": ""M""
}", Encoding.UTF8, "application/json");
var response = await client.SendAsync(request);
Console.WriteLine(await response.Content.ReadAsStringAsync());
{
"message": "Verification Result",
"data": {
"documentResult": {
"attributes": {
"i:type": "PassportResponse"
},
"ActivityId": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
"OriginatingAgencyCode": "XXXX",
"VerificationRequestNumber": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
"VerificationResultCode": "Y"
},
"documentDetails": {
"BirthDate": "Full Match",
"BirthDay": "Full Match",
"BirthMonth": "Full Match",
"BirthYear": "Full Match",
"ExpiryDay": "Full Match",
"ExpiryMonth": "Full Match",
"ExpiryYear": "Full Match",
"ExpiryDate": "Full Match",
"GivenName": "Full Match",
"MiddleName": "Full Match",
"FamilyName": "Full Match",
"TravelDocumentNumber": "Full Match",
"Gender": "Full Match",
"RegistrationState": "Full Match"
},
"status": "Y"
}
}
Last modified on November 10, 2026
Was this page helpful?
