Accessing federal corporation JSON datasets

The following information explains how to access federal corporation JSON format datasets through an API GET response.

GET corporations

Returns detailed information about a corporation.

English response

When specifying an English response (see parameters below) the JSON call returns a result as an array where the first object is the English response, the second is null.

French response

When specifying a French response (see parameters below) the JSON call returns a result as an array where the first object is null, the second is the French response.

Resource URL

Corporation resource can be identified by either an existing corporation id or an existing 9- digit business number, e.g.:

https://www.ic.gc.ca/app/scr/cc/CorporationsCanada/api/corporations/corporation_id.json?lang=lang_id

or

https://www.ic.gc.ca/app/scr/cc/CorporationsCanada/api/corporations/corporation_bn9.json?lang=lang_id

Parameters

User can choose the language in which the resource will be returned, by passing a query string — "lang":

Parameters
Parameter Description Value
lang_id The language the results will be returned in eng (English)
fra (French)

Return values

Parameters
URL & Parameter Return
Valid numeric format — Corporation exists — English
https://www.ic.gc.ca/app/scr/cc/CorporationsCanada/api/corporations/1007.json?lang=eng
 [
{
"corporationId": "1007",
"act": "Boards of Trade Act — Part II",
"status": "Active",
"corporationNames": [
{
"CorporationName": {
"name": "Abbotsford Chamber of Commerce",
"nameType": "Primary",
"current": true,
"effectiveDate": "1995-02-06"
}
},
{
"CorporationName": {
"name": "ABBOTSFORD AND DISTRICT CHAMBER OF COMMERCE",
"nameType": "Primary",
"current": false,
"effectiveDate": "1947-01-10",
"expiryDate": "1981-11-10"
}
},
{
"CorporationName": {
"name": "ABBOTSFORD-CLEARBROOK CHAMBER OF COMMERCE",
"nameType": "Primary",
"current": false,
"effectiveDate": "1981-11-10",
"expiryDate": "1991-12-27"
}
},
{
"CorporationName": {
"name": "ABBOTSFORD-MATSQUI CHAMBER OF COMMERCE",
"nameType": "Primary",
"current": false,
"effectiveDate": "1991-12-27",
"expiryDate": "1995-02-06"
}
}
],
"annualReturns": [
{
"annualReturn": {
"annualMeetingdate": "2016-03-09",
"yearOfFiling": "2016"
}
},
{
"annualReturn": {
"annualMeetingdate": "2015-03-20",
"yearOfFiling": "2015"
}
}
],
"activities": [
{
"activity": {
"activity": "Incorporation",
"date": "1947-01-10"
}
},
{
"activity": {
"activity": "Ordinary By-Laws Filing",
"date": "2005-12-20"
}
}
]
},
null
]
Valid numeric format — Corporation exists — French
https://www.ic.gc.ca/app/scr/cc/CorporationsCanada/api/corporations/1007.json?lang=fra
 [
null,
{
"corporationId": "1007",
"act": "Loi sur les chambres de commerce — partie II",
"status": "Active",
"corporationNames": [
{
"CorporationName": {
"name": "Abbotsford Chamber of Commerce",
"nameType": "principal",
"current": true,
"effectiveDate": "1995-02-06"
}
},
{
"CorporationName": {
"name": "ABBOTSFORD AND DISTRICT CHAMBER OF COMMERCE",
"nameType": "principal",
"current": false,
"effectiveDate": "1947-01-10",
"expiryDate": "1981-11-10"
}
},
{
"CorporationName": {
"name": "ABBOTSFORD-CLEARBROOK CHAMBER OF COMMERCE",
"nameType": "principal",
"current": false,
"effectiveDate": "1981-11-10",
"expiryDate": "1991-12-27"
}
},
{
"CorporationName": {
"name": "ABBOTSFORD-MATSQUI CHAMBER OF COMMERCE",
"nameType": "principal",
"current": false,
"effectiveDate": "1991-12-27",
"expiryDate": "1995-02-06"
}
}
],
"adresses": [
{
"address": {
"addressLine": [
"207 — 32900 SOUTH FRASER WAY"
],
"city": "ABBOTSFORD",
"postalCode": "V2S 5A1",
"provinceCode": "BC",
"countryCode": "CA"
}
}
],
"directorLimits": {
"minimum": 3,
"maximum": 30
},
"annualReturns": [
{
"annualReturn": {
"annualMeetingdate": "2016-03-09",
"yearOfFiling": "2016"
}
},
{
"annualReturn": {
"annualMeetingdate": "2015-03-20",
"yearOfFiling": "2015"
}
},
{
"annualReturn": {
"annualMeetingdate": "2014-03-19",
"yearOfFiling": "2014"
}
}
],
"activities": [
{
"activity": {
"activity": "Constitution en société",
"date": "1947-01-10"
}
},
{
"activity": {
"activity": "Dépôt de règlement ordinaire ",
"date": "2005-12-20"
}
}
]
}
]
Search by existing corporation's BN9 number in English:
http://localhost:8080/app/scr/cc/CorporationsCanada/api/corporations/106679285.json?lang=eng

[{"corporationId":"1007","act":"Boards of Trade Act — Part II","status":"Active","corporationNames":[{"CorporationName":{"name":"Abbotsford Chamber of Commerce","nameType":"Primary","current":true,"effectiveDate":"1995-02-06"}},{"CorporationName":{"name":"ABBOTSFORD AND DISTRICT CHAMBER OF COMMERCE","nameType":"Primary","current":false,"effectiveDate":"1947-01-10","expiryDate":"1981-11-10"}},{"CorporationName":{"name":"ABBOTSFORD-CLEARBROOK CHAMBER OF COMMERCE","nameType":"Primary","current":false,"effectiveDate":"1981-11-10","expiryDate":"1991-12-27"}},{"CorporationName":{"name":"ABBOTSFORD-MATSQUI CHAMBER OF COMMERCE","nameType":"Primary","current":false,"effectiveDate":"1991-12-27","expiryDate":"1995-02-06"}}],"adresses":[{"address":{"addressLine":["207 — 32900 SOUTH FRASER WAY"],"city":"ABBOTSFORD","postalCode":"V2S 5A1","provinceCode":"BC","countryCode":"CA"}}],"directorLimits":{"minimum":3,"maximum":30},"businessNumbers":{"businessNumber":"106679285"},"annualReturns":[{"annualReturn":{"annualMeetingdate":"2018-03-15","yearOfFiling":"2018"}},{"annualReturn":{"annualMeetingdate":"2017-03-29","yearOfFiling":"2017"}},{"annualReturn":{"annualMeetingdate":"2016-03-09","yearOfFiling":"2016"}}],"activities":[{"activity":{"activity":"Incorporation","date":"1947-01-10"}},{"activity":{"activity":"Ordinary By-Laws Filing","date":"2005-12-20"}},{"activity":{"activity":"Ordinary By-Laws Filing","date":"2007-03-20"}},{"activity":{"activity":"Ordinary By-Laws Filing","date":"2010-04-28"}},{"activity":{"activity":"Ordinary By-Laws Filing","date":"2011-02-04"}},{"activity":{"activity":"Ordinary By-Laws Filing","date":"2012-04-17"}}]},null]
Search by existing corporation's BN9 number in French:
http://localhost:8080/app/scr/cc/CorporationsCanada/api/corporations/106679285.json?lang=fra

[null,{"corporationId":"1007","act":"Loi sur les chambres de commerce — partie II","status":"Actif","corporationNames":[{"CorporationName":{"name":"Abbotsford Chamber of Commerce","nameType":"principal","current":true,"effectiveDate":"1995-02-06"}},{"CorporationName":{"name":"ABBOTSFORD AND DISTRICT CHAMBER OF COMMERCE","nameType":"principal","current":false,"effectiveDate":"1947-01-10","expiryDate":"1981-11-10"}},{"CorporationName":{"name":"ABBOTSFORD-CLEARBROOK CHAMBER OF COMMERCE","nameType":"principal","current":false,"effectiveDate":"1981-11-10","expiryDate":"1991-12-27"}},{"CorporationName":{"name":"ABBOTSFORD-MATSQUI CHAMBER OF COMMERCE","nameType":"principal","current":false,"effectiveDate":"1991-12-27","expiryDate":"1995-02-06"}}],"adresses":[{"address":{"addressLine":["207 — 32900 SOUTH FRASER WAY"],"city":"ABBOTSFORD","postalCode":"V2S 5A1","provinceCode":"BC","countryCode":"CA"}}],"directorLimits":{"minimum":3,"maximum":30},"businessNumbers":{"businessNumber":"106679285"},"annualReturns":[{"annualReturn":{"annualMeetingdate":"2018-03-15","yearOfFiling":"2018"}},{"annualReturn":{"annualMeetingdate":"2017-03-29","yearOfFiling":"2017"}},{"annualReturn":{"annualMeetingdate":"2016-03-09","yearOfFiling":"2016"}}],"activities":[{"activity":{"activity":"Constitution en société","date":"1947-01-10"}},{"activity":{"activity":"Dépôt de règlement ordinaire ","date":"2005-12-20"}},{"activity":{"activity":"Dépôt de règlement ordinaire ","date":"2007-03-20"}},{"activity":{"activity":"Dépôt de règlement ordinaire ","date":"2010-04-28"}},{"activity":{"activity":"Dépôt de règlement ordinaire ","date":"2011-02-04"}},{"activity":{"activity":"Dépôt de règlement ordinaire ","date":"2012-04-17"}}]}]
Valid numeric format — Corporation does not exist
https://www.ic.gc.ca/app/scr/cc/CorporationsCanada/api/corporations/1234.json?lang=eng
 ["could not find corporation 1234","Corporation 1234 est inconnu."]
An invalid corporation Id (for example "srtrts")
https://www.ic.gc.ca/app/scr/cc/CorporationsCanada/api/corporations/srtrts.json?lang=eng
 ["could not find corporation srtrts","Corporation srtrts est inconnu."]

API Store

This API is also available via the API Store

 Report a problem
Date modified: