Business Check Bulk

POST /api/v2/business_checks operationId: business_checks

Live: https://gdapi.globaldata.net.au/api/v2/business_checks · Sandbox: https://sandbox-gdapi.globaldata.net.au/api/v2/business_checks

Performs bulk business checks using ABN/ACN values.

Limits

requests must contain between 1 and 100 items.

Request body

Content type application/json. Bulk business check request details.

Field Description

requestsrequired array of objects [1..100 items]

Field	Description
`requests`required	array of objects [1..100 items]
`requests[].check_id`	string [max 255 characters] or null Example: `req-1001`
`requests[].number`required	string ABN (11 digits) or ACN (9 digits). Example: `605303875`

requests[].check_id

string [max 255 characters] or null

Example: req-1001

requests[].numberrequired

string

ABN (11 digits) or ACN (9 digits).

Example: 605303875

Responses

200

Bulk business check result.

application/json

Field Description

message

string

Example: Ok

api_reference

string (uuid)

Example: fe4291ca-d831-4760-96df-c9cb03b3cd95

results array of objects

results[].check_id

string or null

Example: req-1001

results[].error

string or null

Example: The number is not a valid ACN.

results[].match

one of 2 shapes

The matched business. An empty array [] when the number is not known to the ABR or ASIC.

Business Check match

Field	Description
`name`	string or null Example: `SEMVIA FINANCE PTY LTD`
`type`	string or null Example: `Australian Private Company`
`abn`	string or null Example: `91605303875`
`abn_status`	string or null Example: `active`
`abn_gst_registered`	boolean Example: `true`
`acn`	string or null Example: `605303875`
`acn_status`	string or null Example: `registered`
`address_locality`	string or null Example: `MELBOURNE`
`address_state`	string or null Example: `VIC`
`address_postcode`	string or null Example: `3000`
`asic_reg_date`	string or null Example: `2015-04-15`
`asic_review_date`	string or null Example: `2026-04-15`
`asic_deregistered_date`	string or null
`asic_recent_documents`	array of objects
`asic_recent_documents[].form_code`	string Example: `484`
`asic_recent_documents[].description`	string Example: `CHANGE TO COMPANY DETAILS`
`asic_recent_documents[].date`	string Example: `2021-07-07`
`asic_recent_documents[].document_number`	string Example: `7EBJ24000`
`asic_recent_documents[].sub_documents`	array of objects
`asic_recent_documents[].sub_documents[].form_code`	string Example: `484N`
`asic_recent_documents[].sub_documents[].description`	string Example: `CHANGES TO (MEMBERS) SHARE HOLDINGS`
`business_names`	array of objects
`business_names[].name`	string Example: `Payexpress`
`business_names[].from`	string or null Example: `2015-07-16`
`business_names[].to`	string or null
`business_names[].type`	string Example: `business_name`
`name_details`	array of objects
`name_details[].type`	string Example: `organisation`
`name_details[].entity_name`	string Example: `SEMVIA FINANCE PTY LTD`
`name_details[].from`	string or null Example: `2015-04-24`
`name_details[].to`	string or null

Empty array

Returned when the number is not known to the ABR or ASIC. (array [max 0 items])

Standard error responses: 400 401 402 403 429 5XX See common error responses

Previous Business Check Next Create a Business Intelligence Request

Request body application/json

{
    "requests": [
        {
            "check_id": "req-1001",
            "number": "605303875"
        }
    ]
}

Response

200 Bulk business check result.

{
    "message": "Ok",
    "api_reference": "fe4291ca-d831-4760-96df-c9cb03b3cd95",
    "results": [
        {
            "check_id": "req-1001",
            "error": "The number is not a valid ACN.",
            "match": {
                "name": "SEMVIA FINANCE PTY LTD",
                "type": "Australian Private Company",
                "abn": "91605303875",
                "abn_status": "active",
                "abn_gst_registered": true,
                "acn": "605303875",
                "acn_status": "registered",
                "address_locality": "MELBOURNE",
                "address_state": "VIC",
                "address_postcode": "3000",
                "asic_reg_date": "2015-04-15",
                "asic_review_date": "2026-04-15",
                "asic_deregistered_date": null,
                "asic_recent_documents": [
                    {
                        "form_code": "484",
                        "description": "CHANGE TO COMPANY DETAILS",
                        "date": "2021-07-07",
                        "document_number": "7EBJ24000",
                        "sub_documents": []
                    }
                ],
                "business_names": [
                    {
                        "name": "Payexpress",
                        "from": "2015-07-16",
                        "to": null,
                        "type": "business_name"
                    }
                ],
                "name_details": [
                    {
                        "type": "organisation",
                        "entity_name": "SEMVIA FINANCE PTY LTD",
                        "from": "2015-04-24",
                        "to": null
                    }
                ]
            }
        }
    ]
}

400 Bad or missing input parameter shared error response

{
    "message": "string"
}

401 Unauthorized - The request is not authorized. shared error response

{
    "message": "API Key Inactive"
}

402 Insufficient Credit - Insufficient credit to process this request shared error response

{
    "message": "Insufficient Credit"
}

403 No access - No permission to process this request shared error response

{
    "message": "No access"
}

429 Rate limited - The request rate limit has been reached shared error response

{
    "message": "Rate limited"
}

5XX Internal error - Internal system error shared error response

{
    "message": "Internal error"
}