RBA Cash Rate: 4.35% · 1AUD = 0.67 USD · Inflation: 4.1%  
Leading Digital Marketing Experts | 1300 235 433 | Aggregation Enquires Welcome | Book Appointment
Example Interest Rates: Home Loan Variable: 5.38% (6.14%*) • Home Loan Fixed: 5.44% (6.26%*) • Fixed: 5.44% (6.26%*) • Variable: 5.38% (6.14%*) • Investment IO: 5.69% (6.52%*) • Investment PI: 5.49% (5.98%*)

CASA Aircraft Register API

CASA Aircraft Register API

We have provided CASA Aircraft Register search functionality on multiple websites we've operated for some time and, as such, supported an API to centralise the data. While that data has always been available to clients, this article serves as a brief introduction to the API for those that are unaware of its existence. We've long advocated that flying schools (and other grass-root aviation organisations) have a register search engine on their website such as the one our WordPress plugin provides. The data source attracts a cold web audience, keeps people coming back to your website as a resource (as it should be), and provides for an internal reference.

Want access to this API? Like us on Facebook and it'll be made available to you.

Our data source checks the CASA website for updates on a daily basis, and the API itself provides data connected to the aircraft (other than registration details), such as investigation reports and images from various sources.

The Result

The query URL for all requests is shown below. As with most of our services - and introduced only recently as a means of mitigating rampant abuse - an API key is required. If you don't have a key and would like access, please make contact with us. For all current and former partners, your existing platform API Key will enjoy lifetime access.

http://api.beliefmedia.com/platform/sources/aircraft/casa/casa.json

Single Registration

For the first example we'll query the aircraft AAG, a 1968 model Cessna C185. Endpoint is casa.json?apikey=xxxxx&id=AAG.

1
Array
2
(
3
    [code] => 200
4
    [status] => 200
5
    [message] => OK
6
    [source] => BeliefMedia | CASA
7
    [api_version] => 0.2
8
    [data] => Array
9
        (
10
            [rego] => AAG
11
            [manufacturer] => CESSNA AIRCRAFT COMPANY
12
            [model] => A185E
13
            [serial] => 1851392
14
            [year_manufacture] => 1968
15
            [mtow] => 1519
16
            [icao_type_designator] => C185
17
            [engine] => Array
18
                (
19
                    [number_engines] => 1
20
                    [engine_manufacturer] => TELEDYNE-CONTINENTAL MOTORS
21
                    [engine_type] => Piston
22
                    [engine_model] => IO-520
23
                    [fuel_type] => Gasoline
24
                )
25
 
26
            [propeller] => Array
27
                (
28
                    [propeller_manufacturer] => HARTZELL PROPELLERS
29
                    [propeller_model] => HC-C3YF-1RF/ F8068-2
30
                )
31
 
32
            [registration] => Array
33
                (
34
                    [rego_type] => Full Registration
35
                    [rego_holder_name] => BIGGS, Andrew Jonathon
36
                    [rego_address_1] => PO Box 100
37
                    [rego_address_2] =>
38
                    [rego_suburb] => GRETA
39
                    [rego_state] => NSW
40
                    [rego_postcode] => 2334
41
                    [rego_country] => Australia
42
                    [rego_commencement_date] => Array
43
                        (
44
                            [date] => 2017-02-10
45
                            [readable] => 10th February 2017
46
                        )
47
 
48
                    [type_certificate_number] => 3A24
49
                )
50
 
51
            [operator] => Array
52
                (
53
                    [operator_name] => BIGGS, Andrew Jonathon
54
                    [operator_address_1] => PO Box 100
55
                    [operator_address_2] =>
56
                    [operator_suburb] => GRETA
57
                    [operator_state] => NSW
58
                    [operator_postcode] => 2334
59
                    [operator_country] => Australia
60
                    [operator_commencement_date] => Array
61
                        (
62
                            [date] => 2017-02-10
63
                            [readable] => 10th February 2017
64
                        )
65
 
66
                )
67
 
68
            [details] => Array
69
                (
70
                    [first_registered] => Array
71
                        (
72
                            [date] => 1974-12-18
73
                            [readable] => 18th December 1974
74
                        )
75
 
76
                    [landing_gear] =>
77
                    [airframe] => Power Driven Aeroplane
78
                    [idera_authorised_party] =>
79
                    [idera_certified_designee] =>
80
                )
81
 
82
            [airworthiness] => Array
83
                (
84
                    [standard_certificate_airworthiness] => Active (Normal)
85
                    [special_certificate_airworthiness] =>
86
                    [CoAcatc] =>
87
                )
88
 
89
        )
90
 
91
    [atsb] => Array
92
        (
93
            [updated] => April 2018
94
            [source] => ATSB.gov.au. Copyright may apply.
95
            [report] => Array
96
                (
97
                    [0] => Array
98
                        (
99
                            [title] => Investigation: 200204471 - Near collision Aero Commander 690-A, VH-AAG, Bankstown Airport, 25 September 2002
100
                            [description] => 15 Oct 2003 | The pilot of a Turbo Commander reported, that when on short final approach to runway 29 centre (29C) at Bankstown Airport, he saw another aircraft, above and slightly to the left of his aircraft, in close proximity. The pilot of the Turbo Commander conducted a go around.... www.atsb.gov.au/publications/investigation_reports/2002/aair/aair200204471/
101
                            [url] => www.atsb.gov.au/publications/investigation_reports/2002/aair/aair200204471/
102
                            [report_url] => publications/investigation_reports/2002/aair/aair200204471
103
                        )
104
 
105
                    [1] => Array
106
                        (
107
                            [title] => Investigation: 199401319 - Icing involving a Aero Commander 690-A, VH-AAG, 96km NNW Launceston, TAS on 18 May 1994
108
                            [description] => 20 Jun 1994 | The pilot reported that enroute at FL210 the aircraft had been cruising on top of stratus cloud in clear sky. About five miles prior to top of descent, thin altostratus was encountered. This prompted the pilot to select the airframe anti-icing systems on. The windscreen heat,.... www.atsb.gov.au/publications/investigation_reports/1994/aair/199401319/
109
                            [url] => www.atsb.gov.au/publications/investigation_reports/1994/aair/199401319/
110
                            [report_url] => publications/investigation_reports/1994/aair/199401319
111
                        )
112
 
113
                    [2] => Array
114
                        (
115
                            [title] => Investigation: 198602634 - Aero Commander 690 A, VH-AAG, Brisbane QLD, 3 January 1986
116
                            [description] => 20 Aug 1986 | As the pilot was manoeuvring the aircraft prior to parking, the right wing tip area struck a steel fence corner-post. The post was bent and several strands of barbed wire were broken, as the wing rode over the post. The pilot was unaware that the aircraft had struck the post, and... www.atsb.gov.au/publications/investigation_reports/1986/aair/aair198602634/
117
                            [url] => www.atsb.gov.au/publications/investigation_reports/1986/aair/aair198602634/
118
                            [report_url] => publications/investigation_reports/1986/aair/aair198602634
119
                        )
120
 
121
                )
122
 
123
        )
124
 
125
    [airliners_net] => Array
126
        (
127
            [updated] => April 2018
128
            [source] => Airliners.net. Copyright may apply.
129
            [url] => http://www.airliners.net/search?registrationActual=VH-AAG
130
            
Image Error
 => Array
131
                (
132
                    [0] => Array
133
                        (
134
                            [url] => http://imgproc.airliners.net/photos/airliners/2/0/5/1145502-v40-6.jpg
135
                            [local] => images/A/AAG/001.jpg
136
                        )
137
 
138
                    [1] => Array
139
                        (
140
                            [url] => http://imgproc.airliners.net/photos/airliners/3/2/9/0760923-v40-6.jpg
141
                            [local] => images/A/AAG/002.jpg
142
                        )
143
 
144
                    [2] => Array
145
                        (
146
                            [url] => http://imgproc.airliners.net/photos/airliners/6/9/1/0223196-v40-6.jpg
147
                            [local] => images/A/AAG/003.jpg
148
                        )
149
 
150
                    [3] => Array
151
                        (
152
                            [url] => http://imgproc.airliners.net/photos/airliners/0/2/5/0155520-v40-6.jpg
153
                            [local] => images/A/AAG/004.jpg
154
                        )
155
 
156
                )
157
 
158
        )
159
 
160
    [last_updated] => 8th April 4:15am
161
)

We return all fields whether there's a value associated with it or not. Note that we'll also return a portion of images sourced from Airliners.net, and Australian Transport Safety Bureau (ATSB) reports that include a reference to the registration (regardless of whether the rego is currently assigned to the queried aircraft). Depending upon your access, additional information will be returned, including thumbnail images sourced from a larger number of websites. We'll be building upon the returned data for specific aircraft over time to provide a more complete resource.

Browsing

Paginated results may be returned via casa.json?apikey=xxxxx&type=browse (the browse type can be omitted since it's assumed). We'll return the results in the following manner:

1
Array
2
(
3
    [code] => 200
4
    [status] => 200
5
    [message] => OK
6
    [source] => BeliefMedia | CASA
7
    [api_version] => 0.2
8
    [page] => 1
9
    [number] => 30
10
    [pages] => 517
11
    [total] => 15509
12
    [search] => Array
13
        (
14
            [type] => browse
15
        )
16
 
17
    [results] => Array
18
        (
19
            [0] => Array
20
                (
21
                    [rego] => AAA
22
                    [manufacturer] => Array
23
                        (
24
                            [manufacturer] => DE HAVILLAND AIRCRAFT COMPANY
25
                            [model] => DH-83
26
                            [mtow] => 907
27
                            [serial] => DHA6
28
                            [year_manufacture] => 1938
29
                        )
30
 
31
                    [engine] => Array
32
                        (
33
                            [engine_manufacturer] => DE HAVILLAND ENGINE COMPANY LTD
34
                            [engine_model] => GIPSY MAJOR(DE HAVL)
35
                        )
36
 
37
                    [operator_name] => BUNN, Robert Archibald
38
                )
39
 
40
            [1] => Array
41
                (
42
                    [rego] => AAB
43
                    [manufacturer] => Array
44
                        (
45
                            [manufacturer] => BRITISH AIRCRAFT CORPORATION
46
                            [model] => SWALLOW 2
47
                            [mtow] => 680
48
                            [serial] => 461
49
                            [year_manufacture] => 1936
50
                        )
51
 
52
                    [engine] => Array
53
                        (
54
                            [engine_manufacturer] => BLACKBURN ENGINES
55
                            [engine_model] => CIRRUS MINOR I
56
                        )
57
 
58
                    [operator_name] => SINCLAIR, John Leslie
59
                )
60
 
61
            [.. SNIP ..]
62
 
63
            [29] => Array
64
                (
65
                    [rego] => ABE
66
                    [manufacturer] => Array
67
                        (
68
                            [manufacturer] => AUSTER AIRCRAFT LTD
69
                            [model] => J1B
70
                            [mtow] => 907
71
                            [serial] => 2693
72
                            [year_manufacture] => 1951
73
                        )
74
 
75
                    [engine] => Array
76
                        (
77
                            [engine_manufacturer] => GENERAL MOTORS HOLDEN LTD
78
                            [engine_model] => GIPSY MAJOR
79
                        )
80
 
81
                    [operator_name] => DUNNE, Gary Peter
82
                )
83
 
84
        )
85
 
86
    [last_updated] => 8th April 4:15am
87
)

We order results by registration (descending) by default. Alter with order=asc or order=desc. Pagination query parameters are pg and number.

Searching

The fields you may search upon are as follows: first_registered, model, engine_model, rego_holder_name, rego_suburb, rego_state, rego_postcode, rego_commencement_date, operator_name, operator_suburb, operator_commencement_date, propeller_manufacturer, propeller_model, country_manufacture, year_manufacture, and icao_type_designator. All date fields require a 8-figure date stamp (YYYYMMDD) or a human-readable time in the following exact format: 10-april-2018. All search parameters require an exact match except for rego_holder_name and operator_name.

To search by model, we'll query casa.json?apikey=xxxxx&type=search&model=S-2B. The result:

1
Array
2
(
3
    [code] => 200
4
    [status] => 200
5
    [message] => OK
6
    [source] => BeliefMedia | CASA
7
    [api_version] => 0.2
8
    [page] => 1
9
    [number] => 30
10
    [pages] => 1
11
    [total] => 7
12
    [search] => Array
13
        (
14
            [type] => search
15
            [params] => Array
16
                (
17
                    [model] => S-2B
18
                )
19
 
20
        )
21
 
22
    [results] => Array
23
        (
24
            [0] => Array
25
                (
26
                    [rego] => LOE
27
                    [manufacturer] => Array
28
                        (
29
                            [manufacturer] => PITTS AVIATION ENTERPRISES
30
                            [model] => S-2B
31
                            [mtow] => 771
32
                            [serial] => 5157
33
                            [year_manufacture] => 1989
34
                        )
35
 
36
                    [engine] => Array
37
                        (
38
                            [engine_manufacturer] => TEXTRON LYCOMING
39
                            [engine_model] => AEIO-540
40
                        )
41
 
42
                    [operator_name] => AIR CONNECT AUSTRALIA PTY LTD
43
                )
44
 
45
            [1] => Array
46
                (
47
                    [rego] => LVE
48
                    [manufacturer] => Array
49
                        (
50
                            [manufacturer] => PITTS AVIATION ENTERPRISES
51
                            [model] => S-2B
52
                            [mtow] => 741
53
                            [serial] => 5038
54
                            [year_manufacture] => 1984
55
                        )
56
 
57
                    [engine] => Array
58
                        (
59
                            [engine_manufacturer] => TEXTRON LYCOMING
60
                            [engine_model] => AEIO-540
61
                        )
62
 
63
                    [operator_name] => CARSWELL, Andrew John
64
                )
65
 
66
           [.. SNIP ..]
67
 
68
            [6] => Array
69
                (
70
                    [rego] => ZZZ
71
                    [manufacturer] => Array
72
                        (
73
                            [manufacturer] => PITTS AVIATION ENTERPRISES
74
                            [model] => S-2B
75
                            [mtow] => 771
76
                            [serial] => 5005
77
                            [year_manufacture] => 1983
78
                        )
79
 
80
                    [engine] => Array
81
                        (
82
                            [engine_manufacturer] => TEXTRON LYCOMING
83
                            [engine_model] => AEIO-540
84
                        )
85
 
86
                    [operator_name] => GOTTS, Caleb Norton
87
                )
88
 
89
        )
90
 
91
    [last_updated] => 8th April 4:15am
92
)

To further refine by year of manufacture we'll query casa.json?apikey=xxxxx&type=search&model=S-2B&year_manufacture=1984. The result:

1
Array
2
(
3
    [code] => 200
4
    [status] => 200
5
    [message] => OK
6
    [source] => BeliefMedia | CASA
7
    [api_version] => 0.2
8
    [page] => 1
9
    [number] => 30
10
    [pages] => 1
11
    [total] => 2
12
    [search] => Array
13
        (
14
            [type] => search
15
            [params] => Array
16
                (
17
                    [model] => S-2B
18
                    [year_manufacture] => 1984
19
                )
20
 
21
        )
22
 
23
    [results] => Array
24
        (
25
            [0] => Array
26
                (
27
                    [rego] => LVE
28
                    [manufacturer] => Array
29
                        (
30
                            [manufacturer] => PITTS AVIATION ENTERPRISES
31
                            [model] => S-2B
32
                            [mtow] => 741
33
                            [serial] => 5038
34
                            [year_manufacture] => 1984
35
                        )
36
 
37
                    [engine] => Array
38
                        (
39
                            [engine_manufacturer] => TEXTRON LYCOMING
40
                            [engine_model] => AEIO-540
41
                        )
42
 
43
                    [operator_name] => CARSWELL, Andrew John
44
                )
45
 
46
            [1] => Array
47
                (
48
                    [rego] => YYU
49
                    [manufacturer] => Array
50
                        (
51
                            [manufacturer] => PITTS AVIATION ENTERPRISES
52
                            [model] => S-2B
53
                            [mtow] => 741
54
                            [serial] => 5046
55
                            [year_manufacture] => 1984
56
                        )
57
 
58
                    [engine] => Array
59
                        (
60
                            [engine_manufacturer] => TEXTRON LYCOMING
61
                            [engine_model] => AEIO-540-D4A5
62
                        )
63
 
64
                    [operator_name] => YEOMANS, Allan James
65
                )
66
 
67
        )
68
 
69
    [last_updated] => 8th April 4:15am
70
)

The allowed search fields are listed in the following array:

1
/* Allowed fields */
2
$allowed_fields = array('first_registered', 'model', 'engine_model', 'rego_holder_name', 'rego_suburb', 'rego_state', 'rego_postcode', 'rego_commencement_date', 'operator_name', 'operator_suburb', 'operator_commencement_date', 'propeller_manufacturer', 'propeller_model', 'country_manufacture', 'year_manufacture', 'icao_type_designator');

As with other results, order results by order=asc or order=desc, and pagination is determined by pg and number.

Statistics

Basic stats may be returned via casa.json?apikey=xxxxx&type=stats&field=country_manufacture. You may limit the number of results returned by adding a numeric n parameter to your query string (handy for graphing top results). To return the top ten manufacturers by country we'll query casa.json?apikey=xxxxx&type=stats&field=country_manufacture&n=10 with the following result:

1
Array
2
(
3
    [code] => 200
4
    [status] => 200
5
    [message] => OK
6
    [source] => BeliefMedia | CASA
7
    [api_version] => 0.2
8
    [page] => 1
9
    [number] => 30
10
    [pages] =>
11
    [total] =>
12
    [search] => Array
13
        (
14
            [type] => stats
15
            [field] => country_manufacture
16
        )
17
 
18
    [results] => Array
19
        (
20
            [key_value] => Array
21
                (
22
                    [United_States_of_America] => 9761
23
                    [Australia] => 2065
24
                    [Germany] => 898
25
                    [United_Kingdom] => 616
26
                    [France] => 547
27
                    [Canada] => 307
28
                    [Italy] => 173
29
                    [Poland] => 164
30
                    [Czech_Republic] => 124
31
                    [New_Zealand] => 124
32
                )
33
 
34
            [array] => Array
35
                (
36
                    [0] => Array
37
                        (
38
                            [country_manufacture] => United States of America
39
                            [count] => 9761
40
                        )
41
 
42
                    [1] => Array
43
                        (
44
                            [country_manufacture] => Australia
45
                            [count] => 2065
46
                        )
47
 
48
                    [2] => Array
49
                        (
50
                            [country_manufacture] => Germany
51
                            [count] => 898
52
                        )
53
 
54
                    [3] => Array
55
                        (
56
                            [country_manufacture] => United Kingdom
57
                            [count] => 616
58
                        )
59
 
60
                    [4] => Array
61
                        (
62
                            [country_manufacture] => France
63
                            [count] => 547
64
                        )
65
 
66
                    [5] => Array
67
                        (
68
                            [country_manufacture] => Canada
69
                            [count] => 307
70
                        )
71
 
72
                    [6] => Array
73
                        (
74
                            [country_manufacture] => Italy
75
                            [count] => 173
76
                        )
77
 
78
                    [7] => Array
79
                        (
80
                            [country_manufacture] => Poland
81
                            [count] => 164
82
                        )
83
 
84
                    [8] => Array
85
                        (
86
                            [country_manufacture] => Czech Republic
87
                            [count] => 124
88
                        )
89
 
90
                    [9] => Array
91
                        (
92
                            [country_manufacture] => New Zealand
93
                            [count] => 124
94
                        )
95
 
96
                )
97
 
98
        )
99
 
100
    [last_updated] => 8th April 4:15am
101
)

We return a number of formats designed specifically for popular graphing applications. Without specifying what JSON you'd like returned (format=googlecharts, format=beliefmedia etc.), we return a key_value pair, and another array with two fields. Any value in the $allowed_fields array (above) may be queried.

Considerations

  • We have a WordPress plugin we provide to various clients (flying schools etc). We'll occasionally send out API Keys to our FLIGHT mailing list.
  • This API is very much in development. We'd ideally like to add additional data, live tracking results etc.
  • The ATSB data isn't intended to be accurate, complete, or valid, and there's the likelihood the ATSB results aren't associated with the current airframe. We have an API to return ATSB report data (browsing and searching) although the ATSB is the only official source of such information. Bottom line: ATSB data is returned for information purposes only.
  • Some CASA fields have limited value options. Full details available on the CASA website . The page we've linked to also includes other details associated with each field.
  • You may see examples of the register search engine on FlightPlanning.com or flight.org soon as a means of demonstrating the WP plugin.
  • Edit, 11th April: We've had a few requests for the ATSB endpoint details. Basically, all requests are made to atsb.json with a type of browse or search. An ID (?id=ABC) returns all reports attached to a callsign. The source shouldn't be considered up-to-date, accurate, or complete.

■ ■ ■

 
Download our complimentary 650-page guide on marketing for mortgage brokers. We'll show you exactly how we generate billions in volume for our clients.
Finance Guide, Cropped Top and Bottom
  Timezone: 1 · [ CHANGE ]

RELATED READING

Like this article?

Share on Facebook
Share on Twitter
Share on Linkdin
Share on Pinterest

Leave a comment