Atoka API User Reference

Public Funding Search

This API allows you to search for public funding.

https://api.atoka.io/v2/publicfunding

All requests must be properly authenticated.

Response

By default this API endpoint returns the list of public funding matching the selected criteria.

Using these parameters, you'll be able to customize the output you'll get from your searches.

Parameters
  • token string required

    All requests must be properly authenticated; see the Authentication section for more info

  • fields array,
    default is items

    Get just the list of public funding matched, or the search facets (or both!).

    If you set this to value none, you'll get just the meta object, with count of public funding matching your search criteria.

    Accepts multiple values, separated with , (comma) char: will match on any value (logic OR).

    Possible values are:

    • items
    • none
curl -G "https://api.atoka.io/v2/publicfunding" -d "fields=items"

Response modifications

When fields is items, the response will be:

{
"items": [
{
"id": "string", // Unique ID that you can use throughout the API endpoints to reference to a specific public funding
"name": "string" // The name of the fund
},
...
],
"meta": { // Meta information on search results
"ordering": "string", // Requested sorting algorithm.
"count": int, // Total number of records matching search query.
"limit": int, // As per search parameters, maximum number of records fetched per request.
"offset": int, // As per search parameters, number of records skipped.
"info": [ // A list of information messages, if any.
"string",
...
]
}
}
curl -G "https://api.atoka.io/v2/publicfunding" -d "fields=items"

Data packages

This parameter is left for future, as currently only one package is available for Public Funding. In the future you will be able to fine tune the fields you want to be returned by the API, similarly to what is done in the other Atoka APIs.

If you have special needs and want to further customize the data returned, we can adapt the output to your specific needs: just get in touch with us at sales@atoka.io.

Parameters
  • packages array

    Fine tune the results to the level of detail your application actually requires.

    The extraction cost per single fund will be multiplied to the number of results in your query (up to offset parameter value).

    To avoid using any package, don't pass this parameter and the results will contain just the Atoka Public Funding ID (and little more).

    Accepts multiple values, separated with , (comma) char: will match on any value (logic OR).

    Possible values are:

    • base
    • * (use all the data packages you have an active subscription for)
curl -G "https://api.atoka.io/v2/publicfunding" -d "packages=*"

Response modifications

When packages is *, the response will be:

{
"items": [
{
"id": "string", // Unique ID that you can use throughout the API endpoints to reference to a specific public fund
"name": "string", // The title of the project
},
...
],
"facets": {
},
"queryExplanation": [
{ // Submitted query explanation.
"engine": "string",
"text": "string",
"json": object
},
...
],
"meta": { // Meta information on search results
"ordering": "string", // Requested sorting algorithm.
"count": int, // Total number of records matching search query.
"limit": int, // As per search parameters, maximum number of records fetched per request.
"offset": int, // As per search parameters, number of records skipped.
"info": [ // A list of information messages, if any.
"string",
...
]
}
}
curl -G "https://api.atoka.io/v2/publicfunding" -d "packages=*"

Ordering & Pagination

To download long lists of results you can paginate returned items using these parameters.

You can also decide the order in which items are returned.

Parameters
  • limit integer,
    default is 10

    This is the number of individual objects that are returned in each page.

    Use a number between 0 and 50.

  • offset integer,
    default is 0

    This offsets the start of each page by the number specified.

    Use a number between 0 and 9950.

  • ordering string,
    default is "startDateDesc"

    Selects the order in which results are returned.

    Choose only one among:

    • startDate
    • startDateDesc
    • amount
    • amountDesc
curl -G "https://api.atoka.io/v2/publicfunding" -d "limit=10" -d "offset=30" -d "ordering=amount"

General info

These filters act on the general information of the public funding, such as the fund amount, the starting / ending dates, and so on.

Parameters
  • ids array

    Search via already known Atoka Public Funding ID.

    Accepts multiple values, separated with , (comma) char.

  • beneficiaries array base

    Search via already known Atoka Company Beneficiaries ID.

    Accepts multiple values, separated with , (comma) char.

curl -G "https://api.atoka.io/v2/publicfunding"

Debug

Use these parameters when you need to understand how your request was evaluated by the API.

Parameters
  • explain boolean,
    default is false

    When using this parameter in your request you'll get and additional property in the results explanation, that contains all the filters actually used during the query.

    Mostly useful for debugging purposes.

curl -G "https://api.atoka.io/v2/publicfunding" -d "explain=true"

Response modifications

When explain is true, the response will be:

curl -G "https://api.atoka.io/v2/publicfunding" -d "explain=true"

Public Funding Details

Show full details of a fund.

By default we show all information available using all the data packages you subscribed to. Use the package parameter to fine tune the output format.

If you have special needs and want to further customize the data returned, we can adapt the output to your specific needs: just get in touch with us at sales@atoka.io.

https://api.atoka.io/v2/publicfunding/{id}

Replace {id} with the Atoka Public funding ID you want details for (as returned by the [Public Funding Search](#publicfunding)..

All requests must be properly authenticated.

Data Packages

This parameter is left for future, as currently only one package is available for Public Funding. In the future you will be able to fine tune the fields you want to be returned by the API, similarly to what is done in the other Atoka APIs.

Remember: your subscription gives you access to different levels of detail in data returned!

Parameters
  • packages array,
    default is *

    By using this parameter you can fine tune the results to the level of detail your application actually requires.

    Accepts multiple values, separated with , (comma) char: will match on any value (logic OR).

    Possible values are:

    • base
    • * use all the data packages you have an active subscription for
curl -G "https://api.atoka.io/v2/publicfunding/{id}" -d "packages=*"

Response modifications

When packages is *, the response will be:

{
"item": {
"id": "string", // Unique ID that you can use throughout the API endpoints to reference to a specific public fund
"name": "string", // The title of the project
},
"queryExplanation": [
{ // Submitted query explanation.
"engine": "string",
"text": "string",
"json": object
},
...
]
}
curl -G "https://api.atoka.io/v2/publicfunding/{id}" -d "packages=*"

Debug

Use these parameters when you need to understand how your request was evaluated by the API.

Parameters
  • explain boolean,
    default is false

    When using this parameter in your request you'll get and additional property in the results explanation, that contains all the filters actually used during the query.

    Mostly useful for debugging purposes.

curl -G "https://api.atoka.io/v2/publicfunding/{id}" -d "explain=true"

Response modifications

When explain is true, the response will be:

curl -G "https://api.atoka.io/v2/publicfunding/{id}" -d "explain=true"