Skip to main content
API docs by Redocly

Go Vocal OpenAPI Specification (2)

Download OpenAPI specification:Download

API Support: support@govocal.com URL: http://www.open-api.io/support License: Apache 2.0 Terms of Service

Go Vocal's public REST API is available for customers that want to programatically access data of the platform. This can be used to integrate the data in other tools, or to display Go Vocal content on another website..

Areas

Areas are geogprahical regions that can be used to categorize projects, and annotate users.

List areas

Retrieve a paginated list of all the areas in the platform, with the most recently created ones first.

Authorizations:
Authorization
query Parameters
locale
string

Which locale to return text for any multi-locale fields. For example: "en" or "fr-BE". If not provided, it will be set to the default language of the platform.

page_size
integer

The number of items that should be returned in one response. Defaults to 12, max 24

page_number
integer

The page to return. Defaults to page 1

created_at
string

Date the item was created - in format "YYYY-DD-MM" - to filter between two dates separate with comma

updated_at
string

Date item was last updated - in format "YYYY-DD-MM" - to filter between two dates separate with comma

Responses

Response samples

Content type
application/json
{
  • "areas": [
    ],
  • "meta": {
    }
}

Get area

Retrieve a single area by its ID.

Authorizations:
Authorization
path Parameters
id
required
integer

Unique uuid for the item

id
required
string
query Parameters
locale
string

Which locale to return text for any multi-locale fields. For example: "en" or "fr-BE". If not provided, it will be set to the default language of the platform.

Responses

Response samples

Content type
application/json
{
  • "area": {
    }
}

/api/v2/areas/deleted

Authorizations:
Authorization
query Parameters
deleted_at
string

Date item was deleted - in format "YYYY-DD-MM" - to filter between two dates separate with comma

Responses

Response samples

Content type
application/json
{
  • "deleted_items": [
    ],
  • "meta": {
    }
}

Authentication

To obtain your client_id and client_secret please visit 'Admin > Tools > Public API Access' within your Go Vocal platform. If this feature is not enabled on your platform then please contact support@govocal.com. Authenticate with your client_id and client_secret to retrieve a JWT token. You need to send the JWT token you got back along with every request to the API, as part of the Authorization header. The JWT token expires after 24h, so make sure to re-authenticate.

Retrieve a JWT token for authentication.

Endpoint to authenticate using client_id and client_secret to retrieve a JWT token.

Request Body schema: application/json
object
client_id
required
string

The client ID you obtained to access this API

client_secret
string

The client secret you obtained to access this API

Responses

Request samples

Content type
application/json
{
  • "auth": {
    }
}

Response samples

Content type
application/json
{
  • "jwt": "eyJhbGciOiJSUzI1NiJ9.eyJleHAiOjE3MzQ3ODIxMTYsInN1YiI6IjRhN2U2NWE0LWQ5NjQtNGI1Mi1iNzcyLTc2OTU1MjAwNmM2OSJ9.NAwXPCri13zbWrtkMvxvd_FbeRschDCBsFIxsJ0k-vzm7vEXv-etmDcVTs6mi9Ix7fvGlRJctu7HKsey0HLQ-HQ9G5VYL3BYrNGSe5u-0ooSfF_WL96RMx9SLipMDCmU5XDij9QfSUDmsLj0YA0zu-BzyVuZMJs70bYh9nySPHvQZfu4f1W9D4SiO6bWkiOQOL3Sr43sFPC1b2eMv_VOebBXhOhdS993hfRcxy8M_Tuvi2CozIRJzEnLeyTslVHlQfjpVjnc4Ai5OdA3X0chkRJz2SdbWW4QMWanFNGXWd1olVm7y_t7w-Kmpnvxb3gQhIKYr6i3wvTKq-HeJczpXw"
}

Voting

When a user votes for an idea, a basket is created per user for the project or phase. An association is then created between the basket and the idea voted for and stored with the number of votes. Votes are not counted unless the basket has been submitted.

List associations between baskets and ideas

Basket idea associations define which ideas a user has voted for. The votes field defines how many votes a user has given to the idea or in the case of budgeting projects/phases, how much budget they have allocated.

Authorizations:
Authorization
query Parameters
idea_id
string

Filter by idea ID

basket_id
string

Filter by basket ID

locale
string

Which locale to return text for any multi-locale fields. For example: "en" or "fr-BE". If not provided, it will be set to the default language of the platform.

page_size
integer

The number of items that should be returned in one response. Defaults to 12, max 24

page_number
integer

The page to return. Defaults to page 1

created_at
string

Date the item was created - in format "YYYY-DD-MM" - to filter between two dates separate with comma

updated_at
string

Date item was last updated - in format "YYYY-DD-MM" - to filter between two dates separate with comma

Responses

Response samples

Content type
application/json
{
  • "basket_ideas": [
    ],
  • "meta": {
    }
}

/api/v2/basket_ideas/deleted

Authorizations:
Authorization
query Parameters
idea_id
string

Filter by idea ID

basket_id
string

Filter by basket ID

deleted_at
string

Date item was deleted - in format "YYYY-DD-MM" - to filter between two dates separate with comma

Responses

Response samples

Content type
application/json
{
  • "deleted_items": [
    ],
  • "meta": {
    }
}

List all baskets

A user will get a single basket per voting phase or project. Votes (stored in basket ideas) remain uncounted until the basket is submitted and there is a submitted_at date within the basket

Authorizations:
Authorization
query Parameters
locale
string

Which locale to return text for any multi-locale fields. For example: "en" or "fr-BE". If not provided, it will be set to the default language of the platform.

page_size
integer

The number of items that should be returned in one response. Defaults to 12, max 24

page_number
integer

The page to return. Defaults to page 1

created_at
string

Date the item was created - in format "YYYY-DD-MM" - to filter between two dates separate with comma

updated_at
string

Date item was last updated - in format "YYYY-DD-MM" - to filter between two dates separate with comma

Responses

Response samples

Content type
application/json
{
  • "baskets": [
    ],
  • "meta": {
    }
}

Get a single basket

Retrieve a single basket by its ID.

Authorizations:
Authorization
path Parameters
id
required
integer

Unique uuid for the item

id
required
string
query Parameters
locale
string

Which locale to return text for any multi-locale fields. For example: "en" or "fr-BE". If not provided, it will be set to the default language of the platform.

Responses

Response samples

Content type
application/json
{
  • "basket": {
    }
}

/api/v2/baskets/deleted

Authorizations:
Authorization
query Parameters
deleted_at
string

Date item was deleted - in format "YYYY-DD-MM" - to filter between two dates separate with comma

Responses

Response samples

Content type
application/json
{
  • "deleted_items": [
    ],
  • "meta": {
    }
}

Comments

All comments created on the platform

List all comments

Retrieve a paginated list of all the comments in the platform. You can filter the comments in different ways. For example, you can filter by "post type", or by date range.

Authorizations:
Authorization
query Parameters
locale
string

Which locale to return text for any multi-locale fields. For example: "en" or "fr-BE". If not provided, it will be set to the default language of the platform.

page_size
integer

The number of items that should be returned in one response. Defaults to 12, max 24

page_number
integer

The page to return. Defaults to page 1

created_at
string

Date the item was created - in format "YYYY-DD-MM" - to filter between two dates separate with comma

updated_at
string

Date item was last updated - in format "YYYY-DD-MM" - to filter between two dates separate with comma

post_type
string
Enum: "idea" "initiative"

List only the comments that were posted on a specific type of resource.

Responses

Response samples

Content type
application/json
{
  • "comments": [
    ],
  • "meta": {
    }
}

Get comment

Retrieve a single comment by its ID.

Authorizations:
Authorization
path Parameters
id
required
integer

Unique uuid for the item

id
required
string
query Parameters
locale
string

Which locale to return text for any multi-locale fields. For example: "en" or "fr-BE". If not provided, it will be set to the default language of the platform.

Responses

Response samples

Content type
application/json
{
  • "comment": {
    }
}

/api/v2/comments/deleted

Authorizations:
Authorization
query Parameters
deleted_at
string

Date item was deleted - in format "YYYY-DD-MM" - to filter between two dates separate with comma

Responses

Response samples

Content type
application/json
{
  • "deleted_items": [
    ],
  • "meta": {
    }
}

Email Campaigns

Emails campaigns are created to send emails out to users of the platform.

List email campaign deliveries

List all the emails that have been sent out for all campaigns.

Authorizations:
Authorization
query Parameters
locale
string

Which locale to return text for any multi-locale fields. For example: "en" or "fr-BE". If not provided, it will be set to the default language of the platform.

page_size
integer

The number of items that should be returned in one response. Defaults to 12, max 24

page_number
integer

The page to return. Defaults to page 1

created_at
string

Date the item was created - in format "YYYY-DD-MM" - to filter between two dates separate with comma

updated_at
string

Date item was last updated - in format "YYYY-DD-MM" - to filter between two dates separate with comma

Responses

Response samples

Content type
application/json
{
  • "email_campaign_deliveries": [
    ],
  • "meta": {
    }
}

Get an email campaign delivery

Retrieve a single email campaign delivery by its ID.

Authorizations:
Authorization
path Parameters
id
required
integer

Unique uuid for the item

id
required
string
query Parameters
locale
string

Which locale to return text for any multi-locale fields. For example: "en" or "fr-BE". If not provided, it will be set to the default language of the platform.

Responses

Response samples

Content type
application/json
{
  • "email_campaign_delivery": {
    }
}

/api/v2/email_campaign_deliveries/deleted

Authorizations:
Authorization
query Parameters
deleted_at
string

Date item was deleted - in format "YYYY-DD-MM" - to filter between two dates separate with comma

Responses

Response samples

Content type
application/json
{
  • "deleted_items": [
    ],
  • "meta": {
    }
}

List email campaigns

List all manually created emails campaigns

Authorizations:
Authorization
query Parameters
locale
string

Which locale to return text for any multi-locale fields. For example: "en" or "fr-BE". If not provided, it will be set to the default language of the platform.

page_size
integer

The number of items that should be returned in one response. Defaults to 12, max 24

page_number
integer

The page to return. Defaults to page 1

created_at
string

Date the item was created - in format "YYYY-DD-MM" - to filter between two dates separate with comma

updated_at
string

Date item was last updated - in format "YYYY-DD-MM" - to filter between two dates separate with comma

Responses

Response samples

Content type
application/json
{
  • "email_campaigns": [
    ],
  • "meta": {
    }
}

Get an email campaign

Retrieve a single email campaign by its ID.

Authorizations:
Authorization
path Parameters
id
required
integer

Unique uuid for the item

id
required
string
query Parameters
locale
string

Which locale to return text for any multi-locale fields. For example: "en" or "fr-BE". If not provided, it will be set to the default language of the platform.

Responses

Response samples

Content type
application/json
{
  • "email_campaign": {
    }
}

/api/v2/email_campaigns/deleted

Authorizations:
Authorization
query Parameters
deleted_at
string

Date item was deleted - in format "YYYY-DD-MM" - to filter between two dates separate with comma

Responses

Response samples

Content type
application/json
{
  • "deleted_items": [
    ],
  • "meta": {
    }
}

Events

Events can be created in projects and residents can sign up to attend events (event_attendances).

List attendees of events

All users signed up to attend events.

Authorizations:
Authorization
query Parameters
locale
string

Which locale to return text for any multi-locale fields. For example: "en" or "fr-BE". If not provided, it will be set to the default language of the platform.

page_size
integer

The number of items that should be returned in one response. Defaults to 12, max 24

page_number
integer

The page to return. Defaults to page 1

created_at
string

Date the item was created - in format "YYYY-DD-MM" - to filter between two dates separate with comma

updated_at
string

Date item was last updated - in format "YYYY-DD-MM" - to filter between two dates separate with comma

Responses

Response samples

Content type
application/json
{
  • "event_attendances": [
    ],
  • "meta": {
    }
}

Get an attendee

Retrieve a single event attendee by their ID.

Authorizations:
Authorization
path Parameters
id
required
integer

Unique uuid for the item

id
required
string
query Parameters
locale
string

Which locale to return text for any multi-locale fields. For example: "en" or "fr-BE". If not provided, it will be set to the default language of the platform.

Responses

Response samples

Content type
application/json
{
  • "event_attendance": {
    }
}

/api/v2/event_attendances/deleted

Authorizations:
Authorization
query Parameters
deleted_at
string

Date item was deleted - in format "YYYY-DD-MM" - to filter between two dates separate with comma

Responses

Response samples

Content type
application/json
{
  • "deleted_items": [
    ],
  • "meta": {
    }
}

List all events

List all events created on the platform.

Authorizations:
Authorization
query Parameters
locale
string

Which locale to return text for any multi-locale fields. For example: "en" or "fr-BE". If not provided, it will be set to the default language of the platform.

page_size
integer

The number of items that should be returned in one response. Defaults to 12, max 24

page_number
integer

The page to return. Defaults to page 1

created_at
string

Date the item was created - in format "YYYY-DD-MM" - to filter between two dates separate with comma

updated_at
string

Date item was last updated - in format "YYYY-DD-MM" - to filter between two dates separate with comma

Responses

Response samples

Content type
application/json
{
  • "events": [
    ],
  • "meta": {
    }
}

Get a single event

Retrieve a single event by its ID.

Authorizations:
Authorization
path Parameters
id
required
integer

Unique uuid for the item

id
required
string
query Parameters
locale
string

Which locale to return text for any multi-locale fields. For example: "en" or "fr-BE". If not provided, it will be set to the default language of the platform.

Responses

Response samples

Content type
application/json
{
  • "event": {
    }
}

/api/v2/events/deleted

Authorizations:
Authorization
query Parameters
deleted_at
string

Date item was deleted - in format "YYYY-DD-MM" - to filter between two dates separate with comma

Responses

Response samples

Content type
application/json
{
  • "deleted_items": [
    ],
  • "meta": {
    }
}

Posts

Posts are written inputs created by citizens. These can be ideas, initiatives (proposals), or survey responses.

List relations between ideas and phases

Idea phases represent associations between ideas and phases. This is a many-to-many relationship: Ideas can belong to multiple phases, and phases can be associated with multiple ideas. Basket & vote counts on this object represent the votes cast on an idea within a particular voting phase.

Authorizations:
Authorization
query Parameters
idea_id
string

Filter by idea ID

phase_id
string

Filter by phase ID

Responses

Response samples

Content type
application/json
{
  • "idea_phases": [
    ],
  • "meta": {
    }
}

List ideas

Retrieve a paginated list of all the ideas in the platform, with the most recent ones appearing first.

Authorizations:
Authorization
query Parameters
locale
string

Which locale to return text for any multi-locale fields. For example: "en" or "fr-BE". If not provided, it will be set to the default language of the platform.

page_size
integer

The number of items that should be returned in one response. Defaults to 12, max 24

page_number
integer

The page to return. Defaults to page 1

created_at
string

Date the item was created - in format "YYYY-DD-MM" - to filter between two dates separate with comma

updated_at
string

Date item was last updated - in format "YYYY-DD-MM" - to filter between two dates separate with comma

author_id
string

Filter by author ID

project_id
string

Filter by project ID

topic_ids
Array of strings

List only the ideas that have all of the specified topics

type
string
Enum: "idea" "survey"

Filter by type of idea - idea or survey - returns both by default

Responses

Response samples

Content type
application/json
{
  • "ideas": [
    ],
  • "meta": {
    }
}

Get idea

Retrieve a single idea by its ID.

Authorizations:
Authorization
path Parameters
id
required
integer

Unique uuid for the item

id
required
string
query Parameters
locale
string

Which locale to return text for any multi-locale fields. For example: "en" or "fr-BE". If not provided, it will be set to the default language of the platform.

Responses

Response samples

Content type
application/json
{
  • "idea": {
    }
}

/api/v2/ideas/deleted

Authorizations:
Authorization
query Parameters
deleted_at
string

Date item was deleted - in format "YYYY-DD-MM" - to filter between two dates separate with comma

Responses

Response samples

Content type
application/json
{
  • "deleted_items": [
    ],
  • "meta": {
    }
}

List initiatives - known as proposals in the platform

Retrieve a paginated list of all the initiatives in the platform, with the most recent ones appearing first.

Authorizations:
Authorization
query Parameters
locale
string

Which locale to return text for any multi-locale fields. For example: "en" or "fr-BE". If not provided, it will be set to the default language of the platform.

page_size
integer

The number of items that should be returned in one response. Defaults to 12, max 24

page_number
integer

The page to return. Defaults to page 1

created_at
string

Date the item was created - in format "YYYY-DD-MM" - to filter between two dates separate with comma

updated_at
string

Date item was last updated - in format "YYYY-DD-MM" - to filter between two dates separate with comma

Responses

Response samples

Content type
application/json
{
  • "initiatives": [
    ],
  • "meta": {
    }
}

Get an initiative (proposal)

Retrieve a single initiative (proposal) by its ID.

Authorizations:
Authorization
path Parameters
id
required
integer

Unique uuid for the item

id
required
string
query Parameters
locale
string

Which locale to return text for any multi-locale fields. For example: "en" or "fr-BE". If not provided, it will be set to the default language of the platform.

Responses

Response samples

Content type
application/json
{
  • "initiative": {
    }
}

/api/v2/initiatives/deleted

Authorizations:
Authorization
query Parameters
deleted_at
string

Date item was deleted - in format "YYYY-DD-MM" - to filter between two dates separate with comma

Responses

Response samples

Content type
application/json
{
  • "deleted_items": [
    ],
  • "meta": {
    }
}

Topics

Topics, referred to as tags within the platform, are utilized to label the content on the platform, including project, contributions, and pages.

List relations between ideas and topics

Idea topics represent associations between ideas and topics. This is a many-to-many relationship: Ideas can have multiple topics, and topics can be associated with multiple ideas.

Authorizations:
Authorization
query Parameters
idea_id
string

Filter by idea ID

topic_id
string

Filter by topic ID

Responses

Response samples

Content type
application/json
{
  • "idea_topics": [
    ],
  • "meta": {
    }
}

List associations between topics and projects

Project topics represent associations between projects and topics. This is a many-to-many relationship: Projects can have multiple topics, and topics can be associated with multiple projects.

Authorizations:
Authorization
query Parameters
project_id
string

Filter by project ID

topic_id
string

Filter by topic ID

Responses

Response samples

Content type
application/json
{
  • "project_topics": [
    ],
  • "meta": {
    }
}

List topics

Retrieve a paginated list of all the topics in the platform, with the most recently created ones first.

Authorizations:
Authorization
query Parameters
locale
string

Which locale to return text for any multi-locale fields. For example: "en" or "fr-BE". If not provided, it will be set to the default language of the platform.

page_size
integer

The number of items that should be returned in one response. Defaults to 12, max 24

page_number
integer

The page to return. Defaults to page 1

created_at
string

Date the item was created - in format "YYYY-DD-MM" - to filter between two dates separate with comma

updated_at
string

Date item was last updated - in format "YYYY-DD-MM" - to filter between two dates separate with comma

Responses

Response samples

Content type
application/json
{
  • "topics": [
    ],
  • "meta": {
    }
}

Get topic

Retrieve a single topic by its ID.

Authorizations:
Authorization
path Parameters
id
required
integer

Unique uuid for the item

id
required
string
query Parameters
locale
string

Which locale to return text for any multi-locale fields. For example: "en" or "fr-BE". If not provided, it will be set to the default language of the platform.

Responses

Response samples

Content type
application/json
{
  • "topic": {
    }
}

/api/v2/topics/deleted

Authorizations:
Authorization
query Parameters
deleted_at
string

Date item was deleted - in format "YYYY-DD-MM" - to filter between two dates separate with comma

Responses

Response samples

Content type
application/json
{
  • "deleted_items": [
    ],
  • "meta": {
    }
}

Phases

Phases represent the steps in a timeline project.

List phases

Retrieve a paginated list of all the phases in the platform, with the most recently created ones first.

Authorizations:
Authorization
query Parameters
locale
string

Which locale to return text for any multi-locale fields. For example: "en" or "fr-BE". If not provided, it will be set to the default language of the platform.

page_size
integer

The number of items that should be returned in one response. Defaults to 12, max 24

page_number
integer

The page to return. Defaults to page 1

created_at
string

Date the item was created - in format "YYYY-DD-MM" - to filter between two dates separate with comma

updated_at
string

Date item was last updated - in format "YYYY-DD-MM" - to filter between two dates separate with comma

start_at
string

List only phases whose start date lies in the specified range. The range is specified as two dates separated by a comma: YYYY-MM-DD,YYYY-MM-DD. Open-ended ranges are also supported: YYYY-MM-DD, or ,YYYY-MM-DD.

end_at
string

List only phases whose end date lies in the specified range. The range is specified as two dates separated by a comma: YYYY-MM-DD,YYYY-MM-DD. Open-ended ranges are also supported: YYYY-MM-DD, or ,YYYY-MM-DD.

Responses

Response samples

Content type
application/json
{
  • "phases": [
    ],
  • "meta": {
    }
}

List all the phases of a project

Endpoint to retrieve phases of a single project. The phases are returned in reverse order of date created. The endpoint supports pagination.

Authorizations:
Authorization
path Parameters
project_id
required
string
query Parameters
locale
string

Which locale to return text for any multi-locale fields. For example: "en" or "fr-BE". If not provided, it will be set to the default language of the platform.

page_size
integer

The number of items that should be returned in one response. Defaults to 12, max 24

page_number
integer

The page to return. Defaults to page 1

created_at
string

Date the item was created - in format "YYYY-DD-MM" - to filter between two dates separate with comma

updated_at
string

Date item was last updated - in format "YYYY-DD-MM" - to filter between two dates separate with comma

Responses

Response samples

Content type
application/json
{
  • "phases": [
    ],
  • "meta": {
    }
}

Get phase

Retrieve a single phase by its ID.

Authorizations:
Authorization
path Parameters
id
required
integer

Unique uuid for the item

id
required
string
query Parameters
locale
string

Which locale to return text for any multi-locale fields. For example: "en" or "fr-BE". If not provided, it will be set to the default language of the platform.

Responses

Response samples

Content type
application/json
{
  • "phase": {
    }
}

/api/v2/phases/deleted

Authorizations:
Authorization
query Parameters
deleted_at
string

Date item was deleted - in format "YYYY-DD-MM" - to filter between two dates separate with comma

Responses

Response samples

Content type
application/json
{
  • "deleted_items": [
    ],
  • "meta": {
    }
}

Project Folders

Projects folders are used to group projects together.

List project folders

Retrieve a paginated list of all the project folders in the platform.

Authorizations:
Authorization
query Parameters
locale
string

Which locale to return text for any multi-locale fields. For example: "en" or "fr-BE". If not provided, it will be set to the default language of the platform.

page_size
integer

The number of items that should be returned in one response. Defaults to 12, max 24

page_number
integer

The page to return. Defaults to page 1

created_at
string

Date the item was created - in format "YYYY-DD-MM" - to filter between two dates separate with comma

updated_at
string

Date item was last updated - in format "YYYY-DD-MM" - to filter between two dates separate with comma

publication_status
string
Enum: "draft" "published" "archived"

List only project folders with the given publication status

Responses

Response samples

Content type
application/json
{
  • "project_folders/folders": [
    ],
  • "meta": {
    }
}

Get project folder

Retrieve a single project folder by its ID.

Authorizations:
Authorization
path Parameters
id
required
integer

Unique uuid for the item

id
required
string
query Parameters
locale
string

Which locale to return text for any multi-locale fields. For example: "en" or "fr-BE". If not provided, it will be set to the default language of the platform.

Responses

Response samples

Content type
application/json
{
  • "project_folders/folder": {
    }
}

/api/v2/project_folders/deleted

Authorizations:
Authorization
query Parameters
deleted_at
string

Date item was deleted - in format "YYYY-DD-MM" - to filter between two dates separate with comma

Responses

Response samples

Content type
application/json
{
  • "deleted_items": [
    ],
  • "meta": {
    }
}

Projects

Projects are participation scopes. They establish a framework, including the context, duration, and expected input, to encourage citizens to actively engage in focused discussions. Within these projects, citizens can contribute and post their ideas.

List projects

Retrieve a paginated list of all the projects in the platform, with the newest projects appearing first.

Authorizations:
Authorization
query Parameters
locale
string

Which locale to return text for any multi-locale fields. For example: "en" or "fr-BE". If not provided, it will be set to the default language of the platform.

page_size
integer

The number of items that should be returned in one response. Defaults to 12, max 24

page_number
integer

The page to return. Defaults to page 1

created_at
string

Date the item was created - in format "YYYY-DD-MM" - to filter between two dates separate with comma

updated_at
string

Date item was last updated - in format "YYYY-DD-MM" - to filter between two dates separate with comma

folder_id
string

List only the projects that are in the specified folder.

publication_status
string
Enum: "draft" "published" "archived"

List only the projects that have the specified publication status.

topic_ids
Array of any

List only the projects that have all the specified topics.

area_ids
Array of any

List only the projects that are in the specified areas.

Responses

Response samples

Content type
application/json
{
  • "projects": [
    ],
  • "meta": {
    }
}

Get project

Retrieve a single project by ID.

Authorizations:
Authorization
path Parameters
id
required
integer

Unique uuid for the item

id
required
string
query Parameters
locale
string

Which locale to return text for any multi-locale fields. For example: "en" or "fr-BE". If not provided, it will be set to the default language of the platform.

Responses

Response samples

Content type
application/json
{
  • "project": {
    }
}

/api/v2/projects/deleted

Authorizations:
Authorization
query Parameters
deleted_at
string

Date item was deleted - in format "YYYY-DD-MM" - to filter between two dates separate with comma

Responses

Response samples

Content type
application/json
{
  • "deleted_items": [
    ],
  • "meta": {
    }
}

Reactions

All reactions (likes/dislikes) created in the platform

List all reactions

Retrieve a paginated list of all the reactions in the platform. You can filter the reactions in different ways. For example, you can filter by "reactable type" (the type of resource that was reacted to), by user identifier, or by date range.

Authorizations:
Authorization
query Parameters
locale
string

Which locale to return text for any multi-locale fields. For example: "en" or "fr-BE". If not provided, it will be set to the default language of the platform.

page_size
integer

The number of items that should be returned in one response. Defaults to 12, max 24

page_number
integer

The page to return. Defaults to page 1

created_at
string

Date the item was created - in format "YYYY-DD-MM" - to filter between two dates separate with comma

updated_at
string

Date item was last updated - in format "YYYY-DD-MM" - to filter between two dates separate with comma

reactable_type
string
Enum: "idea" "initiative" "comment" "idea-comment" "initiative-comment"

List only the reactions that were cast on a specific type of resource. 'initiative' corresponds to proposals on the platform. 'idea-comment' and 'initiative-comment' filter reactions on comments on ideas and comments on proposals, respectively.

user_id
string

List only the reactions that were cast by a specific user.

Responses

Response samples

Content type
application/json
{
  • "reactions": [
    ],
  • "meta": {
    }
}

Users

All user registrations on the platform.

List users

Retrieve a paginated list of all the users in the platform, with the most recently created ones first.

Authorizations:
Authorization
query Parameters
locale
string

Which locale to return text for any multi-locale fields. For example: "en" or "fr-BE". If not provided, it will be set to the default language of the platform.

page_size
integer

The number of items that should be returned in one response. Defaults to 12, max 24

page_number
integer

The page to return. Defaults to page 1

created_at
string

Date the item was created - in format "YYYY-DD-MM" - to filter between two dates separate with comma

updated_at
string

Date item was last updated - in format "YYYY-DD-MM" - to filter between two dates separate with comma

Responses

Response samples

Content type
application/json
{
  • "users": [
    ],
  • "meta": {
    }
}

Get user

Retrieve a single user by its ID.

Authorizations:
Authorization
path Parameters
id
required
integer

Unique uuid for the item

id
required
string
query Parameters
locale
string

Which locale to return text for any multi-locale fields. For example: "en" or "fr-BE". If not provided, it will be set to the default language of the platform.

Responses

Response samples

Content type
application/json
{
  • "user": {
    }
}

/api/v2/users/deleted

Authorizations:
Authorization
query Parameters
deleted_at
string

Date item was deleted - in format "YYYY-DD-MM" - to filter between two dates separate with comma

Responses

Response samples

Content type
application/json
{
  • "deleted_items": [
    ],
  • "meta": {
    }
}

Volunteering

Volunteering endpoints provide details about the volunteering causes on the platform and users that have signed up as volunteers to those causes.

List volunteering causes

All volunteering causes added to the platform

Authorizations:
Authorization
query Parameters
locale
string

Which locale to return text for any multi-locale fields. For example: "en" or "fr-BE". If not provided, it will be set to the default language of the platform.

page_size
integer

The number of items that should be returned in one response. Defaults to 12, max 24

page_number
integer

The page to return. Defaults to page 1

created_at
string

Date the item was created - in format "YYYY-DD-MM" - to filter between two dates separate with comma

updated_at
string

Date item was last updated - in format "YYYY-DD-MM" - to filter between two dates separate with comma

Responses

Response samples

Content type
application/json
{
  • "volunteering_causes": [
    ],
  • "meta": {
    }
}

Get a volunteering cause

Retrieve a single volunteering cause by its ID.

Authorizations:
Authorization
path Parameters
id
required
integer

Unique uuid for the item

id
required
string
query Parameters
locale
string

Which locale to return text for any multi-locale fields. For example: "en" or "fr-BE". If not provided, it will be set to the default language of the platform.

Responses

Response samples

Content type
application/json
{
  • "volunteering_cause": {
    }
}

/api/v2/volunteering_causes/deleted

Authorizations:
Authorization
query Parameters
deleted_at
string

Date item was deleted - in format "YYYY-DD-MM" - to filter between two dates separate with comma

Responses

Response samples

Content type
application/json
{
  • "deleted_items": [
    ],
  • "meta": {
    }
}

List volunteers

All users signed up as volunteers against causes.

Authorizations:
Authorization
query Parameters
locale
string

Which locale to return text for any multi-locale fields. For example: "en" or "fr-BE". If not provided, it will be set to the default language of the platform.

page_size
integer

The number of items that should be returned in one response. Defaults to 12, max 24

page_number
integer

The page to return. Defaults to page 1

created_at
string

Date the item was created - in format "YYYY-DD-MM" - to filter between two dates separate with comma

updated_at
string

Date item was last updated - in format "YYYY-DD-MM" - to filter between two dates separate with comma

Responses

Response samples

Content type
application/json
{
  • "volunteering_volunteers": [
    ],
  • "meta": {
    }
}

Get a volunteer

Retrieve a single volunteer by its ID.

Authorizations:
Authorization
path Parameters
id
required
integer

Unique uuid for the item

id
required
string
query Parameters
locale
string

Which locale to return text for any multi-locale fields. For example: "en" or "fr-BE". If not provided, it will be set to the default language of the platform.

Responses

Response samples

Content type
application/json
{
  • "volunteering_volunteer": {
    }
}

/api/v2/volunteering_volunteers/deleted

Authorizations:
Authorization
query Parameters
deleted_at
string

Date item was deleted - in format "YYYY-DD-MM" - to filter between two dates separate with comma

Responses

Response samples

Content type
application/json
{
  • "deleted_items": [
    ],
  • "meta": {
    }
}