Background

The ARC Grants Search provides details of all ARC-funded research projects since 2001, when the National Competitive Grants Program commenced.

Search Items

Search Field

To undertake a search, enter your search term in the search field. Details of the searching protocols available are provided in the Searching Protocols section below.

Search Filters

Your free text search can be further filtered using the fields below.

Sort Functionality

You can also choose a parameter by which the projects search results will be sorted. The parameters are:

• Most relevant
• Current funding amount – lowest to highest
• Current funding amount – highest to lowest
• Announcement date – old to new
• Announcement date – old to new

Most relevant: Individual projects are sorted by the strength of their relevance to search terms identified in the main search field.

Current funding amount: Individual projects are sorted by the 'current funding amount'. Where projects are identified as 'closed' or 'rejected' and have null current funding, they will be listed at the bottom of the list of projects returned. Where projects are identified as 'not yet accepted' they will be included in the search on the basis of 'announced funding' .

Announcement date: Individual projects are sorted by the date they were announced (where that data are available). For those selection rounds where announcement dates are not available (generally prior to 2010), projects are sorted by funding commencement year.

Searching Protocols

You can enter multiple search terms in the search field, for example, you could enter the name of a researcher, a field of research, a university name (shortened versions are acceptable) and/or the name of any participating organisation.

Please note, the search will return results that contain all of the words you have entered (that is similar to using the 'AND' connector). The search will attempt fuzzy matching of the search terms, for example, singular, plural, uppercase, lowercase, related words (stemming). All searches ignore upper/lowercase.

In this release of Grants Search, you can refine your free-text search further using the instructions below.

Quantum Computing

+Nuclear or "Nuclear"

"Quantum Computing"

"Quantum Computing" +USA

Physics -Nuclear

Australia -"New Zealand"

Nuclear OR Physics

<health significant challenge>

Cryst*

(health child OR (military -profile) 
 OR <mother daughter>)

climate a the then

For advanced searches, the free-text query can be combined with expression filters. The expression filter begins with the '=>' key. Expression filters can be combined with operators 'AND' and 'OR'. Parentheses '(...)' can also be used to enclose sub queries to form a more complex query.

Syntax: <search text> => <filter queries>

The following are the supported expression filters with examples:

scheme

=> scheme="Discovery Projects"

Australia => scheme="Discovery Projects"

year-from

=> year-from="2015"

year-to

=> year-to="2019"

funding-from

=> funding-from="300000"

funding-to

=> funding-from="1000000"

admin-org-name

=> admin-org-name="The University of New South Wales"

admin-org-short-name

=> admin-org-short-name="UNSW"

state-name

=> state-name="New South Wales"

state-short-name

=> state-short-name="NSW"

four-digit-for

=> four-digit-for="0101"

two-digit-for

=> two-digit-for="01"

status

=> status="Active"

fellowships-only

=> fellowships-only="true"

lief-register

=> lief-register="true"

Searching Results

Individual project details

Search results returned for individual projects will look like the following:

In instances where a final report has been approved for an individual project, the information returned will include an 'Outcome Statement'.

The details provided for individual research projects include the following information:

Data Downloads

CSV

Following a search, the results that are displayed on the screen can be extracted into a comma separated values (CSV) file. These files can then be opened and manipulated using products such as Microsoft Excel.

JSON

Following a search, the results that are displayed on the screen can also be extracted in JavaScript Object Notation (JSON) format. JSON is a way of storing and transporting data, usually from one system to another.

The JSON data can also be extracted through the API. Further help regarding the API is provided in the following section.

Status of the data in CSV and JSON

Note that the status of the information in the CSV and JSON files is as per the table below, where ‘current’ indicates that the information provided includes post-award variations.

Calling The API

Returning a list of Grants

The DataPortal API for the Grants Search follows the JSON API Specification (v1.0). The API supports Pagination, Filters and error handling as per the specification. Sparse Fieldsets and Sorting are not supported at this stage.

The Grants Search API data is provided in a paginated format. Clients can access this API by specifying a page size of up to a maximum of 1000 records. The following is an example of the URL format that will return the first page in a set of paginated results containing the first twenty (20) grants.

https://dataportal.arc.gov.au/NCGP/API/grants?page%5Bnumber%5D=1&page%5Bsize%5D=20

The following is an example of the URL format where searches and filters are included:

https://dataportal.arc.gov.au/NCGP/API/grants?page[size]=20&page[number]=1&filter=[SEARCH TEXT]=>(scheme="[SCHEME]") AND(admin-org-short-name="[ADMIN ORG SHORT NAME]" OR admin-org-name="[ADMIN ORG NAME]") AND(status="[STATUS]")

Where

• SEARCH TEXT - free text word or phrase to search on. Optional filters can be added to SEARCH TEXT using the separator '=>'
• SCHEME - results are filtered by scheme
• ADMIN ORG SHORT NAME - results are filtered by Administering Organisation short name
• ADMIN ORG NAME - results are filtered by Administering Organisation name
• STATUS - results are filtered by status

The API URL components must be encoded before calling the API. The following is an example of an encoded URL.

https://dataportal.arc.gov.au/NCGP/API/grants?page%5Bnumber%5D=1&page%5Bsize%5D=20&filter=Astronomy%20%3D%3E%20(scheme%3D"Discovery%20Projects")%20AND(admin-org-short-name%3D"ANU")%20AND(status%3D"Active")

The following is a snippet of a paginated JSON API call that returns the first page of all grants with one grant per page.

{
meta: {
    requested-page-number: 1,
    requested-page-size: 1,
    actual-page-size: 1,
    total-pages: 26588,
    total-size: 26588,
    search-description: null
},
links: {
    self: "https://dataportal.arc.gov.au/NCGP/API/grants?page%5Bnumber%5D=1&page%5Bsize%5D=1",
    first: "https://dataportal.arc.gov.au/NCGP/API/grants?page%5Bnumber%5D=1&page%5Bsize%5D=1",
    last: "https://dataportal.arc.gov.au/NCGP/API/grants?page%5Bnumber%5D=26588&page%5Bsize%5D=1",
    prev: "https://dataportal.arc.gov.au/NCGP/API/grants?page%5Bnumber%5D=1&page%5Bsize%5D=1",
    next: "https://dataportal.arc.gov.au/NCGP/API/grants?page%5Bnumber%5D=2&page%5Bsize%5D=1"
},
data: [
    {
        type: "grants",
        id: "50699",
        attributes: {
            code: "LP180100122",
            scheme-name: "Linkage Projects",
            funding-commencement-year: 2018,
            scheme-information: {
                schemeCode: "LP",
                program: "Linkage",
                submissionYear: 2018,
                roundNumber: 1,
                schemeRound: "LP18 Round 1"
            },
            current-admin-organisation: "Swinburne University of Technology",
            grant-summary: "Coordinating Innovation in Knowledge-Based Multinational Organisations...",
            lead-investigator: "Prof Dean Lusher",
            current-funding-amount: 411343,
            announced-funding-amount: 411343,
            grant-status: "Not yet accepted",
            primary-field-of-research: "1608 - Sociology",
            anticipated-end-date: "",
            investigators: "",
            lief-register: [ ]
        },
        links: {
            self: "https://dataportal.arc.gov.au/NCGP/API/grants/50699"
        }
    }
]
}

In the snippet above, the meta attribute has the information related to page size, page number, total results and search description. The search description is in Abstract Syntax Tree (AST) format. The links attribute has navigation links to other pages and the data attribute has the collection of research outputs data.

Clients can fetch a maximum of 1000 results per page and then keep navigating the results of subsequent pages by following the navigation links. They can also get the desired results using filters and search text as described in the Search Items section. The API also supports Free-Text search operations like AND, OR, NOT. Words like ‘as’, ‘the’, ‘if’, ‘of’, etc may be ignored for a more predictable result, however phrases within a double quote will return exact matches.

Returning the details of a single Grant

After calling the API for a list of grants, each result will contain a links section within the data object of the payload. The URL contained in this section is specific to an individual grant, which can be called to access a more detailed API for that grant.

Troubleshooting

No relevant data in the response

{
"meta":{...}
"links": {...}
"data": []
}

For a specified search, there is no data.

A 'Failed/Unexpected/Unauthorized' response

{
"links": {
    "self": "https://dataportal.arc.gov.au/NCGP/API/grants?page%5Bsize%5D=0&page%5Bnumber%5D=1&filter=titlenotfound"
},
"errors": [
    {
    "id": "500InternalServerError",
    "status": "InternalServerError",
    "code": "500",
    "title": "SqlException",
    "detail": "The number of rows provided for a FETCH clause must be greater then zero."
    }
]
}
                

{
"links": {
    "self": "https://dataportal.arc.gov.au/NCGP/API/grants"
},
"errors": [
    {
        "id": "401Unauthorized",
        "status": "Unauthorized",
        "code": "401",
        "title": "UnauthorizedAccessException",
        "detail": "..."
    }
]
}
                

A failed/unexpected/unauthorized response will occur when :

• The URL has invalid attribute values
• The client has issued a bad request
• The client is trying to access unauthorized URL or data.
• The client is blocked by ARC