Invests endpoint
This section gives you information about invests in Goteo.org
/invests/
Obtains a list of invests.
curl -i --basic --user "user:key" https://api.goteo.org/v1/invests/
Filters available:
The standard set of filters applies to this endpoint with these particulars:
| Attribute |
Type |
Description |
| node |
string |
Filter by individual node(s). Multiple nodes can be specified. Restricts the list to the invests originally created in that node(s) |
| call |
string |
Filter by individual matchfunding call(s). Multiple calls can be specified. Restricts the list to the projects originally created in that call(s) |
| project |
string |
Filter by individual project(s). Multiple projects can be specified. Restricts the list to the invests that have either collaborate or contributed (financially) to that project(s). |
| from_date |
string |
Filter from date. Ex. "2013-01-01". Restricts the list to the invests created in that range |
| to_date |
string |
Filter until date.. Ex. "2014-01-01". Restricts the list to the invests created in that range |
| category |
integer |
Filter by project category. Multiple categories can be specified. Restricts the list to the invests of projects with that category(ies) |
| social_commitment |
integer |
Filter by project social commitment. Multiple social commitments can be specified. Restricts the list to the invests of projects with that social commitment(s) |
| sdg |
integer |
Filter by project Sustainable Development Goal. Multiple SDGs can be specified. Restricts the list to the invests of projects with that SDG(s) |
| footprint |
integer |
Filter by project footprint. Multiple footprints can be specified. Restricts the list to the invests of projects with that footprint(s) |
| location |
number |
Filter by project location (Latitude,longitude,Radius in Km). Restricts the list to the invests used in projects geolocated in that area |
| page |
integer |
Page number (starting at 1) if the result can be paginated |
| limit |
integer |
Page limit (maximum 50 results, defaults to 10) if the result can be paginated |
Response values:
| Attribute |
Type |
Description |
| calls |
integer |
Number of matchfunding calls applying in the current query |
| pledged |
number |
Total sum pledged amount for the current query |
| projects |
integer |
Total sum of projects applying in the current query |
| refunded |
number |
Total sum of refunded amount for the current query |
| Attribute |
Type |
Description |
| amount |
number |
Amount of the contribution |
| call-id |
string |
Id of the matchfunding call if this invest belongs to a invest in selected |
| conversion-ratio |
number |
Currency rate at the moment of the payment (relative to EUR) |
| currency |
string |
Currency of the contribution (currently one of EUR, GBP, USD) in ISO 4217 format |
| date-charged |
string |
Date-only when the invest was charged in RFC822 format |
| date-created |
string |
Date-only when the invest was created in RFC822 format |
| date-returned |
string |
Date-only when the invest was returned (if applicable) in RFC822 format |
| date-updated |
string |
Date & Time when the invest was last updated in RFC822 format |
| id |
integer |
Invest unique identifier |
| latitude |
number |
Latitude coordinate for the invest |
| longitude |
number |
Longitude coordinate for the invest |
| matcher-id |
string |
Id of the matchfunding matcher if this invest belongs to a invest in selected |
| project |
string |
Id of the invest where applies the invests |
| region |
string |
Region location for the invest |
| resign |
boolean |
True if the user does not want any reward in exchango of the contribution |
| status |
string |
Status of the payment, one of processing, pending, charged, cancelled, paid, returned, relocated, pool-returned |
| type |
string |
Type of the payment, one of payment, drop, pool |
| Attribute |
Type |
Description |
| category |
array |
Only if filtering by category |
| footprint |
array |
Only if filtering by footprint |
| from_date |
string |
Only if filtering by from_date |
| lang |
array |
Only if filtering by lang |
| limit |
integer |
Limit of results per page when retrieving a collection |
| location |
array |
Only if filtering by location |
| node |
array |
Only if filtering by node |
| page |
integer |
Current page, 0 based (first page is zero) |
| project |
array |
Only if filtering by project |
| sdg |
array |
Only if filtering by Sustainable Development Goal |
| social_commitment |
array |
Only if filtering by social_commitment |
| to_date |
string |
Only if filtering by to_date |
| total |
integer |
Total elements available for the collection |
Response body:
{
"extra": {
"calls": 16,
"matchers": 1,
"pledged": 9997786.0,
"projects": 1522,
"refunded": 362821.0
},
"items": [
{
"amount": 20.0,
"call-id": null,
"conversion-ratio": 1.0,
"currency": "EUR",
"date-charged": "Fri, 10 Apr 2020 00:00:00 +0200",
"date-created": "Fri, 10 Apr 2020 00:00:00 +0200",
"date-returned": null,
"date-updated": "Fri, 10 Apr 2020 00:07:00 +0200",
"id": 257438,
"latitude": 40.54750000000000,
"longitude": -3.64200000000000,
"matcher-id": null,
"project": "sembrando-semillas-de-cambio",
"region": "Madrid",
"resign": false,
"status": "charged",
"type": "payment"
},
{
"amount": 20.0,
"call-id": null,
"conversion-ratio": 1.0,
"currency": "EUR",
"date-charged": "Thu, 09 Apr 2020 00:00:00 +0200",
"date-created": "Thu, 09 Apr 2020 00:00:00 +0200",
"date-returned": null,
"date-updated": "Thu, 09 Apr 2020 23:55:31 +0200",
"id": 257437,
"latitude": 41.61759079999999,
"longitude": 0.62227630000000,
"matcher-id": null,
"project": "libreguard",
"region": "Lleida",
"resign": false,
"status": "charged",
"type": "payment"
},
{
"amount": 15.0,
"call-id": null,
"conversion-ratio": 1.0,
"currency": "EUR",
"date-charged": "Thu, 09 Apr 2020 00:00:00 +0200",
"date-created": "Thu, 09 Apr 2020 00:00:00 +0200",
"date-returned": null,
"date-updated": "Thu, 09 Apr 2020 23:42:37 +0200",
"id": 257436,
"latitude": null,
"longitude": null,
"matcher-id": null,
"project": "abriendoventanas",
"region": null,
"resign": false,
"status": "charged",
"type": "payment"
},
{
"amount": 30.0,
"call-id": null,
"conversion-ratio": 1.0,
"currency": "EUR",
"date-charged": "Thu, 09 Apr 2020 00:00:00 +0200",
"date-created": "Thu, 09 Apr 2020 00:00:00 +0200",
"date-returned": null,
"date-updated": "Thu, 09 Apr 2020 23:34:10 +0200",
"id": 257435,
"latitude": 42.27180710000000,
"longitude": 2.52853150000000,
"matcher-id": null,
"project": "la-porta-del-mon-cooperativa-restaurant",
"region": "Girona",
"resign": false,
"status": "charged",
"type": "payment"
},
{
"amount": 30.0,
"call-id": null,
"conversion-ratio": 1.0,
"currency": "EUR",
"date-charged": "Thu, 09 Apr 2020 00:00:00 +0200",
"date-created": "Thu, 09 Apr 2020 00:00:00 +0200",
"date-returned": null,
"date-updated": "Thu, 09 Apr 2020 23:22:12 +0200",
"id": 257434,
"latitude": 40.41650000000000,
"longitude": -3.70260000000000,
"matcher-id": null,
"project": "viseras-sanitarias-contra-el-covid-19",
"region": "Madrid",
"resign": false,
"status": "charged",
"type": "payment"
},
{
"amount": 60.0,
"call-id": null,
"conversion-ratio": 1.0,
"currency": "EUR",
"date-charged": "Thu, 09 Apr 2020 00:00:00 +0200",
"date-created": "Thu, 09 Apr 2020 00:00:00 +0200",
"date-returned": null,
"date-updated": "Thu, 09 Apr 2020 23:21:00 +0200",
"id": 257433,
"latitude": 39.01780000000000,
"longitude": -3.75100000000000,
"matcher-id": null,
"project": "viseras-sanitarias-contra-el-covid-19",
"region": "Ciudad Real",
"resign": true,
"status": "charged",
"type": "payment"
},
{
"amount": 20.0,
"call-id": null,
"conversion-ratio": 1.0,
"currency": "EUR",
"date-charged": "Thu, 09 Apr 2020 00:00:00 +0200",
"date-created": "Thu, 09 Apr 2020 00:00:00 +0200",
"date-returned": null,
"date-updated": "Thu, 09 Apr 2020 23:00:00 +0200",
"id": 257432,
"latitude": 41.53330000000000,
"longitude": 1.76670000000000,
"matcher-id": null,
"project": "emergencia-social-en-el-barrio-del-cementerio",
"region": "Barcelona",
"resign": false,
"status": "charged",
"type": "payment"
},
{
"amount": 30.0,
"call-id": null,
"conversion-ratio": 1.0,
"currency": "EUR",
"date-charged": "Thu, 09 Apr 2020 00:00:00 +0200",
"date-created": "Thu, 09 Apr 2020 00:00:00 +0200",
"date-returned": null,
"date-updated": "Thu, 09 Apr 2020 22:48:22 +0200",
"id": 257429,
"latitude": 43.01380000000000,
"longitude": -7.55850000000000,
"matcher-id": null,
"project": "viseras-sanitarias-contra-el-covid-19",
"region": "Lugo",
"resign": false,
"status": "charged",
"type": "payment"
},
{
"amount": 100.0,
"call-id": null,
"conversion-ratio": 1.0,
"currency": "EUR",
"date-charged": "Thu, 09 Apr 2020 00:00:00 +0200",
"date-created": "Thu, 09 Apr 2020 00:00:00 +0200",
"date-returned": null,
"date-updated": "Thu, 09 Apr 2020 22:28:28 +0200",
"id": 257427,
"latitude": 44.43330000000000,
"longitude": 26.10000000000000,
"matcher-id": null,
"project": "necesidades-basicas-para-la-infancia-y-sus-familia",
"region": "Bucuresti",
"resign": true,
"status": "charged",
"type": "payment"
},
{
"amount": 20.0,
"call-id": null,
"conversion-ratio": 1.0,
"currency": "EUR",
"date-charged": "Thu, 09 Apr 2020 00:00:00 +0200",
"date-created": "Thu, 09 Apr 2020 00:00:00 +0200",
"date-returned": null,
"date-updated": "Thu, 09 Apr 2020 22:21:00 +0200",
"id": 257426,
"latitude": 41.91080000000000,
"longitude": 0.19410000000000,
"matcher-id": null,
"project": "i-love-cine-de-poble",
"region": "Huesca",
"resign": false,
"status": "charged",
"type": "payment"
}
],
"meta": {
"lang": [
"en"
],
"limit": 10,
"page": 0,
"total": 194404
},
"time-elapsed": 2.352069616317749
}
/invests/{INVEST_ID}
Gets information about a single user.
curl -i --basic --user "user:key" https://api.goteo.org/v1/invests/1000
Filters available:
- No filters are available in this endpoint
- {INVEST_ID} must be the unique identifier of the user
Response values:
| Attribute |
Type |
Description |
| about |
string |
User's about text |
| amount-public-invested |
number |
Amount of money invested in any project (excluding anonymous investions) |
| date-created |
string |
Date when the user was created RFC822 format |
| id |
string |
User unique identifier |
| lang |
string |
Language for the user's texts description |
| name |
string |
Name of the user |
| node |
string |
Node where the user was created originally |
| profile-image-url |
string |
URL with the avatar (image) of the user |
| profile-url |
string |
URL for the user profile |
| projects-collaborated |
number |
Number of project the user has interacted |
| projects-public-invested |
number |
Number of projects where the user has invested (excluding anonymous investions) |
| projects-published |
number |
Number of project the user has created and published |
| translations |
array |
All available translations in a list indexed by language in ISO 639-1 format ☞ UserTranslation |
| Attribute |
Type |
Description |
| about |
string |
User's about text translated (if any) |
| name |
string |
Name of the user translated (if any) |
Response body:
{
"about": "Este perfil representa al equipo que administra la plataforma Goteo, desde el que nos comunicamos con todos los usuarios y usuarias. Si quieres contactar con nosotras escribe desde la secci\u00f3n de \"Contacto\" (en el pie de la p\u00e1gina) o bien v\u00eda Twitter (@gteofunding)",
"amount-public-invested": 0.0,
"date-created": "Sat, 20 Aug 2011 13:57:14 +0200",
"id": "goteo",
"lang": "es",
"name": "Goteo",
"node": "goteo",
"profile-image-url": "https://goteo.org/img/medium/goteo-twitter7r.png",
"profile-url": "https://goteo.org/user/profile/goteo",
"projects-collaborated": 7,
"projects-public-invested": 0,
"projects-published": 0,
"time-elapsed": 0.05135011672973633,
"translations": {
"fr": {
"name": null
}
}
}
